Prometheus MCP Server

Give AI assistants the power to query your Prometheus metrics. A [Model Context Protocol][mcp] (MCP) server that provides access to your Prometheus metrics and queries through standardized MCP interfaces, allowing AI assistants to execute PromQL queries and analyze your metrics data. Its 6 documented tools cluster into read & search, run & execute, health.

People who need DevOps & monitoring tools inside Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-05 · ★ 513 · #52 OF 101 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Prometheus MCP Server

before you install - you'll need

Set PROMETHEUS_URL, PROMETHEUS_USERNAME, PROMETHEUS_PASSWORD before connecting.

Docker

docker run -i --rm ghcr.io/pab1it0/prometheus-mcp-server:1.6.2

Claude Desktop - add to config

{
  "mcpServers": {
    "pab1it0-prometheus-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
      ]
    }
  }
}
Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

registry namespace io.github.pab1it0 is GitHub-verified and matches the repo owner

03 · What Prometheus MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can execute a PromQL instant query against Prometheus, execute a PromQL range query with start time, end time, and step interval, list all available metrics in Prometheus with pagination and filtering support, and get metadata for one metric or bulk metadata with optional filtering.

Capability map

Tools grouped from the project's README - what Prometheus MCP Server lets an agent do.

read & search

3 tools - e.g. List all available metrics in Prometheus with pagination and filtering support; Get metadata for one metric or bulk metadata with optional filtering; Get scrape targets, with server-side state/scrape_pool…

list_metrics · get_metric_metadata · get_targets

run & execute

2 tools - e.g. Execute a PromQL instant query against Prometheus; Execute a PromQL range query with start time, end time, and step interval

execute_query · execute_range_query

Health

1 tool - e.g. Health check endpoint for container monitoring and status verification

health_check

Latest releases

v1.6.2 · 2026-08-03

bump to 1.1.0 and require version bump in CI · support chart-v tags for chart-only releases · use /health endpoint in HEALTHCHECK for HTTP/SSE transports · bump authlib from 1.6.11 to 1.6.12 · bump starlette from…

v1.6.1 · 2026-05-01

add Helm chart with OCI registry publishing · upgrade MCP Python SDK to 1.26.0 · add README for Helm chart · bump pyjwt from 2.10.1 to 2.12.0 · bump authlib from 1.6.7 to 1.6.9 · remove trivy security scanning workflow…

v1.6.0 · 2026-03-07

refactor README for better user experience · add bulk metric metadata retrieval with filtering and pagination · upgrade to FastMCP 3.x and fix CI test failures · add mutual TLS (client certificate) authentication…

04 · Who maintains Prometheus MCP Server

Prometheus MCP Server is maintained by pab1it0. It's the only MCP server we track from this author; the repo dates to Mar 2025.

05 · Facts

category
DevOps & monitoring - ranked #52 of 101 actively-maintained DevOps & monitoring servers as of 2026-08-25.
release cadence
1 release in the last 90 days (latest 2026-08-03)
registry
io.github.pab1it0/prometheus-mcp-server (active, first published 2025-09-20 · 13 versions)
packages
oci:ghcr.io/pab1it0/prometheus-mcp-server:1.6.2

06 · Prometheus MCP Server FAQ

Is Prometheus MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-05 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Prometheus MCP Server do?

With this server connected, an agent can execute a PromQL instant query against Prometheus, execute a PromQL range query with start time, end time, and step interval, list all available metrics in Prometheus with pagination and filtering support, and get metadata for one metric or bulk metadata with optional filtering.

How do I install Prometheus MCP Server?

Run `docker run -i --rm ghcr.io/pab1it0/prometheus-mcp-server:1.6.2`. The README documents 3 environment variables (PROMETHEUS_URL, PROMETHEUS_USERNAME, PROMETHEUS_PASSWORD) to set first. Set PROMETHEUS_URL, PROMETHEUS_USERNAME, PROMETHEUS_PASSWORD before connecting. You can also paste the ready-made client config above.

07 · Alternatives to Prometheus MCP Server

More DevOps & monitoring MCP servers · Pentesttoolscom MCP Server · AI R · Hatchbox · Langfuse · Adif MCP

More Python MCP servers · Pagerduty MCP · Datawrapper · Parseur · Odoo MCP Gateway · Fitbit MCP · see all