MCP Server

Prometheus MCP Server MCP Server

Name: Prometheus MCP Server MCP Server
Author: io.github.pab1it0

io.github.pab1it0/prometheus-mcp-server

Repository Registry

What is the Prometheus MCP Server MCP server?

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

How to install Prometheus MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PROMETHEUS_URL
required
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
secret
Password for Prometheus basic authentication
PROMETHEUS_TOKEN
secret
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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.1"
      ],
      "env": {
        "PROMETHEUS_URL": "<YOUR_PROMETHEUS_URL>",
        "PROMETHEUS_URL_SSL_VERIFY": "<YOUR_PROMETHEUS_URL_SSL_VERIFY>",
        "PROMETHEUS_DISABLE_LINKS": "<YOUR_PROMETHEUS_DISABLE_LINKS>",
        "PROMETHEUS_USERNAME": "<YOUR_PROMETHEUS_USERNAME>",
        "PROMETHEUS_PASSWORD": "<YOUR_PROMETHEUS_PASSWORD>",
        "PROMETHEUS_TOKEN": "<YOUR_PROMETHEUS_TOKEN>",
        "ORG_ID": "<YOUR_ORG_ID>",
        "PROMETHEUS_CLIENT_CERT": "<YOUR_PROMETHEUS_CLIENT_CERT>",
        "PROMETHEUS_CLIENT_KEY": "<YOUR_PROMETHEUS_CLIENT_KEY>",
        "PROMETHEUS_MCP_SERVER_TRANSPORT": "<YOUR_PROMETHEUS_MCP_SERVER_TRANSPORT>",
        "PROMETHEUS_MCP_BIND_HOST": "<YOUR_PROMETHEUS_MCP_BIND_HOST>",
        "PROMETHEUS_MCP_BIND_PORT": "<YOUR_PROMETHEUS_MCP_BIND_PORT>",
        "PROMETHEUS_MCP_STATELESS_HTTP": "<YOUR_PROMETHEUS_MCP_STATELESS_HTTP>",
        "PROMETHEUS_CUSTOM_HEADERS": "<YOUR_PROMETHEUS_CUSTOM_HEADERS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.1"
      ],
      "env": {
        "PROMETHEUS_URL": "<YOUR_PROMETHEUS_URL>",
        "PROMETHEUS_URL_SSL_VERIFY": "<YOUR_PROMETHEUS_URL_SSL_VERIFY>",
        "PROMETHEUS_DISABLE_LINKS": "<YOUR_PROMETHEUS_DISABLE_LINKS>",
        "PROMETHEUS_USERNAME": "<YOUR_PROMETHEUS_USERNAME>",
        "PROMETHEUS_PASSWORD": "<YOUR_PROMETHEUS_PASSWORD>",
        "PROMETHEUS_TOKEN": "<YOUR_PROMETHEUS_TOKEN>",
        "ORG_ID": "<YOUR_ORG_ID>",
        "PROMETHEUS_CLIENT_CERT": "<YOUR_PROMETHEUS_CLIENT_CERT>",
        "PROMETHEUS_CLIENT_KEY": "<YOUR_PROMETHEUS_CLIENT_KEY>",
        "PROMETHEUS_MCP_SERVER_TRANSPORT": "<YOUR_PROMETHEUS_MCP_SERVER_TRANSPORT>",
        "PROMETHEUS_MCP_BIND_HOST": "<YOUR_PROMETHEUS_MCP_BIND_HOST>",
        "PROMETHEUS_MCP_BIND_PORT": "<YOUR_PROMETHEUS_MCP_BIND_PORT>",
        "PROMETHEUS_MCP_STATELESS_HTTP": "<YOUR_PROMETHEUS_MCP_STATELESS_HTTP>",
        "PROMETHEUS_CUSTOM_HEADERS": "<YOUR_PROMETHEUS_CUSTOM_HEADERS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.1"
      ],
      "env": {
        "PROMETHEUS_URL": "<YOUR_PROMETHEUS_URL>",
        "PROMETHEUS_URL_SSL_VERIFY": "<YOUR_PROMETHEUS_URL_SSL_VERIFY>",
        "PROMETHEUS_DISABLE_LINKS": "<YOUR_PROMETHEUS_DISABLE_LINKS>",
        "PROMETHEUS_USERNAME": "<YOUR_PROMETHEUS_USERNAME>",
        "PROMETHEUS_PASSWORD": "<YOUR_PROMETHEUS_PASSWORD>",
        "PROMETHEUS_TOKEN": "<YOUR_PROMETHEUS_TOKEN>",
        "ORG_ID": "<YOUR_ORG_ID>",
        "PROMETHEUS_CLIENT_CERT": "<YOUR_PROMETHEUS_CLIENT_CERT>",
        "PROMETHEUS_CLIENT_KEY": "<YOUR_PROMETHEUS_CLIENT_KEY>",
        "PROMETHEUS_MCP_SERVER_TRANSPORT": "<YOUR_PROMETHEUS_MCP_SERVER_TRANSPORT>",
        "PROMETHEUS_MCP_BIND_HOST": "<YOUR_PROMETHEUS_MCP_BIND_HOST>",
        "PROMETHEUS_MCP_BIND_PORT": "<YOUR_PROMETHEUS_MCP_BIND_PORT>",
        "PROMETHEUS_MCP_STATELESS_HTTP": "<YOUR_PROMETHEUS_MCP_STATELESS_HTTP>",
        "PROMETHEUS_CUSTOM_HEADERS": "<YOUR_PROMETHEUS_CUSTOM_HEADERS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "prometheus-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pab1it0/prometheus-mcp-server:1.6.1"
      ],
      "env": {
        "PROMETHEUS_URL": "<YOUR_PROMETHEUS_URL>",
        "PROMETHEUS_URL_SSL_VERIFY": "<YOUR_PROMETHEUS_URL_SSL_VERIFY>",
        "PROMETHEUS_DISABLE_LINKS": "<YOUR_PROMETHEUS_DISABLE_LINKS>",
        "PROMETHEUS_USERNAME": "<YOUR_PROMETHEUS_USERNAME>",
        "PROMETHEUS_PASSWORD": "<YOUR_PROMETHEUS_PASSWORD>",
        "PROMETHEUS_TOKEN": "<YOUR_PROMETHEUS_TOKEN>",
        "ORG_ID": "<YOUR_ORG_ID>",
        "PROMETHEUS_CLIENT_CERT": "<YOUR_PROMETHEUS_CLIENT_CERT>",
        "PROMETHEUS_CLIENT_KEY": "<YOUR_PROMETHEUS_CLIENT_KEY>",
        "PROMETHEUS_MCP_SERVER_TRANSPORT": "<YOUR_PROMETHEUS_MCP_SERVER_TRANSPORT>",
        "PROMETHEUS_MCP_BIND_HOST": "<YOUR_PROMETHEUS_MCP_BIND_HOST>",
        "PROMETHEUS_MCP_BIND_PORT": "<YOUR_PROMETHEUS_MCP_BIND_PORT>",
        "PROMETHEUS_MCP_STATELESS_HTTP": "<YOUR_PROMETHEUS_MCP_STATELESS_HTTP>",
        "PROMETHEUS_CUSTOM_HEADERS": "<YOUR_PROMETHEUS_CUSTOM_HEADERS>"
      }
    }
  }
}

