Prometheus MCP Server
by tjhopcommunityv0.17.0
44
14
This MCP server allows LLMs to interact with a running Prometheus instance via its API to generate and execute promql queries, list and analyze metrics, and more.
From the registry: An API-complete MCP server to manage Prometheus-compatible backends.
Install & configure
Prerequisites
- requiredPrometheus serverA running Prometheus instance
- requiredDownload binaryDownload release binary for your platform from GitHub Releaseshttps://github.com/tjhop/prometheus-mcp-server/releases
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `prometheus-mcp-server-tjhop` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Prometheus server** — A running Prometheus instance
- **Download binary** — Download release binary for your platform from GitHub Releases (https://github.com/tjhop/prometheus-mcp-server/releases)
Canonical MCP server config (stdio transport):
- command: `prometheus-mcp-server`
- args: ["--prometheus.url","http://127.0.0.1:9090"]
- required environment variables:
- `PROMETHEUS_MCP_SERVER_PROMETHEUS_URL`: URL of the Prometheus instance (example: `http://your-prometheus:9090`)
- optional environment variables:
- `PROMETHEUS_MCP_SERVER_MCP_TRANSPORT`: Transport type: stdio or http (example: `stdio`)
Note: Go binary with Helm chart for Kubernetes. Supports Thanos backend. Also available via Docker. Rich docs tools, TOON encoding for token efficiency. Replace binary path with actual location.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Go binary with Helm chart for Kubernetes. Supports Thanos backend. Also available via Docker. Rich docs tools, TOON encoding for token efficiency. Replace binary path with actual location.
Tools (28)
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
Packages
ghcr.io/tjhop/prometheus-mcp-server:0.17.0
ocitransport: stdio
Details
- Language
- Go
- License
- Apache-2.0
- Released
- Mar 21, 2026
- Last commit
- Apr 10, 2026
- Registry name
- io.github.tjhop/prometheus-mcp-server