← Explore all mcp servers

OBSERVABILITY / Grafana

Grafana MCP Server

Connects dashboards, logs, metrics and related Grafana data sources to an assistant, with separate controls for writes and query execution.

“This provides access to your Grafana instance and the surrounding ecosystem.”

01 / THE REASONING

Why this made the selection.

  • Separates metadata access, datasource query execution and write tools through explicit flags.
  • Uses existing Grafana datasource connections, so an investigation can cross observability systems.
  • The pinned README is the Grafana server that can query dashboards and datasources, and it documents separate switches for write tools and for datasource queries.
  • Raw SQL tools are removed in read-only mode because the server does not inspect the query text.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • README.md setup, configuration and operating-limit sections at 8424d5729dd362ae2d1d00cf23a1733c4458590e
  • LICENSE at the same revision
  • go.mod
  • cmd/mcp-grafana/main.go
  • README.md
  • LICENSE
  • Round 2 reread of acquired publisher setup and permission evidence; see immutable wave review.

Our findings

  • Read-only mode removes raw SQL and InfluxDB query tools unless explicitly re-enabled; Grafana permissions alone do not make a downstream SQL credential read-only.
  • The current README documents token-file precedence, query-control precedence and compact dashboard retrieval to reduce response size.
  • `--disable-write` stops dashboard, folder, incident, alert, annotation, and snapshot writes, and it also drops raw SQL tools that can run DROP or DELETE when the datasource credential allows it.
  • `--disable-query` removes every tool that executes a datasource query while leaving metadata tools, and it wins over `--enable-query`.
  • Google Cloud Logging tools are disabled by default, and enabling X-Grafana-URL without an allowlist lets a caller select any HTTP or HTTPS URL the process can reach.
  • Anonymous process-level usage reporting is enabled by default; the README documents GRAFANA_USAGE_STATS=disabled or DO_NOT_TRACK=1 to opt out.

Not established by this review

  • Server startup, authentication and live tool calls were not tested.
  • Published package/container parity with the inspected source commit and security isolation were not tested.
  • The server was not started and its tools were not called.
  • A pin does not verify transitive dependencies.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

uvx mcp-grafana

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Set GRAFANA_URL and an appropriately scoped Grafana service-account token.
  2. Choose tool categories and write/query restrictions; configure a caller token before sharing a network listener.

Before you start

  • uv and access to a supported Grafana instance.

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": [
        "mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
      }
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/grafana/mcp-grafana/blob/8424d5729dd362ae2d1d00cf23a1733c4458590e/README.md

    Supports: summary, upstreamDescription, install, configExample, access, limitations, bestFor, review

  2. https://github.com/grafana/mcp-grafana/blob/8424d5729dd362ae2d1d00cf23a1733c4458590e/LICENSE

    Supports: license

  3. https://github.com/grafana/mcp-grafana/blob/8424d5729dd362ae2d1d00cf23a1733c4458590e/go.mod

    Supports: review, install, language

  4. https://github.com/grafana/mcp-grafana/blob/8424d5729dd362ae2d1d00cf23a1733c4458590e/cmd/mcp-grafana/main.go

    Supports: review, install, language

Evidence & Ask