prometheus-mcp

Overview

The Prometheus MCP server provides seamless integration between AI assistants and Prometheus monitoring systems. It enables natural language interactions with your monitoring infrastructure by exposing 10 tools across three categories: discovery, info, and query. The server supports both stdio and HTTP transports for maximum compatibility with various MCP clients including VS Code, Cursor, Windsurf, and Claude Desktop.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• prometheus_list_metrics

  List all available Prometheus metrics

  Try:Show me all available metrics in PrometheusTry:List all metrics
• prometheus_metric_metadata

  Get metadata for a specific Prometheus metric

  Try:Get metadata for the http_requests_total metricTry:What's the metadata for cpu_usage_seconds?
• prometheus_list_labels

  List all available Prometheus labels

  Try:Show me all available labelsTry:What labels are available?
• prometheus_label_values

  Get all values for a specific Prometheus label

  Try:What values are available for the environment label?Try:Get all values for the service label
• prometheus_list_targets

  List all Prometheus scrape targets

  Try:Show me all scrape targets and their statusTry:List all targets
• prometheus_scrape_pool_targets

  Get targets for a specific scrape pool

  Try:Show me targets in the production scrape poolTry:Get targets for the monitoring pool
• prometheus_runtime_info

  Get Prometheus runtime information

  Try:Show me Prometheus runtime informationTry:What's the runtime status of Prometheus?
• prometheus_build_info

  Get Prometheus build information

  Try:Get Prometheus build informationTry:What version of Prometheus is running?
• prometheus_query

  Execute an instant Prometheus query

  Try:What's the current CPU usage across all instances?Try:Show me current memory usage
• prometheus_query_range

  Execute a Prometheus range query

  Try:Get memory usage for the last hourTry:Show error rate trend over last 24 hours

Comparable tools

Installation

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp@latest", "stdio"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

FAQ

What Prometheus server version does this MCP support?

The Prometheus MCP server works with any Prometheus instance that exposes the Prometheus API (version 1.0 and later).

Can I use this MCP server with authentication?

Currently, the server only supports basic Prometheus URL access. For authenticated Prometheus instances, you may need to set up a proxy or tunnel.

What transport methods are supported?

The server supports both stdio and HTTP transports, making it compatible with various MCP clients and deployment scenarios.

Compare prometheus-mcp with