MCPHIVE

Prometheus MCP: Documentation

Updated:

Connection

Locally or in-cluster: the prometheus-mcp binary or image (stdio or HTTP mode) pointed at your Prometheus instance (--prometheus-url). There's no built-in auth — access is controlled by Prometheus itself (basic auth or TLS via a reverse proxy in front of the server).

Tools

  • query — an instant PromQL query.
  • range_query — a time-range query (time series).
  • metric_metadata — a metric's type and description.
  • label_names — available labels for filtering.
  • docs_search — built-in runbooks for common monitoring issues.

Agent flow

"How much memory has the api-gateway pod used over the last 30 minutes?", "which targets are currently down?", "show the types of all metrics prefixed with http_".

Limits

No auth model of its own — if Prometheus is exposed unprotected, the MCP gets the same access. The official server is younger than the community alternative pab1it0/prometheus-mcp-server (505 stars), but has already outgrown it in community attention.

Pricing

Completely free and open source (a CNCF project); you only pay for the infrastructure running your Prometheus.