Alertmanager MCP server

Alertmanager MCP Server (Go)

A Model Context Protocol (MCP) server for Prometheus Alertmanager integration. Native Go binary with built-in Kubernetes connectivity via client-go.

Installation

npx

npx -y mcp-alertmanager@latest

MCP Client Configuration

Add to your MCP client configuration (VS Code, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "alertmanager": {
      "command": "npx",
      "args": ["-y", "mcp-alertmanager@latest"],
      "env": {
        "ALERTMANAGER_URL": "http://localhost:9093"
      }
    }
  }
}

VS Code

code --add-mcp '{"name":"alertmanager","command":"npx","args":["-y","mcp-alertmanager@latest"],"env":{"ALERTMANAGER_URL":"http://localhost:9093"}}'

Kubernetes Auto-Connect

Automatically connects to Alertmanager running in OpenShift/Kubernetes via the K8S API service proxy. Uses native kubeconfig/in-cluster config via client-go. No kubectl or port-forwarding required.

Default: openshift-monitoring/alertmanager-operated:9093

{
  "mcpServers": {
    "alertmanager": {
      "command": "npx",
      "args": ["-y", "mcp-alertmanager@latest"]
    }
  }
}

Binary

Download from GitHub Releases or build from source:

make build
./mcp-alertmanager

Configuration

Environment Variables

CLI Flags

Precedence: --url / ALERTMANAGER_URL > K8S auto-connect

Connection strategy:

1. Direct URL (if --url or ALERTMANAGER_URL is set)
2. K8S API proxy (auto-detect kubeconfig or in-cluster config)

Tools (12)

Alerts

Silences

Status

Troubleshooting

Example Prompts

Shortened. The full README is on GitHub.