# Prometheus MCP Server (MCP server)

> Prometheus MCP Server is an MCP server that manages Prometheus-compatible backends. It has 117 GitHub stars, is released under the Apache-2.0 license and runs locally with docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0. It works with Claude Desktop, Claude Code, Cursor and VS Code.

The prompt used was: querying my metrics is slow, can you help me figure out why? The prompt used was: use the tools from the prometheus mcp server to investigate the metrics from the mcp server and suggest prometheus recording rules for SLOs

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/prometheus/prometheus-mcp |
| GitHub stars | 117 |
| License | Apache-2.0 |
| Language | Go |
| Transport | stdio |
| Packages | docker: ghcr.io/tjhop/prometheus-mcp-server:0.18.0 |
| Remote URL | none |
| Needs API key | no |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Cloud & DevOps |
| Latest release | v0.18.0 (Apr 25, 2026) |
| Last commit | Oct 2, 2026 |
| MCP registry name | io.github.tjhop/prometheus-mcp-server |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "prometheus-mcp-server-prometheus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tjhop/prometheus-mcp-server:0.18.0"
      ]
    }
  }
}
```

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

### Claude Code

```sh
claude mcp add --transport stdio prometheus-mcp-server-prometheus -- docker run -i --rm ghcr.io/tjhop/prometheus-mcp-server:0.18.0
```

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

```json
{
  "mcpServers": {
    "prometheus-mcp-server-prometheus": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tjhop/prometheus-mcp-server:0.18.0"
      ]
    }
  }
}
```

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

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

```json
{
  "servers": {
    "prometheus-mcp-server-prometheus": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/tjhop/prometheus-mcp-server:0.18.0"
      ]
    }
  }
}
```

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

## Tools

- `alertmanagers`: Get overview of Prometheus Alertmanager discovery
- `build_info`: Get Prometheus build information
- `config`: Get Prometheus configuration
- `docs_list`: List of Official Prometheus Documentation Files
- `docs_read`: Read the named markdown file containing official Prometheus documentation from the prometheus/docs repo
- `docs_search`: Search the markdown files containing official Prometheus documentation from the prometheus/docs repo
- `exemplar_query`: Performs a query for exemplars by the given query and time range
- `flags`: Get runtime flags
- `healthy`: Management API endpoint that can be used to check Prometheus health
- `label_names`: Returns the unique label names present in the block in sorted order by given time range and matchers
- `label_values`: Performs a query for the values of the given label, time range and matchers
- `list_alerts`: List all active alerts
- `list_rules`: List all alerting and recording rules that are loaded
- `list_targets`: Get overview of Prometheus target discovery
- `metric_metadata`: Returns metadata about metrics currently scraped by the metric name
- `query`: Execute an instant query against the Prometheus datasource, returning one value per series at a single point in time
- `quit`: Management API endpoint that can be used to trigger a graceful shutdown of Prometheus
- `range_query`: Execute a range query against the Prometheus datasource, returning values over a time window
- `ready`: Management API endpoint that can be used to check Prometheus is ready to serve traffic (i.e. respond to queries
- `reload`: Management API endpoint that can be used to trigger a reload of the Prometheus configuration and rule files
- `runbooks_list`: List the runbooks embedded in this server: guided workflows (Agent Skills) for common Prometheus tasks
- `runbooks_read`: Read the named runbook by skill name (e.g. check-system-health)
- `runtime_info`: Get Prometheus runtime information
- `series`: Finds series by label matchers
- `targets_metadata`: Returns metadata about metrics currently scraped by the target
- `tsdb_stats`: Get usage and cardinality statistics from the TSDB
- `wal_replay_status`: Get current WAL replay status
- `clean_tombstones`: Removes the deleted data from disk and cleans up the existing tombstones
- `delete_series`: deletes data for a selection of series in a time range
- `snapshot`: creates a snapshot of all current data into snapshots/- under the TSDB's data directory and returns the directory as…
- `prometheus`: n/a

## 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-prometheus
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.