Prometheus MCP Server for Claude CodeGive Claude Code instant access to 14 tools to Clean Tombstones, Create Snapshot, Delete Series, and more
GDPR Free for SubscribersClaude Code is Anthropic's agentic CLI for terminal-first development. Add Prometheus as an MCP server in one command and Claude Code will discover every tool at runtime. ideal for automation pipelines, CI/CD integration, and headless workflows via Vinkius.
Ask AI about this MCP Server for Claude Code
The Prometheus MCP Server for Claude Code is a standout in the Loved By Devs category — giving your AI agent 14 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Gemini# Your Vinkius token. get it at cloud.vinkius.com
claude mcp add prometheus --transport http "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Prometheus and 4,000+ MCP Servers from a single visual interface.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Prometheus MCP Server
Connect your Prometheus instance to any AI agent and transform your observability data into actionable insights through natural conversation.
Claude Code registers Prometheus as an MCP server in a single terminal command. Once connected, Claude Code discovers all 14 tools at runtime and can call them headlessly. ideal for CI/CD pipelines, cron jobs, and automated workflows where Prometheus data drives decisions without human intervention.
What you can do
- Instant & Range Queries — Evaluate complex PromQL expressions for real-time status or historical trends over specific time windows.
- Metric Discovery — Find time series matching specific label selectors and explore available labels and their values across your environment.
- Metadata Inspection — Retrieve detailed metadata about metrics scraped from targets to understand units, types, and help text.
- Admin Operations — Create data snapshots, delete specific series, and clean tombstones (requires admin API enabled).
- System Status — Inspect your Prometheus configuration, flags, and runtime information to ensure your monitoring stack is healthy.
The Prometheus MCP Server exposes 14 tools through the Vinkius. Connect it to Claude Code in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 14 Prometheus tools available for Claude Code
When Claude Code connects to Prometheus through Vinkius, your AI agent gets direct access to every tool listed below — spanning prometheus, promql, metrics, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Clean tombstones on Prometheus
enable-admin-api to be enabled. Remove deleted data from disk
Create snapshot on Prometheus
enable-admin-api to be enabled on the Prometheus server. Create a snapshot of all current data
Delete series on Prometheus
enable-admin-api to be enabled. Delete data for a selection of series in a time range
Find series on Prometheus
Find time series matching label selectors
Get label values on Prometheus
Get all values for a specific label
Get labels on Prometheus
Get a list of all label names
Get metadata on Prometheus
Get metadata about metrics scraped from targets
Get status buildinfo on Prometheus
Get Prometheus build information
Get status config on Prometheus
Get the currently loaded Prometheus configuration (YAML)
Get status flags on Prometheus
Get configured Prometheus flag values
Get status runtimeinfo on Prometheus
Get Prometheus runtime information
Get status tsdb on Prometheus
Get TSDB cardinality statistics
Query on Prometheus
Evaluate a PromQL expression at a single point in time
Query range on Prometheus
Evaluate a PromQL expression over a range of time
Connect Prometheus to Claude Code via MCP
Follow these steps to wire Prometheus into Claude Code. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install Claude Code
npm install -g @anthropic-ai/claude-code if not already installedAdd the MCP Server
Verify the connection
claude mcp to list connected servers, or type /mcp inside a sessionStart using Prometheus
Why Use Claude Code with the Prometheus MCP Server
Claude Code provides unique advantages when paired with Prometheus through the Model Context Protocol.
Single-command setup: `claude mcp add` registers the server instantly. no config files to edit or applications to restart
Terminal-native workflow means MCP tools integrate seamlessly into shell scripts, CI/CD pipelines, and automated DevOps tasks
Claude Code runs headlessly, enabling unattended batch processing using Prometheus tools in cron jobs or deployment scripts
Built by the same team that created the MCP protocol, ensuring first-class compatibility and the fastest adoption of new protocol features
Prometheus + Claude Code Use Cases
Practical scenarios where Claude Code combined with the Prometheus MCP Server delivers measurable value.
CI/CD integration: embed Prometheus tool calls in your deployment pipeline to validate configurations or fetch secrets before shipping
Headless batch processing: schedule Claude Code to query Prometheus nightly and generate reports without human intervention
Shell scripting: pipe Prometheus outputs into other CLI tools for data transformation, filtering, and aggregation
Infrastructure monitoring: run Claude Code in a cron job to query Prometheus status endpoints and alert on anomalies
Example Prompts for Prometheus in Claude Code
Ready-to-use prompts you can give your Claude Code agent to start working with Prometheus immediately.
"Run an instant query for 'up' to see which targets are currently reachable."
"Show me the average CPU usage for the last 30 minutes using query_range."
"What is the metadata for the metric 'http_requests_total'?"
Troubleshooting Prometheus MCP Server with Claude Code
Common issues when connecting Prometheus to Claude Code through Vinkius, and how to resolve them.
Command not found: claude
npm install -g @anthropic-ai/claude-codeConnection timeout
Prometheus + Claude Code FAQ
Common questions about integrating Prometheus MCP Server with Claude Code.
How do I add an MCP server to Claude Code?
claude mcp add --transport http "" in your terminal. Claude Code registers the server and discovers all tools immediately.Can Claude Code run MCP tools in headless mode?
How do I list all connected MCP servers?
claude mcp in your terminal to see all registered servers and their status, or type /mcp inside an active Claude Code session.Explore More MCP Servers
View all →
ORCID
13 toolsAccess and manage ORCID researcher records — search the registry, fetch biographical data, and manage works or affiliations directly.
Lob
9 toolsSend physical mail programmatically with an API for postcards, letters, and checks that integrates into your digital workflows.
Wave Financial
10 toolsManage your accounting via Wave Financial — query businesses, invoices, customers, and transactions directly from any AI agent.
Moodle
12 toolsPower your e-learning environment with the world most flexible open-source LMS for course creation and student management.