# Prometheus MCP Server (MCP server)

> Prometheus MCP Server is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server providing Prometheus metrics access and PromQL… It has 516 GitHub stars, is released under the MIT license and runs locally with docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_PASSWORD -e PROMETHEUS_TOKEN ghcr.io/pab1it0/prometheus-mcp-server:1.6.2.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/pab1it0/prometheus-mcp-server |
| GitHub stars | 516 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | docker: ghcr.io/pab1it0/prometheus-mcp-server:1.6.2 |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Cloud & DevOps |
| Latest release | v1.6.2 (Aug 3, 2026) |
| Last commit | Oct 2, 2026 |
| MCP registry name | io.github.pab1it0/prometheus-mcp-server |

## Install

### Claude Desktop (claude_desktop_config.json)

```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": "your-value",
        "PROMETHEUS_PASSWORD": "your-value",
        "PROMETHEUS_TOKEN": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env PROMETHEUS_URL=your-value --env PROMETHEUS_PASSWORD=your-value --env PROMETHEUS_TOKEN=your-value --transport stdio prometheus-mcp-server -- docker run -i --rm -e PROMETHEUS_URL -e PROMETHEUS_PASSWORD -e PROMETHEUS_TOKEN ghcr.io/pab1it0/prometheus-mcp-server:1.6.2
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "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": "your-value",
        "PROMETHEUS_PASSWORD": "your-value",
        "PROMETHEUS_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "prometheus_password",
      "description": "PROMETHEUS_PASSWORD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "prometheus_token",
      "description": "PROMETHEUS_TOKEN",
      "password": true
    }
  ],
  "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": "your-value",
        "PROMETHEUS_PASSWORD": "${input:prometheus_password}",
        "PROMETHEUS_TOKEN": "${input:prometheus_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `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

## Tools

- `health_check`: System
- `execute_query`: Query
- `execute_range_query`: Query
- `list_metrics`: Discovery
- `get_metric_metadata`: Discovery
- `get_targets`: Discovery

## Similar MCP servers

- [Worldmonitor](https://appsgit.com/mcp-servers/worldmonitor): Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface. (87,920 stars, AGPL-3.0)
- [Netdata](https://appsgit.com/mcp-servers/netdata): Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection. (80,817 stars, GPL-3.0, needs API key)
- [openstatus](https://appsgit.com/mcp-servers/openstatus): Manage monitors, status pages, incidents and maintenances in your openstatus workspace. (9,171 stars, AGPL-3.0, official)
- [MCP Server Cloudflare](https://appsgit.com/mcp-servers/mcp-server-cloudflare): Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. (4,360 stars, Apache-2.0, official, needs API key)
- [Dagu](https://appsgit.com/mcp-servers/dagu): Self-hostable workflow orchestrator for teams whose main work isn't orchestration. (4,289 stars, GPL-3.0)
- [Azure MCP Server](https://appsgit.com/mcp-servers/azure-mcp-server): All Azure MCP tools to create a seamless connection between AI agents and Azure services. (3,738 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/prometheus-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
