A Go-based MCP server exposing Prometheus query and metadata APIs via Model Context Protocol.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for yshngg/pmcp, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Overview
Use cases
Query Prometheus metrics using PromQL expressions
Retrieve Prometheus metadata such as label names and series information
Perform Prometheus TSDB administrative tasks like snapshots and series deletion
Monitor Prometheus server health and runtime information via MCP
Integrate Prometheus data into AI agents or MCP-compatible clients
Key features
Supports instant and range PromQL queries
Exposes metadata queries for labels, series, targets, alerts, and rules
Provides TSDB admin operations including snapshot, delete series, and tombstone cleanup
Offers management endpoints for health, readiness, reload, and quit
Configurable transport over stdio or HTTP with optional bearer token authentication
URI-addressable Prometheus resources under prom:/// scheme
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Pmcp.
Extracted Tool Capabilities
Supports instant and range PromQL queries
Exposes metadata queries for labels, series, targets, alerts, and rules
Provides TSDB admin operations including snapshot, delete series, and tombstone cleanup
Offers management endpoints for health, readiness, reload, and quit
Configurable transport over stdio or HTTP with optional bearer token authentication
URI-addressable Prometheus resources under prom:/// scheme
Documentation Overview
Prometheus MCP Server
A Go-based MCP server that exposes Prometheus query capabilities via the Model Context Protocol.
Installation
Or pull the Docker image:
Usage
Flags
| Flag | Default | Description |
|---|---|---|
-prom-addr | http://localhost:9090 | Prometheus server URL |
-mcp-addr | localhost:8080 | MCP server listen address |
-transport | stdio | stdio or http |
-auth-token | `` | Bearer token for MCP endpoint authentication (optional) |
-version | Print version |
Environment Variables
All flags can be set via environment variables: PROM_ADDR, MCP_ADDR, TRANSPORT, AUTH_TOKEN.
MCP Client Configuration
Add the following config to your MCP client:
[!NOTE] Install the binary via
go install github.com/yshngg/prometheus-mcp-server@latestor pull the Docker image withdocker pull ghcr.io/yshngg/prometheus-mcp-server:latest.
If you don't have the binary installed, use Docker:
Client-specific configuration
Claude Desktop
Add to claude_desktop_config.json:
With Docker:
OpenCode
Add to opencode.json (guide):
HTTP Transport
Run the server with HTTP transport:
Then configure your client to use http://localhost:8080/mcp.
For authenticated access, set AUTH_TOKEN:
Your client must then include Authorization: Bearer my-token in requests to /mcp.
Tools
Expression: instant_query, range_query
Metadata: find_series_by_labels, list_label_names, list_label_values, target_metadata_query, metric_metadata_query
Discovery: target_discovery, alert_query, rule_query, alertmanager_discovery
TSDB Admin: tsdb_snapshot, delete_series, clean_tombstones
Management: health_check, readiness_check, reload, quit
Resources
The server exposes Prometheus data as URI-addressable resources under the prom:/// scheme:
| URI | Description |
|---|---|
prom:///config | Currently loaded configuration (YAML) |
prom:///flags | Command-line flag values |
prom:///runtime-info | Runtime information |
prom:///build-info | Build information |
prom:///tsdb-stats | TSDB cardinality statistics |
prom:///wal-replay-stats | WAL replay state |
Resource Templates
URI templates for dynamic data access:
| Template | Description |
|---|---|
prom:///api/v1/query?query={promql} | Instant PromQL query result |
prom:///api/v1/label/{name}/values | Label values for a given label name |
Prompts
| Name | Arguments | Description |
|---|---|---|
all-available-metrics | prefix (optional) | Lists all metric names in the Prometheus instance |
License
Apache License 2.0
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
4
Stargazers on the source repository.
Last commit
4d ago
Most recent push to the default branch.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Pmcp
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/yshngg-pmcp)HTML Embed
<a href="https://allmcps.com/mcp/yshngg-pmcp"><img src="https://allmcps.com/api/badge/yshngg-pmcp?style=directory" alt="Pmcp on AllMCPs" /></a>