Claude Code

claude mcp add prometheus-mcp-server --env PROMETHEUS_URL=<YOUR_PROMETHEUS_URL> --env PROMETHEUS_URL_SSL_VERIFY=<YOUR_PROMETHEUS_URL_SSL_VERIFY> --env PROMETHEUS_DISABLE_LINKS=<YOUR_PROMETHEUS_DISABLE_LINKS> --env PROMETHEUS_USERNAME=<YOUR_PROMETHEUS_USERNAME> --env PROMETHEUS_PASSWORD=<YOUR_PROMETHEUS_PASSWORD> --env PROMETHEUS_TOKEN=<YOUR_PROMETHEUS_TOKEN> --env ORG_ID=<YOUR_ORG_ID> --env PROMETHEUS_CLIENT_CERT=<YOUR_PROMETHEUS_CLIENT_CERT> --env PROMETHEUS_CLIENT_KEY=<YOUR_PROMETHEUS_CLIENT_KEY> --env PROMETHEUS_MCP_SERVER_TRANSPORT=<YOUR_PROMETHEUS_MCP_SERVER_TRANSPORT> --env PROMETHEUS_MCP_BIND_HOST=<YOUR_PROMETHEUS_MCP_BIND_HOST> --env PROMETHEUS_MCP_BIND_PORT=<YOUR_PROMETHEUS_MCP_BIND_PORT> --env PROMETHEUS_MCP_STATELESS_HTTP=<YOUR_PROMETHEUS_MCP_STATELESS_HTTP> --env PROMETHEUS_CUSTOM_HEADERS=<YOUR_PROMETHEUS_CUSTOM_HEADERS> -- docker run -i --rm ghcr.io/pab1it0/prometheus-mcp-server:1.6.1