Grafana MCP Server

What this server does

Grafana Labs' MCP server lets the assistant reach into your observability stack: find dashboards, read their panels, query Prometheus and Loki datasources, and inspect alert rules and their current state. During an incident the model can pull the relevant dashboard, run the query behind a panel, and correlate a firing alert with the metrics that drove it. Scope the service account token to viewer so the assistant reads without changing anything. Runs as a Docker container.

Tools included

• search_dashboards

  Search dashboards by title or tag.

• get_dashboard

  Fetch a dashboard definition.

• query_prometheus

  Run a PromQL query against a Prometheus datasource.

• list_datasources

  List configured datasources.

• list_alert_rules

  List alert rules and their state.

The authoritative list comes from the server's tools/list at runtime. This catalog entry may lag the upstream until the next ToolPiper release.

Install in ToolPiper

ToolPiper handles the JSON configuration. Click Install, fill in any required tokens, and the server is ready in your chat.

Install in another client

{
  "mcpServers": {
    "grafana": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "grafana/mcp-grafana:0.14.0"
      ]
    }
  }
}

Example prompts

Security notes

Use a service account token scoped to viewer so the assistant cannot edit dashboards or silence alerts. The token grants read access to whatever that service account can see, which may include sensitive operational data; treat it as a credential and rotate it if it leaks. Requires a working Docker install. The token is forwarded into the container via an environment variable, not baked into the image.

Related tools