AUTOMATIONSWITCH
CommunityMonitoring

Prometheus MCP

by pab1it0

Prometheus PromQL query MCP with both instant and range queries, metric discovery, and target inspection. 429 GitHub stars and 9 commits on main in the last 30 days. Self-hosted, runs against any Prometheus endpoint.

429·6 tools·Released JAN 2025·MIT
docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server:latest
Share:

Prometheus PromQL query MCP with both instant and range queries, metric discovery, and target inspection. 429 GitHub stars and 9 commits on main in the last 30 days. Self-hosted, runs against any Prometheus endpoint.

Reviewed by M. Nouriel · MAY 2026

INSTALL THIS SERVER

Requires authenticationPROMETHEUS_URL environment variable points at the Prometheus endpoint. Authentication to Prometheus depends on the deployment (basic auth, mTLS, or open).
{ "mcpServers": { "prometheus": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PROMETHEUS_URL", "ghcr.io/pab1it0/prometheus-mcp-server:latest" ], "env": { "PROMETHEUS_URL": "http://your-prometheus:9090" } } } }
PrereqDocker image: `ghcr.io/pab1it0/prometheus-mcp-server:latest`. Set PROMETHEUS_URL to the Prometheus query endpoint. For Prometheus deployments behind auth, set PROMETHEUS_USERNAME and PROMETHEUS_PASSWORD or use a reverse proxy. Path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).
{ "mcpServers": { "prometheus": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PROMETHEUS_URL", "ghcr.io/pab1it0/prometheus-mcp-server:latest" ], "env": { "PROMETHEUS_URL": "http://your-prometheus:9090" } } } }
{ "mcpServers": { "prometheus": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PROMETHEUS_URL", "ghcr.io/pab1it0/prometheus-mcp-server:latest" ], "env": { "PROMETHEUS_URL": "http://your-prometheus:9090" } } } }
{ "mcpServers": { "prometheus": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PROMETHEUS_URL", "ghcr.io/pab1it0/prometheus-mcp-server:latest" ], "env": { "PROMETHEUS_URL": "http://your-prometheus:9090" } } } }
{ "mcpServers": { "prometheus": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PROMETHEUS_URL", "ghcr.io/pab1it0/prometheus-mcp-server:latest" ], "env": { "PROMETHEUS_URL": "http://your-prometheus:9090" } } } }

6 TOOLS AVAILABLE

health_check
Health endpoint for container monitoring
Read
execute_query
PromQL instant query
Read
execute_range_query
PromQL range query with start, end, and step
Read
list_metrics
List available metrics with pagination and filtering
Read
get_metric_metadata
Metadata for one metric or bulk filtered metadata
Read
get_targets
Information about all scrape targets
Read

OUR ASSESSMENT

Strengths
  • 429 GitHub stars and MIT licence.
  • 9 commits on main in the last 30 days.
  • Six-tool surface covers query, discovery, and targets.
  • Docker image at ghcr.io/pab1it0/prometheus-mcp-server for container-native deployment.
  • PromQL passthrough: full Prometheus query syntax available to agents.
  • Tool list is configurable via environment variables (avoid context-window bloat).
  • Health check tool useful for orchestration.
Weaknesses
  • Self-hosted: operator runs the container against their Prometheus endpoint.
  • Read-only by design; alert-rule and target configuration live elsewhere.
  • Authentication to Prometheus depends on the Prometheus deployment (basic auth, mTLS, or open).
Security Notes

The MCP forwards PromQL queries to the configured PROMETHEUS_URL. Scope the network path to the agent host: Prometheus has no built-in auth in default deployments. Use a reverse proxy or Prometheus Federation to scope read access by metric label or namespace.

Best For

Teams running Prometheus for metrics who want agents to query PromQL inside the editor; SRE workflows where the agent investigates a metric anomaly via list_metrics then execute_range_query; container orchestration that benefits from a health_check tool for the MCP itself.

TECHNICAL DETAILS

Language
python
Transport
stdio
Clients
Claude DesktopClaude CodeCursorVS CodeWindsurf
License
MIT
npm
prometheus-mcp-server
Last Release
ghcr.io/pab1it0/prometheus-mcp-server:latestMAY 3, 2026
First Released
JAN 1, 2025

ADOPTION METRICS

// GitHub Stars
429

// Reading this429 stars on the pab1it0/prometheus-mcp-server repo. 9 commits on main in the last 30 days.

// Popularity Rank
#2
Globally · #2 in Monitoring

// Reading thisSecond-ranked in monitoring; community-maintained with strong cadence and a six-tool surface.

SOURCES & VERIFICATION

We don't take any single directory's word for it. Before scoring, we cross-reference 4 public MCP sources, install the server ourselves against the clients we cover, and record when we last re-verified.

01
Discovered
Manual submission
First indexed MAY 3, 2026
02
Cross-referenced
4 directories
PulseMCP, MCP.so, Glama, Smithery
03
Verified against
Claude Desktop, Cursor (per README install instructions)
Installed and tested across clients
04
Last re-checked
MAY 3, 2026
Weekly re-verification
// How other directories see it

The same server, 4 different lenses. We reconcile these signals into our editorial score, which is why our number sometimes diverges from a directory-aggregate star count.

SourceTheir ratingTheir star countTheir downloadsLast synced
AutomationSwitch This page4.2editorial429MAY 3, 2026
PulseMCP— unratedunavailableunavailableMAY 3, 2026
MCP.so— unratedunavailableunavailableMAY 3, 2026
Glama— unratedunavailableunavailableMAY 3, 2026
Smithery— unratedunavailableunavailableMAY 3, 2026

// Counts are directory-reported; we don't adjust them. Discrepancies usually come from different snapshot times or star-caching.

// Get in touch

DISCUSS YOUR
MCP REQUIREMENTS.

Evaluating a server, scoping an internal deployment, or working out whether MCP is the right fit at all. Start the conversation and we will point you at the right piece of the ecosystem.

Discuss Your MCP Requirements →