Prometheus MCP Server

DevOpsstdio
Repository

MCP server that lets AI assistants query and analyze Prometheus metrics through standardized interfaces. Exposes instant and range PromQL queries, metric and label discovery, and target/health inspection, allowing agents to investigate system performance and troubleshoot incidents using natural language instead of hand-writing PromQL.

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "prometheus": {
      "command": "uvx",
      "args": [
        "prometheus-mcp-server"
      ],
      "env": {
        "PROMETHEUS_URL": "<YOUR_PROMETHEUS_URL>",
        "PROMETHEUS_USERNAME": "<YOUR_PROMETHEUS_USERNAME>",
        "PROMETHEUS_PASSWORD": "<YOUR_PROMETHEUS_PASSWORD>"
      }
    }
  }
}

Tools (3)

execute_query

Execute an instant PromQL query at a single point in time.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "time": {
      "type": "string",
      "description": "Optional RFC3339 or Unix timestamp for the evaluation"
    },
    "query": {
      "type": "string",
      "description": "PromQL expression to evaluate"
    }
  }
}

execute_range_query

Execute a PromQL query over a time range with a fixed step.

{
  "type": "object",
  "required": [
    "query",
    "start",
    "end",
    "step"
  ],
  "properties": {
    "end": {
      "type": "string",
      "description": "End timestamp (RFC3339 or Unix)"
    },
    "step": {
      "type": "string",
      "description": "Query resolution step (e.g. 15s, 1m)"
    },
    "query": {
      "type": "string",
      "description": "PromQL expression to evaluate"
    },
    "start": {
      "type": "string",
      "description": "Start timestamp (RFC3339 or Unix)"
    }
  }
}

list_metrics

List available metric names exposed by the Prometheus server.

{
  "type": "object",
  "properties": {}
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server Information

Author
Pavel Shklovsky (@pab1it0)
Repository
https://github.com/pab1it0/prometheus-mcp-server
Stars
0
Last Updated
July 12, 2026