Skip to content
MCP server

Prometheus MCP Server

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.6.2
Listing updated
4 days ago

About Prometheus MCP Server

Prometheus MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add prometheus-mcp-server --env PROMETHEUS_URL='<PROMETHEUS_URL>' --env PROMETHEUS_PASSWORD='<PROMETHEUS_PASSWORD>' --env 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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "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

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "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

{
  "servers": {
    "prometheus-mcp-server": {
      "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 ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "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 your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "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>"
      }
    }
  }
}

Configuration

  • PROMETHEUS_URLPrometheus server URL (e.g., http://localhost:9090)Required
  • 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_PASSWORDPassword for Prometheus basic authentication
  • PROMETHEUS_TOKENBearer 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

Pricing

Open source

Prices change. Check pab1it0.github.io before you buy.

Prometheus MCP Server FAQ

Is Prometheus MCP Server free?

Yes. Prometheus MCP Server is open source, so you can use and self-host it for free.

How do I add Prometheus MCP Server to Claude Code?

Run this command in your terminal: claude mcp add prometheus-mcp-server --env PROMETHEUS_URL='<PROMETHEUS_URL>' --env PROMETHEUS_PASSWORD='<PROMETHEUS_PASSWORD>' --env 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