MCP.so
Sign In

prometheus-mcp-server

@weetime

Repository

About prometheus-mcp-server

No overview available yet

Config

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

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

Tools

No tools detected

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.

FAQ from prometheus-mcp-server

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.

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.

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.

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).

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.

Frequently asked questions

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`.

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`.

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.

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).

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

Basic information

Category

Developer Tools

Transports

stdio

Author

weetime

More Developer Tools MCP servers

ZeroBeacon — 1000-Tool Collision-Proof Commerce Router

DavidFox998

ZeroBeacon.ai — Collision-proof commerce router for AI agents. 1000 MCP tools: commerce, trust, billing, sovereign ID + everyday tools. LIVE.

Apiosk

obcraft

AI-native payments for tools and APIs. Discover, pay for, execute, and publish monetized APIs directly from your agent, settled per call in USDC over x402, through the Model Context Protocol. payments · finance · x402 ·

Skycloak

Manage your Skycloak-hosted Keycloak: clusters, realms, apps, SSO and users, from any MCP client.

Routebase

Routebase

Routebase keeps your API's design, docs, contract tests, mocks and monitoring in one living OpenAPI spec so they can't drift apart. Agents work on that same source of truth, under your team's permissions.

LocalCan

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

82