Prometheus Connector for AI agents.

Q: Does this Connector require admin rights to work?

Most query tools do not, but specific actions like deleting series or cleaning tombstones do require admin API access.

Q: What is the difference between query and queryrange?

The query tool gives you a snapshot at a single point in time, while queryrange shows you data over a window of time.

Q: Can I use this to clean up my Prometheus storage?

Yes, you can use the admin tools to delete specific series or clean tombstones to help manage your disk space.

Q: Can I run a PromQL query to get the current value of a metric?

Yes. Use the query tool to evaluate any PromQL expression at a single point in time. This is perfect for checking current CPU usage, memory levels, or error rates.

14 live capabilities

Query your infrastructure metrics and run PromQL directly from your chat.

Live agent request Prometheus / Connector

Waiting for input…

AI Agent

Why people use Prometheus

Prometheus for Faster Infrastructure Troubleshooting

This Prometheus MCP lets you skip the manual search. You just tell your agent what's wrong, and it pulls the data for you. You get a clear summary of the problem instead of a sea of confusing graphs.

What Vinkius changes

You get a conversational interface for your entire Prometheus monitoring stack.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Incident Response

An SRE asks why a pod is crashing.
Real-world use case 02

Capacity Planning

A developer needs to see the last 24 hours of CPU usage.
Real-world use case 03

Metric Discovery

A new team member wants to know which labels are available for the web service.

Complete set · 14capabilities

The complete Prometheus capability set.

These are the exact actions your AI can choose when you ask it to work with Prometheus.

Capability set01 / 04

01—04

4 capabilities in this set.

Part of 14 available through Prometheus.

01 Capability
Get status flags
Lists all the configured flag values for your current Prometheus instance.
02 Capability
Get status runtimeinfo
Shows the current runtime information to help you see how the system is behaving.
03 Capability
Get status tsdb
Provides TSDB cardinality statistics to help you monitor your storage health.
04 Capability
Create snapshot
Creates a snapshot of all current data (requires admin API enabled).

Capability set02 / 04

05—08

4 capabilities in this set.

Part of 14 available through Prometheus.

05 Capability
Get status buildinfo
Shows the version and build details of your Prometheus instance.
06 Capability
Get status config
Pulls the current Prometheus configuration in YAML format so you can check your settings.
07 Capability
Get label values
Fetches all possible values for a specific label to help you filter your queries.
08 Capability
Get labels
Lists all available label names across your environment for easier discovery.

Capability set03 / 04

09—11

3 capabilities in this set.

Part of 14 available through Prometheus.

09 Capability
Get metadata
Retrieves metadata for specific metrics to show you units, types, and help text.
10 Capability
Query range
Runs a PromQL expression over a specific time window to see historical trends.
11 Capability
Query
Executes a PromQL expression at a single point in time for an instant status check.

Capability set04 / 04

12—14

3 capabilities in this set.

Part of 14 available through Prometheus.

12 Capability
Find series
Searches for time series that match your specific label selectors.
13 Capability
Clean tombstones
Removes deleted data from the disk to save space (requires admin API enabled).
14 Capability
Delete series
Deletes specific series within a time range to manage your data (requires admin API enabled).

Set up in minutes

One URL. Then ask Prometheus to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Prometheus from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_Z29iBDtEqGksZbbpEnduZ85NzRcrHrhZ5gOCKpq1/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Prometheus, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Prometheus for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_Z29iBDtEqGksZbbpEnduZ85NzRcrHrhZ5gOCKpq1/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Prometheus URL.
Step 03

Save and start

