
Prometheus MCP Server
The Prometheus MCP Server enables AI assistants to query and analyze Prometheus metrics by providing standardized MCP interfaces for executing PromQL queries against a Prometheus instance. It supports multiple deployment options including Claude Desktop, VS Code, Cursor, Windsurf, and Docker, with configuration via environment variables to specify the Prometheus server URL. This tool solves the problem of giving language models direct access to monitoring data and time-series metrics without requiring custom API integrations.
- GitHub stars
- 522
- tools
- 6
- auth
- Secret needed
- transport
- STDIO
- env vars
- 14
- last updated
- Aug 3, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
health_checkHealth check endpoint for container monitoring and status verification
Health check endpoint for container monitoring and status verification
No parameter schema in public metadata yet.
execute_queryExecute a PromQL instant query against Prometheus
Execute a PromQL instant query against Prometheus
No parameter schema in public metadata yet.
execute_range_queryExecute a PromQL range query with start time, end time, and step interval
Execute a PromQL range query with start time, end time, and step interval
No parameter schema in public metadata yet.
list_metricsList all available metrics in Prometheus with pagination and filtering support
List all available metrics in Prometheus with pagination and filtering support
No parameter schema in public metadata yet.
get_metric_metadataGet metadata for one metric or bulk metadata with optional filtering
Get metadata for one metric or bulk metadata with optional filtering
No parameter schema in public metadata yet.
get_targetsGet scrape targets, with server-side state/scrape_pool filtering and optional pagination
Get scrape targets, with server-side state/scrape_pool filtering and optional pagination
No parameter schema in public metadata yet.
Sponsors
Configuration
PROMETHEUS_URL*Prometheus server URL (e.g., http://localhost:9090)
PROMETHEUS_URL_SSL_VERIFYSet to False to disable SSL verification
PROMETHEUS_DISABLE_LINKSSet to True to disable Prometheus UI links in query results (saves context tokens in MCP clients)
PROMETHEUS_USERNAMEUsername for Prometheus basic authentication
PROMETHEUS_PASSWORDsecretPassword for Prometheus basic authentication
PROMETHEUS_TOKENsecretBearer token for Prometheus authentication
ORG_IDOrganization ID for multi-tenant Prometheus setups
PROMETHEUS_CLIENT_CERTPath to client certificate file for mutual TLS authentication
PROMETHEUS_CLIENT_KEYPath to client private key file for mutual TLS authentication
PROMETHEUS_MCP_SERVER_TRANSPORTMCP server transport type (stdio, http, or sse)
PROMETHEUS_MCP_BIND_HOSTHost address for HTTP/SSE transport (default: 127.0.0.1)
PROMETHEUS_MCP_BIND_PORTPort number for HTTP/SSE transport (default: 8080)
PROMETHEUS_MCP_STATELESS_HTTPEnable stateless HTTP mode for multi-replica support (default: false)
PROMETHEUS_CUSTOM_HEADERSCustom headers as JSON string to include in Prometheus requests
Readme
Prometheus MCP Server
Give AI assistants the power to query your Prometheus metrics.
Details
- Repository
- github.com/pab1it0/prometheus-mcp-server
- Website
- pab1it0.github.io/prometheus-mcp-server
- Category
- Monitoring & Observability
- Package
ghcr.io/pab1it0/prometheus-mcp-server:1.6.2- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active