Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Observability - official Grafana server

Grafana Cloud MCP server

Remotely hosted MCP server that lets external AI agents query dashboards, metrics, logs, traces, profiles, alerts, incidents and OnCall data in a Grafana Cloud stack. It uses OAuth 2.1 and acts with the signed-in user's Grafana RBAC permissions. Grafana hosts it at https://mcp.grafana.com/mcp with OAuth auth.

Last verified 15 tools2 sources

Install

Terminal
claude mcp add grafana https://mcp.grafana.com/mcp \
  --transport http \
  --header "X-Grafana-URL: https://<your-stack>.grafana.net"
JSON
{
  "mcpServers": {
    "grafana": {
      "url": "https://mcp.grafana.com/mcp",
      "headers": {
        "X-Grafana-URL": "https://<your-stack>.grafana.net"
      }
    }
  }
}

VS Code

JSON
{
  "servers": {
    "grafana": {
      "type": "http",
      "url": "https://mcp.grafana.com/mcp",
      "headers": {
        "X-Grafana-URL": "https://<your-stack>.grafana.net"
      }
    }
  }
}

Tools

search_dashboards
Search for dashboards by query string.
generate_deeplink
Generate deeplink URLs for dashboards, panels, and Explore queries.
get_dashboard_summary
Get a compact summary of a dashboard without the full JSON.
update_dashboard
Create or update a dashboard using full JSON or targeted patch operations (Write).
list_datasources
List all configured data sources.
query_prometheus
Execute PromQL instant or range queries.
query_loki_logs
Execute LogQL queries for log entries or metric values.
query_pyroscope
Query profiles or metrics from Pyroscope.
query_clickhouse
Execute SQL queries against ClickHouse datasources.
query_cloudwatch
Query AWS CloudWatch metrics.
alerting_manage_rules
List, filter, and manage alert rules; create and update with write scope.
list_incidents
List incidents with optional status filtering.
get_current_oncall_users
Get users currently on-call for a schedule.
create_investigation
Start a new Assistant investigation from an external AI agent (Write).
ask_assistant
Send a prompt to Grafana Assistant and get the full reply (Write).

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Grafana Cloud only; self-hosted Grafana users should use the open source mcp-grafana server.
  • Requires Grafana Assistant to be available on the stack with its terms accepted, and the Assistant Cloud MCP User role or grafana-assistant-app.cloud-mcp:access permission (Editor and above by default).
  • Each MCP user counts as an active Grafana Assistant user for billing.
  • SSE is not supported.
  • The X-Grafana-URL header is optional; for multiple stacks use https://mcp.grafana.com/mcp/<your-stack>.grafana.net per entry.
  • Claude Code quick install also documented as: claude mcp add grafana --transport http https://mcp.grafana.com/mcp.
  • The docs page carries no preview or GA label, so status is left unknown.
  • Tempo data source tools are proxied when present.

FAQ

What does the Grafana Cloud MCP server do?

Remotely hosted MCP server that lets external AI agents query dashboards, metrics, logs, traces, profiles, alerts, incidents and OnCall data in a Grafana Cloud stack. It uses OAuth 2.1 and acts with the signed-in user's Grafana RBAC permissions. The vendor documents 15 tools, including search_dashboards, generate_deeplink, get_dashboard_summary and update_dashboard.

How do I add the Grafana Cloud MCP server to Claude Code?

Grafana documents a Claude Code config; copy it from the Claude Code section of this page. Snippets for Cursor and VS Code are there too.

Does the Grafana Cloud MCP server need authentication?

Yes, OAuth. Transport: Streamable HTTP. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 2 Grafana pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.