Skip to main content
Glama
jeanlopezxyz

mcp-alertmanager

by jeanlopezxyz
OverviewSchemaRelated ServersScoreDiscussions
Go
Hybrid

Alertmanager MCP Server (Go)

License: MIT npm version Go GitHub release

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

Related MCP server: Prometheus Alertmanager MCP Server

Configuration

Environment Variables

Variable

Description

ALERTMANAGER_URL

Direct Alertmanager API URL (overrides K8S auto-connect)

CLI Flags

Flag

Description

Default

--url

Direct Alertmanager URL

-

--namespace

Kubernetes namespace

openshift-monitoring

--service

Kubernetes service name

alertmanager-operated

--service-port

Kubernetes service port

9093

--service-scheme

Service scheme (http/https)

https

--kubeconfig

Path to kubeconfig file

auto-detect

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

Tool

Description

getAlerts

Get alerts with optional filters

getAlertGroups

Get alerts grouped by routing labels

getCriticalAlerts

Get critical severity alerts only

getAlertingSummary

Summary: counts by severity, top alerts, namespaces

Silences

Tool

Description

getSilences

List silences by state

createSilence

Create a silence for an alert

deleteSilence

Delete a silence by ID

Status

Tool

Description

getAlertmanagerStatus

Server status, version, cluster info

getReceivers

List notification receivers

Troubleshooting

Tool

Description

investigateAlert

Deep investigation of a specific alert

getAlertHistory

Alert history and analysis guidance

correlateAlerts

Find correlated alerts by shared labels

Example Prompts

"What alerts are currently firing?"
"Are there any critical alerts?"
"Give me a summary of the alerting status"
"Investigate the HighMemoryUsage alert"
"Create a 2-hour silence for PodCrashLooping"
"What receivers are configured?"
"Find correlated alerts to identify the root cause"
"Show me alert history for KubeNodeNotReady"

Development

Build

make build              # Build for current platform
make build-all-platforms # Cross-compile for all platforms

Container

podman build -f Containerfile -t mcp-alertmanager .

Kubernetes / OpenShift Deployment

Container Image

The container image is available on GitHub Container Registry:

ghcr.io/jeanlopezxyz/mcp-alertmanager:latest

Helm Chart

Deploy using the included Helm chart:

# Add the chart repository (or use local chart)
helm upgrade --install mcp-alertmanager ./charts/mcp-alertmanager \
  --namespace mcp-servers \
  --create-namespace \
  --set openshift=true

Helm Values

Parameter

Description

Default

image.registry

Container registry

ghcr.io

image.repository

Image repository

jeanlopezxyz/mcp-alertmanager

image.version

Image tag

latest

openshift

Enable OpenShift Routes

false

service.port

Service port

8080

alertmanager.namespace

Alertmanager namespace

openshift-monitoring

alertmanager.service

Alertmanager service name

alertmanager-operated

rbac.useClusterReader

Use cluster-reader role

true

Example with custom Alertmanager

helm upgrade --install mcp-alertmanager ./charts/mcp-alertmanager \
  --namespace mcp-servers \
  --set openshift=true \
  --set alertmanager.url=http://alertmanager.monitoring:9093

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
11Releases (12mo)
Commit activity

Resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jeanlopezxyz/mcp-alertmanager'

If you have feedback or need assistance with the MCP directory API, please join our Discord server