
Grafana MCP
github.com/grafana/mcp-grafana- Category
- Developer Tools
- Rank
- No. 363Tools index
- Pricing
- Free
- Type
- TOOL
- Use case
- Deployment & Operations
- Interfaces
- MCP
- Builder
- grafana
- GitHub
- 3.5k stars
- Latest release
- v1.5.1
- Date
About
Grafana's official MCP server: search dashboards, query Prometheus and Loki datasources, and investigate incidents from an agent.
What it does
Grafana MCP gives an AI client a controlled bridge into an existing Grafana deployment. The client can inspect and change dashboards, work with alerting and incidents, generate links, and reach several configured data sources. Administrators choose tool groups, credentials, permissions, and transport. Compact dashboard summaries, targeted property reads, and patches help avoid sending bulky dashboard documents through the model.
Why it's ranked here
This is a substantial operational integration, not a thin query wrapper. Its scope spans dashboards, data sources, alerting, incidents, OnCall, Sift, navigation, annotations, rendering, and agent observability. It also addresses practical deployment concerns through multiple transports, TLS, granular Grafana permissions, read-only operation, and selective tool activation. The main qualification is complexity: many valuable integrations are optional, product-specific, or restricted to Grafana Cloud.
What's good
The strongest design choice is context control. Agents can request dashboard summaries or selected properties instead of full JSON, and targeted patches avoid round-tripping entire dashboards. Queries pass through Grafana data sources, so Snowflake credentials, for example, remain in Grafana rather than reaching the MCP server. Operators can disable writes, expose only chosen tool groups, apply fine-grained Grafana permissions, and choose local or multi-client transports.
Tradeoffs
Full functionality requires Grafana 9.0 or later, and older installations may lack required data-source endpoints. The open source option must be installed, authenticated, configured, and operated by the user. Many data-source integrations, panel execution, query examples, and agent observability start disabled. Some capabilities require particular Grafana products, plugins, roles, or Grafana Cloud. Full dashboard reads and writes can consume substantial model context.
How to use it well
It fits platform, reliability, and operations teams that already center investigations and configuration in Grafana. Start read-only with least-privilege service-account permissions and a small enabled tool set. Prefer summaries and selected properties during discovery, then use targeted patches for changes. Add specialized data sources only when a workflow needs them. This self-managed server does not replace Grafana's separately documented hosted Cloud MCP option.
Technical notes+
The module in go.mod targets Go 1.26.3 and depends on github.com/mark3labs/mcp-go plus Grafana, Prometheus, OpenTelemetry, JSONPath, and OpenAPI packages. Makefile builds ./cmd/mcp-grafana, provides stdio, SSE, and streamable-http run targets, and separates unit, integration, cloud, and Python end-to-end tests. README.md documents uvx, Docker, binary, and Helm installation surfaces. docs/troubleshooting.md covers service-account authentication, RBAC failures, TLS, Docker networking, debug mode, and the /sse and /mcp endpoints.
Observed
- License
- Apache License, Version 2.0
- Primary language
- Go
- Interface
- Model Context Protocol server with stdio, SSE, and streamable HTTP transports
- Installation surfaces
- uvx, Docker, downloadable or Go-built binary, and Helm
- Grafana compatibility
- Grafana 9.0 or later is required for full functionality
- Authentication
- Service account token or username and password, with Grafana RBAC permissions
- Testing structure
- Separate unit, Docker-based integration, cloud, and Python end-to-end test targets
Read from README.md, go.mod, Makefile, docs/troubleshooting.md, docs/sources/_index.md, docs/docs.agent/rules.md, docs/docs.agent/README.md, docs/docs.agent/context.md, docs/sources/introduction.md, docs/sources/clients/zed.md, docs/sources/clients/codex.md, docs/sources/guides/_index.md, docs/sources/set-up/_index.md, docs/sources/clients/_index.md, docs/sources/clients/cursor.md.
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.