MCP.so
Sign In

Prometheus MCP Server

@weetime

Basic information

Category

Developer Tools

Transports

stdio

Author

weetime

About Prometheus MCP Server

No overview available yet

Prometheus MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "prometheus-mcp-server-weetime": {
      "command": "npx",
      "args": [
        "prometheus-mcp-server"
      ]
    }
  }
}

Prometheus MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is prometheus-mcp-server?

A TypeScript-based Model Context Protocol (MCP) server that bridges Claude and Prometheus, enabling querying of metrics, series, labels, alerts, rules, and server status via PromQL.

How to use prometheus-mcp-server?

Install globally with npm install -g prometheus-mcp-server or run via npx prometheus-mcp-server. Configure the Prometheus URL using the PROMETHEUS_BASE_URL environment variable (defaults to http://localhost:9090). Add the server to Claude Desktop’s config file (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json) with the appropriate command and env settings.

Key features of prometheus-mcp-server

  • Instant PromQL queries at a specific time
  • Range PromQL queries over a time period
  • Series discovery by label matchers
  • Label name and value exploration
  • Metadata access for metrics
  • Target information from scrape configurations
  • Alerts and recording/alerting rules
  • Prometheus server status information

Use cases of prometheus-mcp-server

  • Query current metric values for dashboards or alerting checks.
  • Retrieve time-series data over a window for analysis or reporting.
  • Discover available series and labels to explore the metric schema.
  • Inspect scrape targets, alerts, and rules for operational monitoring.
  • Get server status to verify Prometheus health and configuration.

Frequently asked questions

1

How do I configure the Prometheus server URL?

Set the `PROMETHEUS_BASE_URL` environment variable to the desired Prometheus HTTP endpoint. The default is `http://localhost:9090`.

2

What functions does prometheus-mcp-server expose?

It provides nine MCP functions: `mcp__instant_query`, `mcp__range_query`, `mcp__get_series`, `mcp__get_label_values`, `mcp__get_metadata`, `mcp__get_targets`, `mcp__get_alerts`, `mcp__get_rules`, and `mcp__get_status`.

3

How can I run prometheus-mcp-server without installing it?

Use npx: `npx prometheus-mcp-server`. You can also set the `PROMETHEUS_BASE_URL` environment variable inline when using npx.

4

What transport does the server use?

It communicates over stdio, as is standard for MCP servers (mentioning stdio in the Debugging section for inspecting and debugging).

5

Are there any runtime dependencies beyond Node.js?

The server is a TypeScript project that compiles to JavaScript; Node.js is required to run it. All dependencies are bundled via npm.

Comments

More Developer Tools MCP servers