# Zabbix AI CLI MCP

> Give Claude Code, Codex, Cursor and other MCP clients task-shaped access to Zabbix 6.4+: problems, host checks, missed alerts. Apache-2.0.

Source code: https://github.com/stufently/zabbix-ai-cli-mcp
License: Apache-2.0

- problems list: what is broken now, including suppressed problems with the maintenance window that hides them named.
- host investigate: host state, active problems, recent events, silent and unsupported items and maintenance in one call.
- alert why: why a notification did or did not arrive — suppression, delivery attempts, actions, media types, severity filters.
- One setting, allow_write, decides whether the agent applies a change or a person approves a plan at a terminal; every applied change is audited.
- Fifteen MCP tools, not two hundred, with bounded output and a stable JSON contract; stdio or streamable HTTP.
- It never contacts a language model: it talks to Zabbix and prints JSON, and also works as a normal CLI.

## Documentation

- [Zabbix AI CLI MCP — Zabbix MCP server and CLI for AI agents](https://stufently.github.io/zabbix-ai-cli-mcp/docs/): zabbix-ai-cli-mcp is a Zabbix MCP server and command-line client in one Go binary. It gives Claude Code, Claude Desktop, Codex, Cursor and any other…
- [Architecture and design decisions](https://stufently.github.io/zabbix-ai-cli-mcp/docs/architecture/): Supporting packages: config (TOML profiles, no secrets), auth (token resolution), safety (risk registry, plans, approval, audit), output (envelope,…
- [Authentication and profiles](https://stufently.github.io/zabbix-ai-cli-mcp/docs/authentication/): A profile is a named Zabbix installation. Credentials are stored separately from configuration, so the configuration file can be read, diffed and…
- [Command line](https://stufently.github.io/zabbix-ai-cli-mcp/docs/cli/): Every command accepts --json, --profile, --limit where it returns a list, and --debug to log API calls on stderr with credentials redacted.
- [JSON output and exit codes](https://stufently.github.io/zabbix-ai-cli-mcp/docs/json-output/): --output json, --output table, or --json as shorthand. The default is auto: a table when stdout is a terminal, JSON otherwise. A command in a pipe or a…
- [MCP server](https://stufently.github.io/zabbix-ai-cli-mcp/docs/mcp/): Speaks the Model Context Protocol over stdio. The Zabbix token is resolved inside this process from the profile; an MCP client never sees it.
- [Security model](https://stufently.github.io/zabbix-ai-cli-mcp/docs/security/): The distinguishing assumption is that the caller may be an AI agent acting on instructions it read somewhere. Those instructions may come from a ticket,…
- [Skills](https://stufently.github.io/zabbix-ai-cli-mcp/docs/skills/): The repository ships five skills. They describe workflows, not logic: which command to reach for, how to read the answer, and which mistakes produce a…

### What is a Zabbix MCP server?

A small program that exposes Zabbix to an AI client over the Model Context Protocol, so Claude, Codex, Cursor and similar clients query problems, hosts, items, events and maintenance as tools instead of guessing at curl calls against the JSON-RPC API.

### Can an AI agent change my Zabbix through this?

That is decided by allow_write. It is on by default: the agent can open a maintenance window or acknowledge an event itself, every change audited and bounded by the profile's scopes and the risk registry. With allow_write = false a write only produces a plan, and a person applies it with zabbix-ai-cli-mcp approve <plan-id> in their own terminal.

### Does it send my monitoring data to an AI provider?

No. The program never contacts a language model. It talks to Zabbix and prints JSON; what your MCP client does with that output is between you and your client.

### Which Zabbix versions are supported?

Zabbix 6.4 and newer, because bearer-token authentication arrived in 6.4 and is the only scheme implemented. It is developed and tested against Zabbix 7.4.

### Do I need Go installed?

No. Each tagged release publishes archives for Linux, macOS and Windows on amd64 and arm64 with checksums, plus a container image on ghcr.io. make build compiles inside Docker; go install is there for a host-native binary with Go 1.25 or newer.

### Which AI clients does it work with?

Any MCP client. The README has configs for Claude Code, Claude Desktop, Cursor, Windsurf, Zed, Codex and VS Code; Claude Code and Codex CLI are in daily use, the other client blocks follow each client's documented configuration.

## Optional

- [Full text of all docs](https://stufently.github.io/zabbix-ai-cli-mcp/llms-full.txt)