Alertmanager

Provides an MCP interface to fetch alerts, view details, manage silences, and retrieve alert groups from Prometheus Alertmanager.

typescript

6

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kaznak-alertmanager-mcp": {
      "command": "npx",
      "args": [
        "alertmanager-mcp"
      ],
      "env": {
        "ALERTMANAGER_URL": "http://your-alertmanager-url:9093"
      }
    }
  }
}

This MCP server provides a bridge between Prometheus Alertmanager and Claude AI, exposing Alertmanager data and actions through a consistent Model Context Protocol interface. You can fetch alerts, view detailed alert information, manage silences, and retrieve alert groups directly from Claude or other MCP clients.

How to use

You interact with the Alertmanager MCP server by starting the MCP client in your environment and then asking it to perform common alerting tasks. You can retrieve current alerts, filter results, view details for a specific alert by its fingerprint, create or delete silences, and inspect alert groups as organized by Alertmanager. Use natural language prompts to Claude or your MCP client to trigger the available tools.

How to install

Prerequisites: you need a running Prometheus Alertmanager instance. If you are using Claude for Desktop, you also need Node.js version 18 or newer.

npx alertmanager-mcp

npm install -g alertmanager-mcp
alertmanager-mcp

Configuration and usage notes

Choose one of the MCP startup methods that matches your environment.

{
  "mcpServers": {
    "alertmanager": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--network=host",
        "-e", "ALERTMANAGER_URL=http://your-alertmanager-url:9093",
        "ghcr.io/kaznak/alertmanager-mcp:latest"
      ],
      "env": {}
    }
  }
}

Available tools

get-alerts

Retrieves a list of alerts with optional filtering and flags for silenced, inhibited, and active states.

get-alert-details

Fetches detailed information about a specific alert using its fingerprint.

create-silence

Creates a silence to suppress notifications matching specified criteria, with optional start and end times and metadata.

get-silences

Retrieves a list of existing silences with optional filtering by creator or other attributes.

delete-silence

Deletes a silence by its ID.

get-alert-groups

Retrieves alert groups as organized by Alertmanager with optional active/silenced/inhibited filters.