SERVER

MCP Grafana

Rank #23

io.github.grafana/mcp-grafana

An MCP server giving access to Grafana dashboards, data and more.

38 versions

3,561 GitHub stars

by grafana (3 servers)View repository ↗

First listed

Jan 28, 2025

Last publish date

Oct 10, 2026

PURPOSE

What you can do with MCP Grafana

Grafana's official MCP server gives an agent access to a Grafana instance and its ecosystem: dashboards, datasource queries (Prometheus, Loki, SQL and more), alerting, incidents, on-call, annotations and rendered panels.

Suitable tasks

Search dashboards and read their panels or JSON
Run PromQL, LogQL and SQL queries
Read and manage alert rules and incidents
Look up on-call schedules and shifts
Generate deeplinks and render panel images

CAPABILITIES AND LIMITATIONS

What MCP Grafana can and cannot do

Capabilities

Around 119 tools across 33 categories (Dashboard, Datasources, Prometheus, Loki, SQL, Tempo, CloudWatch, Alerting, OnCall, Annotations, Snapshot, Rendering, Admin and more); each tool documents the RBAC permissions it needs. Categories toggle with --disable-<category> and --enabled-tools, --disable-write gives read-only mode and --disable-query removes every datasource query tool.

Documented tools

search_dashboards
get_dashboard_summary
get_dashboard_property
update_dashboard
query_prometheus
query_loki_logs
query_sql
alerting_rules_read
alerting_rules_write
generate_deeplink
get_panel_image
ask_assistant
grafana_api_request

Limitations

Grafana 9.0+ is needed; datasource tools fail on earlier versions
Several categories (admin, assistant, cloudwatch, graphite, runpanelquery, agento11y) are off by default and must be enabled
Panel rendering needs the Image Renderer plugin; assistant tools need the Grafana Assistant plugin; agent observability is Grafana Cloud only
Over SSE per-request headers do not reach tool calls; use streamable-http for per-caller credentials
Raw-SQL tools are removed in read-only mode, and URL overrides need an allowlist since Grafana auth is not an SSRF defense

REQUIREMENTS

What you need before using MCP Grafana

DeclaredNo credentialsNo credentials declared

The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.

MCP Toplist probed the public endpoint on Oct 10, 2026 and could not complete the MCP handshake (jsonrpc error). Requirements remain unverified.

Declared by mcp.so, last synced Oct 16, 2026. Not independently verified by MCP Toplist.

Runtime: uvx mcp-grafana, Docker image grafana/mcp-grafana, a release binary, go install, or a Helm chart
Credentials: Service account token in GRAFANA_SERVICE_ACCOUNT_TOKEN (or _FILE), with GRAFANA_URL pointing at the instance
Permissions: Per-tool RBAC scopes as listed in the README; the built-in Editor role is the broad shortcut
Also needed: Grafana 9.0 or later; MCP_GRAFANA_SERVER_TOKEN when exposing SSE or streamable-http

Declared in the registry install config

GRAFANA_URL · required
GRAFANA_SERVICE_ACCOUNT_TOKEN · optional
GRAFANA_USERNAME · optional
GRAFANA_PASSWORD · optional
GRAFANA_ORG_ID · optional
GRAFANA_EXTRA_HEADERS · optional
GRAFANA_FORWARD_HEADERS · optional

Hosted endpoint declared as public.

INSTALLATION AND FIRST TASK

Connect MCP Grafana and confirm it works

Create a Grafana service account and token with the permissions the tools you need require
Add the server to your client with command uvx, args ["mcp-grafana"], and GRAFANA_URL plus GRAFANA_SERVICE_ACCOUNT_TOKEN in env
Or run docker run --rm -i -e GRAFANA_URL=... -e GRAFANA_SERVICE_ACCOUNT_TOKEN=... grafana/mcp-grafana -t stdio
Trim exposure with --disable-write, --disable-query or --disable-<category>

Remote · HTTP

claude mcp add --transport http mcp-grafana https://mcp.grafana.com/mcp

Docker image

claude mcp add mcp-grafana -e "GRAFANA_URL=<your GRAFANA_URL>" -e "GRAFANA_SERVICE_ACCOUNT_TOKEN=<your GRAFANA_SERVICE_ACCOUNT_TOKEN>" -e "GRAFANA_USERNAME=<your GRAFANA_USERNAME>" -e "GRAFANA_PASSWORD=<your GRAFANA_PASSWORD>" -e "GRAFANA_ORG_ID=<your GRAFANA_ORG_ID>" -e "GRAFANA_EXTRA_HEADERS=<your GRAFANA_EXTRA_HEADERS>" -e "GRAFANA_FORWARD_HEADERS=<your GRAFANA_FORWARD_HEADERS>" -- docker run -i --rm docker.io/grafana/mcp-grafana:2.0.2

Replace each placeholder with your own value before saving.

Remote · HTTP

