Back
Marketplace/Grafana

TL;DR

Grafana is a Monitoring MCP server that lets Claude Code, Cursor, Windsurf and any MCP-compatible AI agent dashboard and observability platform. Install in 1 minute with mcpizy install grafana.

📊

Grafana

Verified 6 tools

Monitoring

Last updated May 30, 2026 · By MCPizy team

Dashboard and observability platform

Official homepage

Install Grafana

Via MCPizy CLI (recommended):
mcpizy install grafana
Or run directly:
npx -y mcp-grafana
View on GitHub

Tools exposed

6 tools available
list_dashboards

List Grafana dashboards

Inputs

  • querystringoptional
get_dashboard

Get a dashboard by UID

Inputs

  • uidstringrequired
query_prometheus

Run a PromQL query

Inputs

  • querystringrequired
  • startstringoptional
  • endstringoptional
query_loki

Query logs via LogQL

Inputs

  • querystringrequired
list_datasources

List configured datasources

list_alerts

List alert rules

Configuration

Works identically across clients. Only the config file path differs.

Claude Code~/.claude.json
{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": [
        "mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "https://grafana.example.com",
        "GRAFANA_API_KEY": "glsa_..."
      }
    }
  }
}
Cursor.cursor/mcp.json
{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": [
        "mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "https://grafana.example.com",
        "GRAFANA_API_KEY": "glsa_..."
      }
    }
  }
}
Windsurf~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": [
        "mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "https://grafana.example.com",
        "GRAFANA_API_KEY": "glsa_..."
      }
    }
  }
}

Authentication setup

  1. 1

    Create a service account token with Viewer role

    Get it GRAFANA_API_KEY
  2. 2

    Set your Grafana URL (cloud or self-hosted)

    Get it GRAFANA_URL

What you can do with Grafana MCP

Paste any of these prompts into Claude Code, Cursor or another MCP-compatible client.

“What's the current CPU usage of my production nodes? Use PromQL.”

Uses: query_prometheus

“Show me 5xx errors from my API in the last 30 minutes via Loki”

Uses: query_loki

“List dashboards tagged `production`”

Uses: list_dashboards

Works with

Claude Code
Claude Desktop
Cursor
Windsurf
VS Code + Copilot
Any MCP Client

More Monitoring MCPs

🔥

Logfire

Access OpenTelemetry traces and metrics via Pydantic Logfire. Debug production issues fast.

🔫

Raygun

Crash reporting and real user monitoring data. Track errors, performance, and user sessions.

9️⃣

Last9

Real-time production context — logs, metrics, traces. SRE intelligence for incident response.

🔥

Prometheus

Query metrics and alerts

Alternatives to Grafana

If Grafana doesn't fit your stack, these Monitoring MCP servers solve similar problems.

📈

New Relic

Application performance monitoring

🚨

PagerDuty

Incident management and on-call

📊

Axiom

Query and analyze logs, traces, and event data in Axiom. Real-time observability at any scale.

Key Takeaways

  • Grafana exposes 6 tools for monitoring workflows in Claude Code, Cursor and Windsurf.
  • Authentication: 2 steps (GRAFANA_API_KEY, GRAFANA_URL).
  • Install in 1 command: mcpizy install grafana — config written to your client automatically.
  • Free and open source (GitHub source linked above) — verified compatible with every MCP client (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + Copilot).
  • Best use case: "What's the current CPU usage of my production nodes? Use PromQL.".

Frequently asked questions

What is the Grafana MCP server?

The Grafana MCP server is an Monitoring Model Context Protocol server that lets Claude Code, Cursor, Windsurf, VS Code with Copilot, and other MCP-compatible AI agents dashboard and observability platform. It exposes Grafana's capabilities as tools the AI can call directly from your editor or CLI.

How do I install Grafana MCP with Claude Code?

The fastest way is the MCPizy CLI: run `mcpizy install grafana` and MCPizy will add the server to your `.claude.json` automatically. You can also install it manually by adding an entry under `mcpServers` in `.claude.json` with the command `npx -y mcp-grafana` and restarting Claude Code.

Is Grafana MCP free?

Yes. The Grafana MCP server is free and open source (see the GitHub repository linked on this page). You may still need a Grafana account or API key to connect the server to the underlying service, but the MCP layer itself has no MCPizy subscription cost.

Does Grafana MCP work with Cursor and Windsurf?

Yes. Any MCP-compatible client works — including Claude Code, Claude Desktop, Cursor (via `.cursor/mcp.json`), Windsurf, VS Code with Copilot Chat, and custom agents built on the MCP SDK. The same install command targets all of them; only the config file path differs.

What can I do with Grafana MCP?

Once installed, your AI agent can dashboard and observability platform directly inside your conversation. Typical use cases include asking Claude Code or Cursor to run Grafana operations, inspect results, chain Grafana with other MCP servers (see our Workflow Recipes), and automate repetitive monitoring tasks without leaving your editor.

Manage all your MCPs in one place

Monitor usage, track costs, and discover new MCPs.

Get Started Free