MCP server
Prometheus MCP server
Search dashboards, query Prometheus and Loki, and manage incidents and alerts.
★ 3.6kpushed 2026-10-23Apache-2.0https://mcp.grafana.com/mcpGrafana Labs on DevHunt
Needs GRAFANA_URL (replace the ... with your value).
The URL also takes X-Grafana-URL as a header (see its docs), for clients or setups without OAuth sign-in.
Run in a terminal, then /mcp inside Claude Code to sign in. Add --scope project to share it via .mcp.json. docs
claude mcp add --transport http grafana https://mcp.grafana.com/mcp
Customize > Connectors > Add > Add custom connector, paste this URL and sign in. It syncs to Claude Desktop and mobile. docs
https://mcp.grafana.com/mcp
The free plan allows one custom connector. On Team and Enterprise an owner adds it under Organization settings > Connectors.
chatgpt.com/plugins > + > Add custom MCP server, paste the URL, set up sign-in and create it as a plugin. Then @-mention it in a chat. docs
https://mcp.grafana.com/mcp
Workspace admins can turn custom MCP plugins off.
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"grafana": {
"url": "https://mcp.grafana.com/mcp"
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"grafana": {
"type": "http",
"url": "https://mcp.grafana.com/mcp"
}
}
}Run codex mcp add grafana --url https://mcp.grafana.com/mcp (then codex mcp login grafana), or add this to ~/.codex/config.toml. The CLI, IDE extension and Codex app share it. docs
[mcp_servers.grafana] url = "https://mcp.grafana.com/mcp"
Run in a terminal (-s user adds it for all projects), then /mcp auth to sign in. In ~/.gemini/settings.json the key is httpUrl. docs
gemini mcp add -s user --transport http grafana https://mcp.grafana.com/mcp
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add --transport http grafana https://mcp.grafana.com/mcp
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"grafana": {
"serverUrl": "https://mcp.grafana.com/mcp"
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"grafana": {
"url": "https://mcp.grafana.com/mcp"
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). Sign in with opencode mcp auth grafana. docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"grafana": {
"type": "remote",
"url": "https://mcp.grafana.com/mcp",
"enabled": true
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"grafana": {
"url": "https://mcp.grafana.com/mcp"
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"grafana": {
"type": "streamableHttp",
"url": "https://mcp.grafana.com/mcp"
}
}
}Run PromQL queries and explore metrics and targets in a Prometheus server.
★ 519pushed 2026-10-19MIT
Needs PROMETHEUS_URL (replace the ... with your value).
Run in a terminal. Everything after -- is the command that starts the server. docs
claude mcp add --transport stdio --env PROMETHEUS_URL=... prometheus -- docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server
Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"env": {
"PROMETHEUS_URL": "..."
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"env": {
"PROMETHEUS_URL": "..."
}
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"prometheus": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"env": {
"PROMETHEUS_URL": "..."
}
}
}
}Run codex mcp add --env PROMETHEUS_URL=... prometheus -- docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server, or add this to ~/.codex/config.toml. docs
[mcp_servers.prometheus] command = "docker" args = ["run", "-i", "--rm", "-e", "PROMETHEUS_URL", "ghcr.io/pab1it0/prometheus-mcp-server"] [mcp_servers.prometheus.env] PROMETHEUS_URL = "..."
Run in a terminal (-s user adds it for all projects; the default is this project). docs
gemini mcp add -s user -e PROMETHEUS_URL=... prometheus docker -- run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add --env PROMETHEUS_URL=... prometheus -- docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"env": {
"PROMETHEUS_URL": "..."
}
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"env": {
"PROMETHEUS_URL": "..."
}
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"prometheus": {
"type": "local",
"command": [
"docker",
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"enabled": true,
"environment": {
"PROMETHEUS_URL": "..."
}
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"env": {
"PROMETHEUS_URL": "..."
}
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"env": {
"PROMETHEUS_URL": "..."
}
}
}
}Agent skills for Prometheus
The MCP server gives the agent Prometheus's tools; a skill teaches it how to use Prometheus well. Install with the skills CLI or see each skill's page for Claude Code, Codex, Copilot and Cursor.
- PromQLGrafana Labs
Writes, checks and speeds up PromQL queries for Prometheus and Grafana metrics.
npx skills add grafana/skills --skill promql
Which one to pick
- Start with Grafana: it's maintained by Grafana Labs and follows its API.
- A remote server (Grafana) needs no install and signs you in with OAuth. It's also the only kind ChatGPT and claude.ai can use.
- A local server (Grafana and Prometheus) runs on your machine with an API key or token, and works offline from the vendor's hosting.
FAQ
Is there an official Prometheus MCP server?+
Yes: Grafana, maintained by Grafana Labs. There is also 1 community server: Prometheus.
How do I connect Prometheus to Claude?+
In Claude Code run: claude mcp add --transport http grafana https://mcp.grafana.com/mcp, then /mcp to sign in. In Claude Desktop or claude.ai, go to Customize > Connectors > Add > Add custom connector and paste https://mcp.grafana.com/mcp.
How do I use the Prometheus MCP server in Cursor or VS Code?+
Open the Cursor or VS Code tab on the server above: it has the exact mcp.json entry and a one-click install link. The same server also works in Claude Code, Claude Desktop / claude.ai, ChatGPT, Cursor, VS Code and Codex.
Can I use the Prometheus MCP server in ChatGPT?+
ChatGPT connects to remote MCP servers only. Grafana has a hosted URL: at chatgpt.com/plugins choose + > Add custom MCP server, paste the URL and create it as a plugin.
Is it safe to give an AI agent access to Prometheus?+
Start with the official server, a read-only or test account and approval prompts on for anything that writes. Content the agent reads from Prometheus (tickets, messages, pages) can carry prompt-injection instructions, so don't auto-approve actions.
All monitoring & observability MCP servers · Agent skills · How MCP setup works in each client
MCP servers for similar apps: Amplitude · Axiom · Cloud Logging · Cloud Monitoring · Datadog · Dynatrace · Google Ads · Google Analytics · Grafana · Honeycomb · LangChain · LangSmith · Logfire · Loki · Meta Ads · Mixpanel · Netdata · New Relic · OneUptime · OpenStatus · PagerDuty · Pendo · PostHog · Rootly