---
title: "Prometheus MCP server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/prometheus/
description: "Prometheus project's MCP server. The default tool set includes config reload and process quit. TSDB delete tools error unless a dangerous flag is set."
---

# Prometheus MCP server: review, setup & limitations · Undominated.ai

> Prometheus project's MCP server. The default tool set includes config reload and process quit. TSDB delete tools error unless a dangerous flag is set.

[← Explore all mcp servers](/mcp-servers/)

METRICS / Prometheus

# Prometheus MCP server

Prometheus project's MCP server. The default tool set includes config reload and process quit. TSDB delete tools error unless a dangerous flag is set.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/prometheus/prometheus-mcp)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 6 linked sources
 Publisher Prometheus
 Licence [Apache-2.0 ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/LICENSE)
 Revision 856fb4598901
 [Read what was—and wasn’t—checked ↓](#review)

“MCP server that registers Prometheus query, metadata, management, and TSDB admin tools. Default transport is stdio. HTTP mode serves Streamable HTTP at /mcp.”

 [Prometheus · upstream description ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/cmd/prometheus-mcp/main.go) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - registration.go registers the Prometheus tool set, and getToolset treats the default mcp.tools value all as that full set, which includes reload and quit.
- handlers.go returns an error for clean_tombstones, delete_series, and snapshot unless tsdb admin tools are enabled. ReloadHandler and QuitHandler post to the management API with no extra flag.

### A good fit for

 - Inspect PromQL results and metric labels with a bounded range and a core-only tool surface.
- Compare metric metadata with embedded documentation/runbooks before diagnosing cardinality or scrape behavior.

### Weigh up before choosing

 - Default --mcp.tools is all, so reload and quit are registered and post to the Prometheus management API. --dangerous.enable-tsdb-admin-tools defaults to false; when it is set, delete_series also requires matches, start_time, and end_time.
- HTTP mode mounts /mcp; stdio is the default. Backend presets replace selected tools. Pinned source was not built or compared with a release artifact; tool annotation definitions were inspected in this wave.
- Core includes documentation, runbooks, query/range_query, metric metadata, label names/values and series. Tool selection reduces exposure but does not enforce data-level authorization.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - cmd/prometheus-mcp/main.go
- pkg/mcp/registration.go
- pkg/mcp/handlers.go management and TSDB admin handlers
- LICENSE
- 2026-10-14 reread of retained pinned setup/configuration evidence for the specific operational details added in this batch.
- README.md
- pkg/mcp/tools.go

### Our findings

 - Admin delete, snapshot, and tombstone handlers check tsdbAdminToolsEnabled. Reload and quit do not.
- The default tool selector is the string all, which loads prometheusToolset.
- Additional README and tool definitions were opened. Query annotations declare ReadOnlyHint, but operational controls come from tool selection and backend permissions rather than annotations.

### Not established by this review

 - The server was not installed or connected to Prometheus.
- No query, reload, quit, or delete call was made.
- No authenticated session, installation, permission bypass or package-to-source parity test was performed.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/cmd/prometheus-mcp/main.go)
 - Build the reviewed source or separately verify a release binary; replace the absolute executable path and intended Prometheus URL.
- Start with --mcp.tools=core and leave the dangerous TSDB-admin switch unset. Do not set --prometheus.backend on this restricted starter because its preset replaces the tool set.
- Use bounded query ranges and retain evaluation times; missing series are not automatically zero-valued measurements.

### Before you start

 - Go toolchain to build this commit
- A Prometheus base URL the process is allowed to call

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "prometheus": {
 "command": "/absolute/path/prometheus-mcp-server",
 "args": [
 "--prometheus.url=http://127.0.0.1:9090",
 "--mcp.tools=core"
 ]
 }
 }
} Copy configuration ↗

### Compatibility

MCP stdio clients · MCP Streamable HTTP clients

### Implementation

Go

### Transports

stdio · Streamable HTTP

### Queries Prometheus by default and can reload or quit it; series deletion needs a separate flag

 - Query and read metadata on the configured Prometheus
- POST a config reload and a graceful shutdown
- Delete series, clean tombstones, or snapshot only when --dangerous.enable-tsdb-admin-tools is set

### Cost model

Apache-2.0 source at no charge. Prometheus itself is yours to operate.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Tool registration ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/pkg/mcp/registration.go) Checked 2026-10-14 https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/pkg/mcp/registration.go Supports: Default all toolset, reload and quit registration, summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
- [Handlers ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/pkg/mcp/handlers.go) Checked 2026-10-07 https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/pkg/mcp/handlers.go Supports: TSDB admin gate, reload and quit posts
- [Process flags and HTTP mount ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/cmd/prometheus-mcp/main.go) Checked 2026-10-14 https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/cmd/prometheus-mcp/main.go Supports: stdio default, /mcp, dangerous flag default, summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
- [Apache-2.0 licence ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/LICENSE) Checked 2026-10-07 https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/LICENSE Supports: Redistribution terms, Unfilled copyright appendix
- [Additional pinned implementation/setup review: README.md ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/README.md) Checked 2026-10-14 https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/README.md Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports
- [Additional pinned implementation/setup review: pkg/mcp/tools.go ↗](https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/pkg/mcp/tools.go) Checked 2026-10-14 https://github.com/prometheus/prometheus-mcp/blob/856fb45989013a0b020a900463884104ba0af11d/pkg/mcp/tools.go Supports: summary, install, configExample, access, limitations, bestFor, review, compatibility, transports

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### VictoriaMetrics MCP server ↗ MetricsQL and metadata reads against one VictoriaMetrics instance. Export, flags, three debug tools, and test_rules stay off unless the disable list is replaced.](/mcp-servers/victoriametrics/)[### AWS Managed Prometheus MCP ↗ Pins the AWS Labs server for PromQL against Amazon Managed Prometheus, and records that the basic Kiro example omits the workspace URL.](/mcp-servers/awslabs-prometheus/)[### Axiom MCP ↗ Queries Axiom telemetry and manages observability resources through an account-authorized hosted connection.](/mcp-servers/axiom/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