[mcp_servers.mcp-grafana]
url = "https://mcp.grafana.com/mcp"

Add to ~/.codex/config.toml.

Docker image

[mcp_servers.mcp-grafana]
command = "docker"
args = ["run", "-i", "--rm", "docker.io/grafana/mcp-grafana:2.0.2"]

[mcp_servers.mcp-grafana.env]
GRAFANA_URL = "<your GRAFANA_URL>"
GRAFANA_SERVICE_ACCOUNT_TOKEN = "<your GRAFANA_SERVICE_ACCOUNT_TOKEN>"
GRAFANA_USERNAME = "<your GRAFANA_USERNAME>"
GRAFANA_PASSWORD = "<your GRAFANA_PASSWORD>"
GRAFANA_ORG_ID = "<your GRAFANA_ORG_ID>"
GRAFANA_EXTRA_HEADERS = "<your GRAFANA_EXTRA_HEADERS>"
GRAFANA_FORWARD_HEADERS = "<your GRAFANA_FORWARD_HEADERS>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Remote · HTTP

https://mcp.grafana.com/mcp

Settings → Connectors → “Add custom connector”, then paste this URL.

Docker image

{
  "mcpServers": {
    "mcp-grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/grafana/mcp-grafana:2.0.2"
      ],
      "env": {
        "GRAFANA_URL": "<your GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your GRAFANA_SERVICE_ACCOUNT_TOKEN>",
        "GRAFANA_USERNAME": "<your GRAFANA_USERNAME>",
        "GRAFANA_PASSWORD": "<your GRAFANA_PASSWORD>",
        "GRAFANA_ORG_ID": "<your GRAFANA_ORG_ID>",
        "GRAFANA_EXTRA_HEADERS": "<your GRAFANA_EXTRA_HEADERS>",
        "GRAFANA_FORWARD_HEADERS": "<your GRAFANA_FORWARD_HEADERS>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Remote · HTTP

{
  "mcpServers": {
    "mcp-grafana": {
      "url": "https://mcp.grafana.com/mcp"
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project).

Docker image

{
  "mcpServers": {
    "mcp-grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/grafana/mcp-grafana:2.0.2"
      ],
      "env": {
        "GRAFANA_URL": "<your GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your GRAFANA_SERVICE_ACCOUNT_TOKEN>",
        "GRAFANA_USERNAME": "<your GRAFANA_USERNAME>",
        "GRAFANA_PASSWORD": "<your GRAFANA_PASSWORD>",
        "GRAFANA_ORG_ID": "<your GRAFANA_ORG_ID>",
        "GRAFANA_EXTRA_HEADERS": "<your GRAFANA_EXTRA_HEADERS>",
        "GRAFANA_FORWARD_HEADERS": "<your GRAFANA_FORWARD_HEADERS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Remote · HTTP

{
  "servers": {
    "mcp-grafana": {
      "type": "http",
      "url": "https://mcp.grafana.com/mcp"
    }
  }
}

Save as .vscode/mcp.json in your workspace.

Docker image

{
  "servers": {
    "mcp-grafana": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/grafana/mcp-grafana:2.0.2"
      ],
      "env": {
        "GRAFANA_URL": "<your GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your GRAFANA_SERVICE_ACCOUNT_TOKEN>",
        "GRAFANA_USERNAME": "<your GRAFANA_USERNAME>",
        "GRAFANA_PASSWORD": "<your GRAFANA_PASSWORD>",
        "GRAFANA_ORG_ID": "<your GRAFANA_ORG_ID>",
        "GRAFANA_EXTRA_HEADERS": "<your GRAFANA_EXTRA_HEADERS>",
        "GRAFANA_FORWARD_HEADERS": "<your GRAFANA_FORWARD_HEADERS>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Remote · HTTP

{
  "mcpServers": {
    "mcp-grafana": {
      "serverUrl": "https://mcp.grafana.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Docker image

{
  "mcpServers": {
    "mcp-grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/grafana/mcp-grafana:2.0.2"
      ],
      "env": {
        "GRAFANA_URL": "<your GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your GRAFANA_SERVICE_ACCOUNT_TOKEN>",
        "GRAFANA_USERNAME": "<your GRAFANA_USERNAME>",
        "GRAFANA_PASSWORD": "<your GRAFANA_PASSWORD>",
        "GRAFANA_ORG_ID": "<your GRAFANA_ORG_ID>",
        "GRAFANA_EXTRA_HEADERS": "<your GRAFANA_EXTRA_HEADERS>",
        "GRAFANA_FORWARD_HEADERS": "<your GRAFANA_FORWARD_HEADERS>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Remote · HTTP

{
  "mcpServers": {
    "mcp-grafana": {
      "url": "https://mcp.grafana.com/mcp"
    }
  }
}

Docker image

{
  "mcpServers": {
    "mcp-grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/grafana/mcp-grafana:2.0.2"
      ],
      "env": {
        "GRAFANA_URL": "<your GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your GRAFANA_SERVICE_ACCOUNT_TOKEN>",
        "GRAFANA_USERNAME": "<your GRAFANA_USERNAME>",
        "GRAFANA_PASSWORD": "<your GRAFANA_PASSWORD>",
        "GRAFANA_ORG_ID": "<your GRAFANA_ORG_ID>",
        "GRAFANA_EXTRA_HEADERS": "<your GRAFANA_EXTRA_HEADERS>",
        "GRAFANA_FORWARD_HEADERS": "<your GRAFANA_FORWARD_HEADERS>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

First successful task

Ask the agent to list dashboards tagged with a tag you know exists.

Expected: The agent calls search_dashboards and returns matching dashboard titles and UIDs, and can build a URL for one with generate_deeplink.

ALTERNATIVES

When to choose another server

Prometheus MCP Server#712
You only need PromQL against Prometheus and have no Grafana.
SigNoz MCP Server#1,034
Your observability stack is SigNoz.
hny-mcp#19,319
Your traces and queries live in Honeycomb.

Other servers by grafana

View all grafana servers →

MAINTENANCE AND EVIDENCE

What changed, and when this was checked

First listed: Jan 28, 2025
Latest version published: Oct 10, 2026
Version history: 38 versions tracked (below)
Requirements evidence: MCP Toplist probed the public endpoint on Oct 10, 2026 and could not complete the MCP handshake (jsonrpc error). Requirements remain unverified.
Profile checked: Oct 9, 2026 against README
Ranking data as of: Oct 16, 2026

Registry sightings

Official MCP ↗listed since Apr 25, 2026 · still listed
PulseMCP ↗listed since Jun 4, 2026 · still listed
mcp.so ↗listed since Jun 4, 2026 · still listed
Glama ↗listed since Jun 4, 2026 · still listed

Do you maintain MCP Grafana? to correct or enrich this profile.

VERSIONS

Available versions (38)

Version	Published
v2.0.2	Oct 10, 2026
v2.0.1	Oct 6, 2026
v2.0.0	Oct 1, 2026
v1.6.3	Sep 30, 2026
v1.6.2	Sep 29, 2026
v1.6.1	Sep 28, 2026
v1.6.0	Sep 25, 2026
v1.5.1	Sep 17, 2026
v1.5.0	Sep 17, 2026
v1.4.2	Sep 14, 2026
v1.4.1	Sep 11, 2026
v1.4.0	Sep 10, 2026
v1.3.0	Aug 28, 2026
v1.2.0	Aug 25, 2026
v1.1.0	Aug 10, 2026
v1.0.0	Jul 28, 2026
v0.17.2	Jul 13, 2026
v0.17.1	Jul 7, 2026
v0.17.0	Jun 23, 2026
v0.16.0	Jun 16, 2026
v0.15.2	Jun 4, 2026
v0.14.0	May 8, 2026
v0.13.1	Apr 30, 2026
v0.13.0	Apr 29, 2026
v0.12.1	Apr 28, 2026
v0.12.0	Apr 23, 2026
v0.11.6	Apr 9, 2026
v0.11.5	Apr 9, 2026
v0.11.4	Apr 2, 2026
v0.11.3	Mar 12, 2026
v0.11.2	Feb 25, 2026
v0.11.1	Feb 24, 2026
v0.11.0	Feb 19, 2026
v0.10.0	Feb 12, 2026
v0.9.0	Jan 28, 2026
v0.7.7	Oct 15, 2025
v0.7.7-rc.3	Oct 15, 2025
0.1.0	Nov 25, 2024

STANDING

#23of 144,396 active serversTop 0.1%

Ranks ahead of 144,373 of 144,396 servers on MCP Toplist.

Recent momentum

+609GitHub stars since Apr 27 (+21%)

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.grafana%2Fmcp-grafana.svg)](https://mcptoplist.com/server/io.github.grafana%2Fmcp-grafana)

HTML

<a href="https://mcptoplist.com/server/io.github.grafana%2Fmcp-grafana"><img src="https://mcptoplist.com/badge/io.github.grafana%2Fmcp-grafana.svg" alt="MCP Toplist: Top 1% of 144,396" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

FAQ

Frequently asked questions

Who maintains MCP Grafana?: MCP Grafana is maintained by grafana, which publishes 3 MCP servers (38 total versions) tracked on MCP Toplist.
Is MCP Grafana listed on the Official MCP Registry?: Yes — MCP Grafana is listed on the Official MCP Registry, alongside PulseMCP, mcp.so and Glama.
How many versions does MCP Grafana have?: MCP Toplist tracks 38 versions of MCP Grafana, most recently published on Oct 10, 2026.
Where can I find the source code for MCP Grafana?: The source code for MCP Grafana is hosted at github.com/grafana/mcp-grafana.

Used in projects

Do you run this server?

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers