About alertmanager
alertmanager is an MCP server published by git+jeanlopezxyz in the Analytics category: mCP server for Prometheus-Alertmanager.
The repository has 3 stars and 0 forks.
Install
claude mcp add alertmanager -- npx -y alertmanager-mcpnpx -y alertmanager-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
getAlertGroupsGet alerts grouped by routing labels
Parameters not published.
getAlertingSummarySummary: counts by severity, top alerts, namespaces
Parameters not published.
getAlertsGet alerts with optional filters
Parameters not published.
getCriticalAlertsGet critical severity alerts only
Parameters not published.
Ask AI
Ask AI about alertmanager
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
4 checks have not been run yet.
README
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
| 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:
- Direct URL (if
--urlorALERTMANAGER_URLis set) - 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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.