mcp-alertmanager

MCP server for Prometheus Alertmanager. Exposes alert listing and silence management as MCP tools.

Tools

| Tool | Description | |------|-------------| | list_alerts | List alerts with optional filters (label matchers, state, receiver) | | list_silences | List silences with optional label matcher filters | | get_silence | Get a single silence by ID | | create_silence | Create a new silence with matchers, author, comment, and duration | | delete_silence | Expire (delete) a silence by ID |

Usage

stdio mode (default)

mcp-alertmanager -url http://alertmanager:9093

SSE mode

mcp-alertmanager -url http://alertmanager:9093 -mode sse -httpListenAddr :8012

Authentication

Basic auth:

mcp-alertmanager -url http://alertmanager:9093 -username admin -password-file /path/to/password

Custom headers (e.g. bearer token, multi-tenancy):

mcp-alertmanager -url http://alertmanager:9093 \
  -header "Authorization: Bearer <token>" \
  -header "X-Scope-OrgID: tenant1"

Claude Desktop Configuration

{
  "mcpServers": {
    "alertmanager": {
      "command": "mcp-alertmanager",
      "args": ["-url", "http://alertmanager:9093"]
    }
  }
}

Building

task build

Testing

task test        # unit tests
task test:e2e    # e2e tests (builds binary first)
task test:all    # all tests