Prometheus MCP Server
@tjhop
About Prometheus MCP Server
MCP server for LLMs to interact with Prometheus
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"prometheus-mcp-server-tjhop": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/tjhop/prometheus-mcp-server:latest",
"--prometheus.url",
"https://$yourPrometheus:9090"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Prometheus MCP Server?
Prometheus MCP Server is a Model Context Protocol server that enables LLMs to interact with a running Prometheus instance via its HTTP API. It allows generating and executing PromQL queries, listing and analyzing metrics, and reading Prometheus documentation, targeting developers and SREs who want AI-driven observability.
How to use Prometheus MCP Server?
Install the binary and configure it to connect to a Prometheus instance. Use command-line flags such as --prometheus.url (default: http://localhost:9090), --mcp.tools to whitelist specific tools, --dangerous.enable-tsdb-admin-tools for destructive operations, --prometheus.backend for compatible backends, --toon for TOON encoding, and --truncation to limit API response lines. The server exposes tools and resources that LLM clients can call.
Key features of Prometheus MCP Server
- Execute instant and range PromQL queries
- List and search metrics, labels, and series
- Access official Prometheus documentation via docs tools
- Support for Prometheus compatible backends (e.g., Thanos)
- Token/context efficiency through TOON encoding and response truncation
- Optional TSDB admin tools (dangerous)
Use cases of Prometheus MCP Server
- Investigate slow queries by analyzing Prometheus metrics
- Suggest recording rules for SLOs based on server metrics
- Summarize Prometheus metric and label naming best practices
- Review Prometheus instance health, configuration, and runtime info
FAQ from Prometheus MCP Server
What Prometheus compatible backends are supported?
The server works with any service offering a Prometheus compatible API. Specific backends like Thanos can be selected via --prometheus.backend, which may add or remove tools (e.g., Thanos removes config and adds list_stores).
Can I limit token usage from Prometheus API responses?
Yes. Use the --toon flag to convert JSON to TOON format for token efficiency, or set --truncation to limit the number of lines/entries returned. The truncation limit is disabled by default and can be overridden per-tool-call by capable LLMs.
What are the runtime dependencies?
The server is a compiled Go binary with no external runtime dependencies. It requires network access to a running Prometheus instance (or compatible backend).
How do I enable TSDB admin tools?
TSDB admin endpoints (e.g., delete_series, snapshot, clean_tombstones) are disabled by default. Start the server with the flag --dangerous.enable-tsdb-admin-tools to acknowledge the risk and enable them.
Does the server support authentication or transport security?
The README does not mention authentication or TLS configuration. The server assumes a direct HTTP connection to Prometheus and relies on Prometheus's own access control.
Frequently asked questions
What Prometheus compatible backends are supported?
The server works with any service offering a Prometheus compatible API. Specific backends like Thanos can be selected via `--prometheus.backend`, which may add or remove tools (e.g., Thanos removes `config` and adds `list_stores`).
Can I limit token usage from Prometheus API responses?
Yes. Use the `--toon` flag to convert JSON to TOON format for token efficiency, or set `--truncation` to limit the number of lines/entries returned. The truncation limit is disabled by default and can be overridden per-tool-call by capable LLMs.
What are the runtime dependencies?
The server is a compiled Go binary with no external runtime dependencies. It requires network access to a running Prometheus instance (or compatible backend).
How do I enable TSDB admin tools?
TSDB admin endpoints (e.g., `delete_series`, `snapshot`, `clean_tombstones`) are disabled by default. Start the server with the flag `--dangerous.enable-tsdb-admin-tools` to acknowledge the risk and enable them.
Does the server support authentication or transport security?
The README does not mention authentication or TLS configuration. The server assumes a direct HTTP connection to Prometheus and relies on Prometheus's own access control.
Basic information
More Developer Tools MCP servers
Stakpak Agent CLI
stakpakShip your code, on autopilot. An open source agent that lives on your machines 24/7 and keeps your apps running. 🦀
mcp-excalidraw
yctimlinMCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.
Hello World MCP Server (Reference Extension)
anthropicsDesktop Extensions: One-click local MCP server installation in desktop apps
Golf
golf-mcpProduction-Ready MCP Server Framework • Build, deploy & scale secure AI agent infrastructure • Includes Auth, Observability, Debugger, Telemetry & Runtime • Run real-world MCPs powering AI Agents
OpenSumi
opensumiA framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.
Comments