Save the connection and enable Prometheus in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "prometheus": {
      "url": "https://edge.vinkius.com/vk_preview_Z29iBDtEqGksZbbpEnduZ85NzRcrHrhZ5gOCKpq1/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Prometheus

Open Agent mode in chat and ask: "Using Prometheus, help me...". 14 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "prometheus": {
      "url": "https://edge.vinkius.com/vk_preview_Z29iBDtEqGksZbbpEnduZ85NzRcrHrhZ5gOCKpq1/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Prometheus

Ask Copilot: "Using Prometheus, help me...". 14 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "prometheus": {
      "url": "https://edge.vinkius.com/vk_preview_Z29iBDtEqGksZbbpEnduZ85NzRcrHrhZ5gOCKpq1/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Prometheus

Open Cascade and ask: "Using Prometheus, help me...". 14 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "prometheus": {
      "url": "https://edge.vinkius.com/vk_preview_Z29iBDtEqGksZbbpEnduZ85NzRcrHrhZ5gOCKpq1/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Prometheus

Ask Cline: "Using Prometheus, help me...". 14 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add prometheus --transport http "https://edge.vinkius.com/vk_preview_Z29iBDtEqGksZbbpEnduZ85NzRcrHrhZ5gOCKpq1/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Prometheus

Ask Claude: "Using Prometheus, show me...". 14 tools are ready

Where the request belongs

Work Prometheus can move forward.

Built around the request

The SRE who's tired of manual dashboard hunting at 3am or the backend dev who needs to check resource usage without leaving their IDE.

SRE

Troubleshoots production incidents by asking the agent to find specific spikes or errors in the metrics.

Backend Developer

Checks service performance and memory usage during a local dev session to catch regressions early.

Platform Engineer

Audits monitoring configurations and cleans up old data to keep the TSDB healthy.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 11 capabilities

Datadog

Monitor applications via Datadog. query performance metrics, search logs, and list active monitors directly from any AI agent.

View Connector

02 10 capabilities

New Relic

Monitor and query your entire stack via New Relic NerdGraph. track entities, NRQL, and alerts directly from your AI agent.

View Connector

03 4 capabilities

Grafana

Manage observability via Grafana. search and inspect dashboards, monitor alerts, and handle data sources directly from any AI agent.

View Connector

04 10 capabilities

ncScale

Monitor and observe your no-code stack via ncScale. track logs, alerts, and tickets directly from your AI agent.

View Connector

05 5 capabilities

SigNoz (Datadog Alternative)

Monitor infrastructure and manage alert rules via SigNoz. list, create, and update observability alerts directly from your AI agent.

View Connector

06 10 capabilities

Better Stack

Monitor uptime and incidents via Better Stack. list monitors, heartbeats, and on-call schedules directly from any AI agent.

View Connector

Bring your own AI

Change the model, client or framework. Keep Prometheus connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Prometheus.

The practical details behind the request, access and result.

Can I use the Prometheus MCP with Claude?

Yes, you can connect this Connector to Claude or any other MCP-compatible client like Cursor or Windsurf to query your metrics.

Does this Connector require admin rights to work?

Most query capabilities do not, but specific actions like deleting series or cleaning tombstones do require admin API access.

How do I connect my Prometheus instance to the Connector?

You just need to provide your Prometheus Server URL and an optional auth token in the setup configuration.

Can it run complex PromQL queries?

Yes, the agent can evaluate complex PromQL expressions for both real-time status and historical range queries.

Is my monitoring data safe when using this Connector?

The Connector only executes the specific queries your agent requests to fetch the data you ask for.

What is the difference between query and query_range?

The query capability gives you a snapshot at a single point in time, while query_range shows you data over a window of time.

Can I use this to clean up my Prometheus storage?

Yes, you can use the admin capabilities to delete specific series or clean tombstones to help manage your disk space.

Can I run a PromQL query to get the current value of a metric?

Yes. Use the query capability to evaluate any PromQL expression at a single point in time. This is perfect for checking current CPU usage, memory levels, or error rates.

How do I see how a metric has changed over the last hour?

Use the query_range capability. You can specify the start and end timestamps along with a step duration to retrieve historical data points for graphing or trend analysis.

Can I perform administrative tasks like creating backups?

Yes, if your Prometheus server has the Admin API enabled (--web.enable-admin-api), you can use the create_snapshot capability to create a snapshot of all current data on disk.

One connection away

Give your agent a direct line to Prometheus.

Connect Prometheus once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Prometheus for Faster Infrastructure Troubleshooting

You get a conversational interface for your entire Prometheus monitoring stack.

Incident Response

Capacity Planning

Metric Discovery

Get status flags

Get status runtimeinfo

Get status tsdb

Create snapshot

Get status buildinfo

Get status config

Get label values

Get labels

Get metadata

Query range

Query

Find series

Clean tombstones

Delete series

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Prometheus

Create MCP config

Add the server config

Enable Agent mode

Start using Prometheus

Open MCP Settings

Add the server

Save and reload

Start using Prometheus

Open Cline MCP Settings

Add remote server

Enable the server

Start using Prometheus

Install Claude Code

Add the Connector

Verify the connection

Start using Prometheus

SRE

Backend Developer

Platform Engineer

Datadog

New Relic

Grafana

ncScale

SigNoz (Datadog Alternative)

Better Stack

Give your agent a direct line to Prometheus.