pab1it0 avatar

Prometheus MCP Server

pab1it0/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 tools

Public 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_VERIFY

Set to False to disable SSL verification

PROMETHEUS_DISABLE_LINKS

Set to True to disable Prometheus UI links in query results (saves context tokens in MCP clients)

PROMETHEUS_USERNAME

Username for Prometheus basic authentication

PROMETHEUS_PASSWORDsecret

Password for Prometheus basic authentication

PROMETHEUS_TOKENsecret

Bearer token for Prometheus authentication

ORG_ID

Organization ID for multi-tenant Prometheus setups

PROMETHEUS_CLIENT_CERT

Path to client certificate file for mutual TLS authentication

PROMETHEUS_CLIENT_KEY

Path to client private key file for mutual TLS authentication

PROMETHEUS_MCP_SERVER_TRANSPORT

MCP server transport type (stdio, http, or sse)

PROMETHEUS_MCP_BIND_HOST

Host address for HTTP/SSE transport (default: 127.0.0.1)

PROMETHEUS_MCP_BIND_PORT

Port number for HTTP/SSE transport (default: 8080)

PROMETHEUS_MCP_STATELESS_HTTP

Enable stateless HTTP mode for multi-replica support (default: false)

PROMETHEUS_CUSTOM_HEADERS

Custom headers as JSON string to include in Prometheus requests

Readme

Prometheus MCP Server

GitHub Container Registry Helm Chart GitHub Release Codecov Python License

Give AI assistants the power to query your Prometheus metrics.


View the full README on GitHub

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

Related Monitoring & Observability MCP servers

View all
1surendranb avatarGoogle Analytics Mcpsurendranb/google-analytics-mcpGA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.244stars
2nikolai-vysotskyi avatarTrace Mcpnikolai-vysotskyi/trace-mcpCode graph MCP: 81 languages, 91 frameworks, 72.7% fewer PR-review tokens, comprehension at parity203stars
3siddhant-k-code avataragent-stracesiddhant-k-code/agent-traceQuery recorded AI agent sessions: events, summaries, diffs, health, skills, PR reviewability.104stars
4tocharianou avatarKibanatocharianou/mcp-server-kibanaKibana MCP Server with dynamic API discovery and comprehensive Elastic Stack integration86stars
5ralfbecher avatarOrionbelt Analyticsralfbecher/orionbelt-analyticsOntology-based MCP server for database schema analysis and RDF/OWL ontology generation32stars
6zw008 avatarVMware Monitorzw008/vmware-monitorRead-only VMware vCenter/ESXi monitoring with 27 MCP tools. Code-level safety.18stars