Prometheus MCP Server · pab1it0 — Claude Code MCP server: PromQL queries
Lets your AI assistant query Prometheus metrics and run PromQL without leaving the chat.
claude mcp add --env PROMETHEUS_URL=<PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> --transport stdio prometheus-mcp-server -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2What Prometheus MCP Server does
The server puts a standard MCP interface between your assistant and Prometheus. It exposes tools for instant queries (execute_query), range queries with start, end and step (execute_range_query), metric discovery with pagination (list_metrics), metadata lookup, scrape targets and a health_check for container monitoring.
It runs in Docker from ghcr.io/pab1it0/prometheus-mcp-server:1.6.2. One variable is required: PROMETHEUS_URL pointing at your Prometheus server. Everything else is optional — basic auth, bearer token, mutual TLS with a client cert and key, SSL verification toggle, request timeout, and ORG_ID for multi-tenant setups.
Watch your context budget. Query results include links back to the Prometheus UI by default, and those links cost tokens; PROMETHEUS_DISABLE_LINKS=True strips them. If you run several environments in Cursor, set TOOL_PREFIX so tool names carry a prefix and two instances stay apart. Transport defaults to stdio, with http and sse available along with host and port settings.
What it helps with
- run a PromQL query without opening the Prometheus UI
- list available metrics and read their metadata
- pull a range query over a chosen interval and step
- check scrape targets and their state
- keep two server instances for different environments apart in one editor
Example prompts for the agent
- Run the instant query
upand show me which targets are down - Run a range query for
rate(http_requests_total[5m])over the last hour with a 1m step - List metrics starting with
node_and their metadata
How to install Prometheus MCP Server
Platform CLI
claude mcp add --env PROMETHEUS_URL=<PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> --transport stdio prometheus-mcp-server -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2Replace <…> with your own values. 9 more environment variables are in the server README
Platform CLI
codex mcp add prometheus-mcp-server --env PROMETHEUS_URL=<PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2Replace <…> with your own values. 9 more environment variables are in the server README
Config file
{
"mcpServers": {
"prometheus-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"-e",
"PROMETHEUS_URL_SSL_VERIFY",
"-e",
"PROMETHEUS_DISABLE_LINKS",
"-e",
"PROMETHEUS_USERNAME",
"-e",
"PROMETHEUS_PASSWORD",
"ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
],
"env": {
"PROMETHEUS_URL": "<PROMETHEUS_URL>",
"PROMETHEUS_URL_SSL_VERIFY": "<PROMETHEUS_URL_SSL_VERIFY>",
"PROMETHEUS_DISABLE_LINKS": "<PROMETHEUS_DISABLE_LINKS>",
"PROMETHEUS_USERNAME": "<PROMETHEUS_USERNAME>",
"PROMETHEUS_PASSWORD": "<PROMETHEUS_PASSWORD>"
}
}
}
}Replace <…> with your own values. 9 more environment variables are in the server README
Config file
{
"servers": {
"prometheus-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"-e",
"PROMETHEUS_URL_SSL_VERIFY",
"-e",
"PROMETHEUS_DISABLE_LINKS",
"-e",
"PROMETHEUS_USERNAME",
"-e",
"PROMETHEUS_PASSWORD",
"ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
],
"env": {
"PROMETHEUS_URL": "<PROMETHEUS_URL>",
"PROMETHEUS_URL_SSL_VERIFY": "<PROMETHEUS_URL_SSL_VERIFY>",
"PROMETHEUS_DISABLE_LINKS": "<PROMETHEUS_DISABLE_LINKS>",
"PROMETHEUS_USERNAME": "<PROMETHEUS_USERNAME>",
"PROMETHEUS_PASSWORD": "<PROMETHEUS_PASSWORD>"
}
}
}
}Replace <…> with your own values. 9 more environment variables are in the server README
Platform CLI
gemini mcp add -e PROMETHEUS_URL=<PROMETHEUS_URL> -e PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> -e PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> -e PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> -e PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> prometheus-mcp-server docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2Replace <…> with your own values. 9 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Prometheus MCP Server
How do I install Prometheus MCP Server in Claude Code?
With one command: `claude mcp add --env PROMETHEUS_URL=<PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<PROMETHEUS_PASSWORD> --transport stdio prometheus-mcp-server -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_URL_SSL_VERIFY -e PROMETHEUS_DISABLE_LINKS -e PROMETHEUS_USERNAME -e PROMETHEUS_PASSWORD ghcr.io/pab1it0/prometheus-mcp-server:1.6.2`
What does Prometheus MCP Server do?
It gives the assistant tools for Prometheus: instant and range PromQL queries, metric listing, metadata, scrape targets and a health check.
What do I need before running it?
A Prometheus server reachable from your environment and Docker. PROMETHEUS_URL is required; auth, TLS and timeout settings are optional.
Similar MCP servers
All MCP servers for DevOps and infrastructure →Prometheus MCP Server by other authors comes first.
