Prometheus MCP server
Prometheus MCP — query metrics, inspect alerts, and explore scrape targets (read-only).
0 stars32 downloads/wk
Reviews
Write oneNobody has reviewed Prometheus yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Prometheus tools (7, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
_parse_boolParse an env-var boolean.
mainEntry point for the ``prometheus-mcp`` console script (stdio).
prometheus_list_alertsList all active and pending alerts from Prometheus.
prometheus_list_metricsList all metric names known to Prometheus, with optional substring filter.
prometheus_list_targetsList Prometheus scrape targets, summarised by job and health.
prometheus_querywrite actionExecute an instant PromQL query against Prometheus.
prometheus_query_rangewrite actionExecute a PromQL range query returning time-series data points.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan10 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 51 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Prometheus compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,273 servers
- Tools
- 7
- the typical server has 7
- Tools that change things
- 29%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 32
- more than 22% of 11,915 servers with a package
What its tools let an agent do: 5 read · 2 change
Install Prometheus in Claude Code, Cursor or VS Code
claude mcp add prometheus-mcp -- uvx prometheus-mcp
What the publisher says
From the Prometheus repository's README, as published. We do not edit it. Read it on GitHub
prometheus-mcp
<!-- mcp-name: io.github.mshegolev/prometheus-mcp -->
MCP server for Prometheus metrics and observability. Give Claude (or any MCP-capable agent) read access to your Prometheus instance — query metrics with PromQL, inspect active alerts, and explore scrape targets — without leaving the conversation.
Why another Prometheus MCP?
The existing Prometheus integrations require custom scripts or direct API knowledge. This server:
- Speaks the standard Model Context Protocol over stdio — works with Claude Desktop, Claude Code, Cursor, and any MCP client.
- Is read-only: all 5 tools carry readOnlyHint: true — zero risk of modifying Prometheus data.
- Returns dual-channel output: structured JSON (structuredContent) for programmatic use + Markdown (content) for human-readable display.
- Has actionable error messages that name the exact env var to fix and suggest a next step.
- Supports Bearer token, HTTP Basic auth, or no auth (common for internal deployments).
Tools
v4.0 Advanced Alert Correlation Features
Version 4.0 introduces powerful new capabilities for AI agents to autonomously investigate production errors:
Cross-Instance Alert Correlation
- Automatically identify related alerts across multiple Prometheus instances
- Group alerts by service identifiers to understand incident scope
- Detect cascading alert patterns with directional dependency inference
Root Cause Analysis
- Anomaly detection in metrics with automatic seasonality adjustment
- Dependency chain traversal from symptoms to potential root causes
- Change point detection correlating alerts with recent deployments or config changes
- Ranked root cause candidates based on evidence strength and impact analysis
Dependency Mapping & Health
- Dynamic service dependency maps built from traffic correlation analysis
- Cross-cluster dependency visualization showing service interoperation
- Synthetic health probing to assess dependency resilience
- Load shedding recommendations based on dependency fragility
Trend Analysis & Benchmarking
- Historical pattern recognition for recurring alert schedules
- Capacity forecasting to predict resource exhaustion
- MTTR benchmarking comparing resolution times against historical data
- Deviation detection triggering higher-priority notifications for pattern breaks
Integrated Analysis Tool
- New federationanalyzealerts tool combining all v4.0 features
- Unified output format optimized for AI agent consumption
- Comprehensive incident context in a single tool call
Installation
pip install prometheus-mcpOr run directly without installing:
uvx prometheus-mcpConfiguration
All configuration is via environment variables:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Prometheus: common questions
- Is Prometheus MCP server safe?
- Mostly: it is graded B (78/100). Read the Prometheus safety report
- How do I install Prometheus?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Prometheus need an API key?
- Yes. The registry entry asks for
PROMETHEUS_TOKEN,PROMETHEUS_PASSWORD. - Is Prometheus maintained?
- The last commit was 87 days ago (2026-08-07). The latest release is v0.1.0.
- What can I use instead of Prometheus?
- Servers from other publishers that do the same job: Netdata MCP server.
- How does Prometheus compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,273 servers); tools 7 (the typical server has 7); tools that change things 29% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Prometheus
Same job from other publishers: the closest match first, then the best rated.
- NetdataReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.not reviewedWidely usedA