Prometheus MCP Server

by pab1it0io.github.pab1it0/prometheus-mcp-serverv1.6.2

MCP server providing Prometheus metrics access and PromQL query execution for AI assistants

516Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active8d ago

Install Prometheus MCP server

claude mcp add prometheus -e PROMETHEUS_URL='<prometheus-url>' -e PROMETHEUS_PASSWORD='<prometheus-password>' -e PROMETHEUS_TOKEN='<prometheus-token>' -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_PASSWORD -e PROMETHEUS_TOKEN ghcr.io/pab1it0/prometheus-mcp-server:1.6.2

{
  "mcpServers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROMETHEUS_URL",
        "-e",
        "PROMETHEUS_PASSWORD",
        "-e",
        "PROMETHEUS_TOKEN",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
      ],
      "env": {
        "PROMETHEUS_URL": "<prometheus-url>",
        "PROMETHEUS_PASSWORD": "<prometheus-password>",
        "PROMETHEUS_TOKEN": "<prometheus-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROMETHEUS_URL",
        "-e",
        "PROMETHEUS_PASSWORD",
        "-e",
        "PROMETHEUS_TOKEN",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
      ],
      "env": {
        "PROMETHEUS_URL": "<prometheus-url>",
        "PROMETHEUS_PASSWORD": "<prometheus-password>",
        "PROMETHEUS_TOKEN": "<prometheus-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "prometheus": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROMETHEUS_URL",
        "-e",
        "PROMETHEUS_PASSWORD",
        "-e",
        "PROMETHEUS_TOKEN",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
      ],
      "env": {
        "PROMETHEUS_URL": "<prometheus-url>",
        "PROMETHEUS_PASSWORD": "<prometheus-password>",
        "PROMETHEUS_TOKEN": "<prometheus-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PROMETHEUS_URL",
        "-e",
        "PROMETHEUS_PASSWORD",
        "-e",
        "PROMETHEUS_TOKEN",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.2"
      ],
      "env": {
        "PROMETHEUS_URL": "<prometheus-url>",
        "PROMETHEUS_PASSWORD": "<prometheus-password>",
        "PROMETHEUS_TOKEN": "<prometheus-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PROMETHEUS_URL	yes	—	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_PASSWORD	—	yes	Password for Prometheus basic authentication
PROMETHEUS_TOKEN	—	yes	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

Freshness

Active — last maintenance signal 8d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-02 · 8d ago · GitHub
Latest release
2026-08-03 · 2mo ago · GitHub · v1.6.2
Package published
no data · npm/PyPI
Registry entry updated
2026-08-03 · 2mo ago · official registry · v1.6.2

FAQ

›How do I install the Prometheus MCP server in Claude Code?

Run: claude mcp add prometheus -e PROMETHEUS_URL='<prometheus-url>' -e PROMETHEUS_PASSWORD='<prometheus-password>' -e PROMETHEUS_TOKEN='<prometheus-token>' -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_PASSWORD -e PROMETHEUS_TOKEN ghcr.io/pab1it0/prometheus-mcp-server:1.6.2. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Prometheus require an API key?

Yes. It expects PROMETHEUS_URL, PROMETHEUS_PASSWORD, PROMETHEUS_TOKEN, of which 2 are secrets.

›Can I use Prometheus as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Prometheus in the official MCP registry?

Yes, as io.github.pab1it0/prometheus-mcp-server.