Grafana MCP Server (official)
Capped at 70: no passing tool call yet; the tests add up to 100. Why scores are capped
Test points add up to 100; the score is capped at 70 until a tool call passes. Not a quality or security rating. Methodology
Test points before the cap (100/100)
- Install20/20
- Handshake30/30
- Maintenance25/25
- Docs15/15
- License10/10
Transport (tested 2026-10-28): stdio
Score 70/100 · Tools 79 · Token cost ~20,791 · Compare · Last tested 2026-10-28 · Version tested 2.1.1 · Package grafana/mcp-grafana · Repo grafana/mcp-grafana
Summary: Grafana MCP Server (official) completed an MCP handshake without credentials and exposed 79 tools.
Evidence summary
- Handshake
- pass
- Tools listed
- 79
- Context cost
- 20,791 model-visible tokens (name, description, inputSchema; tiktoken cl100k_base)
Extra payload (sent by the server, usually not read by the model): 4,323 tokens; raw tools/list total 25,114. Clients differ in what they forward. ranking · add up your servers' context cost - API key
- Needs a key
- Tested
- 2026-10-28
Test results
| Test | Result | Points | Evidence |
|---|---|---|---|
| install | pass | 20 | download mcp-grafana_Linux_x86_64.tar.gz from GitHub release v2.1.1 (grafana/mcp-grafana, published 2026-10-20), sha256 fba3a5294fa07218dbf59944c75ca890ce9c59384bff1bb43cd28d63b0521bec matched mcp-grafana_2.1.1_checksums.txt, extract (prebuilt binary, Linux) succeeded in 1s. |
| handshake | pass | 30 | MCP initialize + tools/list over stdio succeeded with no credentials; 79 tools listed in 0.0s. |
| maintenance | pass | 25 | Repo pushed 0 days before test; 3,621 GitHub stars. |
| docs | pass | 15 | README over 3,000 chars; install instructions present; mcpServers config example present. Automated check of the package's own README (README.md from repo grafana/mcp-grafana main (raw.githubusercontent.com, 2026-10-28); release tarball also ships README.md, LICENSE and CHANGELOG.md). |
| license | pass | 10 | Apache-2.0 (OSI-approved). |
Local-model readiness
Schema context cost: ~20,791 tokens for 79 tools (94,629 bytes) · about 254% of an 8k context. Method: tiktoken cl100k_base over compact JSON of name+description+inputSchema (approximate).
Small-model friendly (schema heuristic, not a model result): unknown.
Small-model task runs: Not yet tested.
What we tested and what we didn't
Tested on 2026-10-28
- Install from the registry
- We connected with no credentials and asked for its tool list: it listed 79 tools (Method details: MCP
initializethentools/list) - Maintenance signals (last push, archived/deprecated status)
- Docs (README length, install and config example)
- License (OSI-approved or not)
- Tool-schema token cost (estimate)
Not tested
- Security: not audited (no code review, no permission or data-flow analysis)
- Real tasks (no functional task runs yet)
- Behaviour with real credentials or a real account
- Performance, rate limits or load
- Correctness of results beyond the listed tasks
Methodology: how we test. A high score means it installs and responds, not that it is safe to give it access to your data.
Known security issues
Not yet checked.
Monthly roundup: MCP security issues, October 2026.
Tool list changes
Baseline recorded from the 2026-10-28 test run; changes appear after the next test.
Snapshot hash (fingerprint of the tool list)
8cfdccf868a2: SHA-256 of the canonical tool names, descriptions and input schemas. If it changes, the tool list changed.
Raw test record (JSON)
{
"name": "grafana/mcp-grafana",
"version": "2.1.1",
"registry": "github-release",
"status": "working",
"tested": "2026-10-28",
"tools_count": 79,
"tools_schema_tokens_est": 20791,
"deprecated": false,
"archived": false,
"tests": {
"install": [
"pass",
20,
"`download mcp-grafana_Linux_x86_64.tar.gz from GitHub release v2.1.1 (grafana/mcp-grafana, published 2026-10-20), sha256 fba3a5294fa07218dbf59944c75ca890ce9c59384bff1bb43cd28d63b0521bec matched mcp-grafana_2.1.1_checksums.txt, extract` (prebuilt binary, Linux) succeeded in 1s."
],
"handshake": [
"pass",
30,
"MCP `initialize` + `tools/list` over stdio succeeded with no credentials; 79 tools listed in 0.0s."
],
"maintenance": [
"pass",
25,
"Repo pushed 0 days before test; 3,621 GitHub stars."
],
"docs": [
"pass",
15,
"README over 3,000 chars; install instructions present; `mcpServers` config example present. Automated check of the package's own README (README.md from repo grafana/mcp-grafana main (raw.githubusercontent.com, 2026-10-28); release tarball also ships README.md, LICENSE and CHANGELOG.md)."
],
"license": [
"pass",
10,
"Apache-2.0 (OSI-approved)."
]
}
}Install
mcp-grafana
Tools listed
add_activity_to_incident, alerting_manage_routing, alerting_routing_write, alerting_rules_read, alerting_rules_write, alerting_silences_read, alerting_silences_write, analyze_loki_labels, check_datasources_health, create_annotation, create_datasource, create_folder, create_incident, create_snapshot, delete_annotation, delete_snapshot, diff_tempo_traces, generate_deeplink, get_alert_group, get_annotation_tags, get_annotations, get_assertions, get_current_oncall_users, get_dashboard_by_uid, get_dashboard_panel_queries, get_dashboard_property, get_dashboard_summary, get_datasource, get_doc, get_incident, get_oncall_shift, get_panel_image, get_plugin, get_snapshot, get_tempo_trace, get_tempo_traceql_docs, grafana_api_request, install_plugin, list_alert_groups, list_dashboard_versions
Quick config
{
"mcpServers": {
"grafana-mcp-server-official": {
"command": "mcp-grafana",
"args": [],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}
}
}
}Environment: set GRAFANA_URL and GRAFANA_SERVICE_ACCOUNT_TOKEN (placeholders in env; replace them). grafana/mcp-grafana README.md (main, fetched 2026-10-28): 'If using the binary' and 'If using Docker' mcpServers examples set GRAFANA_URL (http://localhost:3000 or https://myinstance.grafana.net for Grafana Cloud) and GRAFANA_SERVICE_ACCOUNT_TOKEN (username/password via GRAFANA_USERNAME/GRAFANA_PASSWORD is the documented alternative). Placeholders only; our handshake ran without them. Source.
Docker config
{
"mcpServers": {
"grafana-mcp-server-official": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"GRAFANA_URL",
"-e",
"GRAFANA_SERVICE_ACCOUNT_TOKEN",
"grafana/mcp-grafana",
"-t",
"stdio"
],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}
}
}
}Add to config Opens the config generator with this server selected.
Setup
Env vars required for real use (per its README): GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN
- Install. Run
download mcp-grafana_Linux_x86_64.tar.gz from GitHub release v2.1.1 (grafana/mcp-grafana, published 2026-10-20), sha256 fba3a5294fa07218dbf59944c75ca890ce9c59384bff1bb43cd28d63b0521bec matched mcp-grafana_2.1.1_checksums.txt, extract(prebuilt binary). This is the exact command we ran on 2026-10-28. - Configure. Add the mcpServers entry below to your MCP client config and set GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN.
- Verify. Restart the client and check that tools/list returns tools (79 in our test).
{
"mcpServers": {
"grafana-mcp-server-official": {
"command": "mcp-grafana",
"args": [],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}
}
}
}Docker alternative: docker run --rm -i -e GRAFANA_URL=http://localhost:3000 -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> grafana/mcp-grafana -t stdio
{
"mcpServers": {
"grafana-mcp-server-official": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"GRAFANA_URL",
"-e",
"GRAFANA_SERVICE_ACCOUNT_TOKEN",
"grafana/mcp-grafana",
"-t",
"stdio"
],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}
}
}
}Test history
No dated events yet.
FAQ
Is Grafana MCP Server (official) deprecated?
No. grafana/mcp-grafana was not deprecated or archived when we last tested it on 2026-10-28.
What replaces Grafana MCP Server (official)?
Nothing; Grafana MCP Server (official) is not deprecated as of 2026-10-28.
Does Grafana MCP Server (official) need an API key?
The handshake works without a key; real use needs GRAFANA_URL and GRAFANA_SERVICE_ACCOUNT_TOKEN.
Embed the badge
Every tested server gets a free embeddable badge. It shows the current score and test date and expires after 90 days. Testing is free; payment never changes a score.