# Connect the Grafana MCP server to Unblocked to give AI agents live metrics, logs, and dashboard context

URL: https://getunblocked.com/integrations/grafana/

Unblocked connects to the Grafana Cloud MCP server so AI coding agents can query your Prometheus metrics, Loki logs, dashboards, and incidents live — then its Context Engine reconciles what they find with the code, pull requests, and conversations behind it.

---

## Grafana integration details

- **Category:** Incident Management
- **Live-queried data:** metrics, logs, dashboards
- **Supported products:** Grafana Cloud · Grafana Loki · Grafana Tempo · Grafana Pyroscope · Grafana IRM
- **Works with:** Claude Code, Cursor, Devin, GitHub Copilot, Codex, OpenCode, VS Code — via one MCP server connection
- **Maintained by:** Grafana · verified by Unblocked
- **Content reviewed:** October 20, 2026
- **Website:** <https://grafana.com>

## What the Grafana integration adds

When a panel turns red, a developer has to find the right dashboard, rebuild the PromQL or LogQL behind it, and then guess which change moved the line. An agent working in the editor sees none of that. The Grafana Cloud MCP server exposes dashboards, data sources, metrics, logs, and incidents to AI agents, and Unblocked connects to it once so every agent can ask about your stack without its own Grafana setup.

This is a third-party MCP server: Grafana Labs hosts and maintains it, and Unblocked connects to it as a verified MCP server. Nothing is ingested or indexed — Unblocked runs the read-only queries you allow against your Grafana Cloud stack when a question needs them, so a latency graph or log stream reflects your systems at that moment, not a copy taken earlier.

Wiring Grafana’s MCP server straight into an agent gives it query results without the story behind them. Unblocked’s Context Engine reasons across those results and your other sources — tracing a latency jump on a dashboard panel to the deploy that preceded it, the pull request that changed the query path, and the Slack thread where the regression was first noticed — and returns one cited answer.

Once connected, any MCP-compatible coding agent — Claude Code, Cursor, Devin, GitHub Copilot, Codex — reaches Grafana context through a single Unblocked MCP server connection.

### What you get

- **Live metrics, logs, and dashboards** — Agents run Prometheus and Loki queries, read dashboard summaries, and list incidents against your Grafana Cloud stack as it is now, scoped by your Grafana permissions.
- **One connection for every agent** — Authorize Grafana Cloud in Unblocked once. Claude Code, Cursor, Codex, and GitHub Copilot reach it through the Unblocked MCP server, with no per-agent Grafana configuration.
- **Read-only, tool-level control** — Tools that update dashboards, create incidents, or add annotations are never offered. You pick which read-only Grafana tools Unblocked may call from Settings → Data Sources.
- **Context Engine reasoning** — Grafana results are reconciled with your code, pull requests, tickets, and conversations, so a spike on a panel leads to the change behind it — with citations.

## How to connect Grafana to Unblocked

Prerequisites:

- An Unblocked account (free to start).
- A Grafana Cloud stack with Grafana Assistant available, and the Assistant Cloud MCP User role (Editors and above have it by default) to authorize the OAuth connection.
- An MCP-compatible coding agent (Claude Code, Cursor, Devin, etc.) to use the context in your editor.

### Step 1: Connect Grafana to Unblocked

1. In Unblocked, go to Settings → Data Sources → Connect another data source, and under Incident Management select Grafana.
2. The Grafana MCP server URL is filled in for you. Choose OAuth, click Connect, and sign in to Grafana to authorize Unblocked.
3. Once Unblocked discovers the server’s tools, select the read-only tools it may use and click Save Settings.

### Step 2: Install the Unblocked MCP server

On macOS or Linux, one command auto-detects and configures the supported agents on your machine:

```bash
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
```

On Windows, or when you prefer remote MCP, add the server manually using the configuration below or follow the manual install guide: <https://docs.getunblocked.com/unblocked-mcp/mcp-overview>

Claude Code — add the remote server, then run /mcp in Claude Code, select unblocked, and log in via OAuth:

```bash
claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse
```

Cursor — open View: Open MCP Settings → Add Custom MCP, add the server, then click Connect to authenticate via OAuth:

```json
{
  "mcpServers": {
    "unblocked": {
      "url": "https://getunblocked.com/api/mcpsse"
    }
  }
}
```

Any MCP-compatible client (Devin, Codex, VS Code, Claude Desktop, and others) can connect to the remote server with OAuth: `https://getunblocked.com/api/mcpsse`

## Grafana MCP server tools

Grafana hosts and maintains this MCP server. Unblocked calls only the read-only tools you select, at the moment a question needs them:

- **`search_dashboards`** — Searches dashboards in your Grafana Cloud stack and returns the matching dashboards.
- **`get_dashboard_summary`** — Returns a compact overview of a dashboard — its panels and their queries — without the full dashboard JSON.
- **`query_prometheus`** — Runs a PromQL query against a Prometheus data source and returns the resulting series.
- **`query_loki_logs`** — Runs a LogQL query against a Loki data source and returns the matching log lines.
- **`list_incidents`** — Lists incidents recorded in Grafana Incident, with their status and details.

## Connect Grafana to Claude Code, Cursor, and other AI agents

To give Claude Code, Cursor, GitHub Copilot, Codex, or another MCP-compatible AI coding agent access to Grafana context, connect Grafana to Unblocked and add the single Unblocked MCP server to your agent.

Unblocked acts as the MCP context layer for your Grafana data, searching metrics, logs, and dashboards alongside your other connected sources and returning cited results through these tools:

- **`context_research`** — Researches a question across your connected sources and calls the Grafana tools you selected when metrics, logs, dashboards, or incidents are relevant, returning a synthesized answer with citations.
- **`context_get_urls`** — Fetches the full content behind URLs your agent encounters across connected sources — Jira, Linear, Notion, Confluence, Slack, GitHub, and more.

## Questions to ask an AI agent about Grafana

Questions you (or your agent) can ask Unblocked about your Grafana data:

- "Why did tail latency on the checkout dashboard climb this morning, and which pull request merged right before it?"
- "What do the Loki logs for the payments service show since the last deploy, and has anyone raised it in Slack?"
- "Which Prometheus metrics does the orders service emit, and where in the code are they recorded?"
- "Summarize the open Grafana incidents and link each one to the ticket or PR that is fixing it."

## Grafana integration FAQ

### What is the Grafana MCP server?

The Grafana Cloud MCP server is a remote Model Context Protocol server, hosted and maintained by Grafana Labs, that lets AI agents search dashboards, query Prometheus metrics and Loki logs, and read incidents and on-call data in a Grafana Cloud stack. Unblocked connects to it as a verified MCP server, so every agent reaches it through one Unblocked connection.

### Can Unblocked edit my Grafana dashboards or alert rules?

No. Grafana marks tools such as update_dashboard, create_incident, and create_annotation as write tools, and Unblocked never offers them. Only read-only tools are available for selection.

### Which Grafana data can agents query through Unblocked?

Whatever your Grafana Cloud stack exposes through the read-only tools you select — dashboards and their panel queries, Prometheus metrics, Loki logs, and incidents, among others. Access follows the role-based permissions of the Grafana user who authorized the connection.

### Does this work with self-hosted Grafana?

No. Grafana’s hosted MCP server supports Grafana Cloud stacks only, so the verified connection applies to Grafana Cloud. Self-hosted Grafana isn’t supported by this server.

### Does Unblocked store my Grafana metrics or logs?

No. Nothing from Grafana is ingested or indexed. Unblocked runs the selected queries while it answers a question, so metrics and logs reflect your stack at that moment.

## Related integrations

- [Honeycomb](https://getunblocked.com/integrations/honeycomb/) — Observability data from Honeycomb’s verified MCP server, queried live while Unblocked answers — nothing is ingested or indexed.
- [incident.io](https://getunblocked.com/integrations/incident-io/) — Incidents and response context from incident.io’s verified MCP server, queried live while Unblocked answers — nothing is ingested or indexed.
- [Datadog](https://getunblocked.com/integrations/datadog/) — Incidents, logs, metrics, monitors, and hosts from Datadog — referenced in answers so investigations connect symptoms to recent changes.
- [Slack](https://getunblocked.com/integrations/slack/) — Public and private channels and threads — indexed with access permissions respected, plus in-Slack Q&A by @mentioning Unblocked.

## Get started with Unblocked

- Start a free trial: <https://getunblocked.com/dashboard/get-started>
- Pricing: <https://getunblocked.com/pricing/>
- All integrations: <https://getunblocked.com/integrations/>
