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.

OTHER MONITORING MCP SERVERS

Vendor4.5

Grafana MCP Server

Grafana Labs

Vendor-official Grafana MCP server from Grafana Labs. Covers dashboards (search, get, summary, JSONPath extraction, patch), datasources (Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch), and direct query execution (PromQL, LogQL, InfluxQL/Flux, ClickHouse SQL).

8 tools2,929
Community4.3

Langfuse MCP

avivsinai (community)

MCP server for Langfuse. Query LLM trace data, sessions, and observations from inside agents for debugging and observability. 85 GitHub stars and 16 commits on main in the last 30 days.

6 tools85
Official4.3

Axiom MCP

Axiom

Official Axiom MCP server. Query Axiom datasets via APL (Axiom Processing Language) and inspect dashboards, monitors, and notifiers. 12 stars and 30 commits on main in the last 30 days.

7 tools12
Official4.2

Rollbar MCP

Rollbar

Official Rollbar MCP server: error tracking, occurrence triage, deploy tracking, and item lifecycle for AI agents. 25 stars and 13 commits on main in the last 30 days.

7 tools25
Official4.1

PagerDuty MCP

PagerDuty

Official PagerDuty MCP server for incident management, on-call schedules, services, escalation policies, and event API integration. 66 GitHub stars and 5 commits on main in the last 30 days. Apache-2.0.

8 tools66
Official4

Datadog MCP

Datadog

Official Datadog managed MCP server covering logs, metrics, traces, incidents, and dashboards. HTTP-only transport, hosted by Datadog with regional endpoints (US1, EU, etc.). 6 commits on main in the last 30 days. Stars are modest (35) reflecting recent launch.

7 tools35
// 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 →