Prometheus Mcp
Connects Claude directly to your Prometheus instance over stdio with five read-only tools: list metrics, run instant PromQL queries, fetch time-series ranges, inspect active alerts, and check scrape target health. Returns both structured JSON and markdown for each response. Supports bearer tokens, HTTP basic auth, or no auth for internal deployments. All tools are marked read-only, so there's zero risk of modifying data. Built for engineers who want to debug metrics, investigate alerts, or explore what's being scraped without switching contexts. Ships as a pip package or runs via uvx with no install. Works with Claude Desktop, Cursor, or any MCP client that speaks stdio.
- tools
- 5
- auth
- Secret needed
- transport
- STDIO
- env vars
- 5
- last updated
- Apr 18, 2026
Tools
5 toolsPublic tool metadata for what this MCP can expose to an agent.
prometheus_list_metricsList all metric names with optional substring filter (cap 500)
List all metric names with optional substring filter (cap 500)
No parameter schema in public metadata yet.
prometheus_queryExecute an instant PromQL query
Execute an instant PromQL query
No parameter schema in public metadata yet.
prometheus_query_rangeExecute a PromQL range query returning time-series
Execute a PromQL range query returning time-series
No parameter schema in public metadata yet.
prometheus_list_alertsList active and pending alerts
List active and pending alerts
No parameter schema in public metadata yet.
prometheus_list_targetsList scrape targets by health and job
List scrape targets by health and job
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
PROMETHEUS_URL*Prometheus server URL, e.g. https://prometheus.example.com (no trailing slash)
PROMETHEUS_TOKENsecretBearer token for authentication. Takes priority over Basic auth.
PROMETHEUS_USERNAMEHTTP Basic auth username. Used only when PROMETHEUS_TOKEN is not set.
PROMETHEUS_PASSWORDsecretHTTP Basic auth password.
PROMETHEUS_SSL_VERIFYdefault: trueVerify SSL certificates (true/false). Set to 'false' for self-signed certs.
Readme
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:
Details
- Repository
- github.com/mshegolev/prometheus-mcp
- Categories
- Search & Web Crawling, Monitoring & Observability
- Package
prometheus-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from mshegolev
Related Search & Web Crawling MCP servers
View all
Periodix Actionsnet.periodix/actionsSearch LinkedIn & Sales Navigator. Get structured people, companies, posts, jobs data. 4.9/5 on G2.0stars
Agency Mcp Servernpupko/agency-mcp-serverOn-demand access to 150+ specialist AI agent templates — search, browse, and spawn agents0stars
Db Metadata Extractor Mcpoptisol-business/db-metadata-extractor-mcpExtract database metadata from PostgreSQL, Snowflake, SQL Server, BigQuery, and Oracle.0stars
Wonders MCPorg.machupicchu/wonders-mcpRead-only MCP for heritage travel: search 500+ UNESCO destinations by region and intent.0stars
Embgrepquartzunit/embgrepLocal semantic search — embedding-powered grep for files, zero external services.0stars
ShowMeStepBySteprt1966/showmestepbystepSearch, browse, and cite 409 step-by-step how-to tutorials (steps, tools, video credit).0stars