grafana-mcp-observability

MCP server for Grafana — query dashboards, alerts, and datasources via AI agents.

What is this?

grafana-mcp-observability is an MCP (Model Context Protocol) server that exposes Grafana's observability stack to AI agents. It enables AI-driven incident investigation, alert triage, and dashboard querying — without requiring manual Grafana access.

Built for platform engineers who run Grafana with Prometheus, Loki, or Tempo as their observability backend.

Related MCP server: Grafana MCP Server

Available Tools

Quick Start

Prerequisites

• Python 3.11+

• Grafana instance with API access

• Grafana Service Account token with Viewer role

Installation

git clone https://github.com/akkireddy-challa/grafana-mcp-observability
cd grafana-mcp-observability
pip install -r requirements.txt

Configuration

export GRAFANA_URL=https://grafana.example.com
export GRAFANA_TOKEN=<service-account-token>

Run

python server.py

MCP Client Config (Claude Desktop)

{
  "mcpServers": {
    "grafana": {
      "command": "python",
      "args": ["/path/to/grafana-mcp-observability/server.py"],
      "env": {
        "GRAFANA_URL": "https://grafana.example.com",
        "GRAFANA_TOKEN": "<your-token>"
      }
    }
  }
}

Security Model

• Uses Grafana Service Account tokens — not user credentials

• Token requires Viewer role only — no write access needed

• No dashboard modifications or alert rule changes are possible

• All queries are read-only

• Token stored in environment variables, never in code

Use Cases at Telia

This pattern is used to allow AI agents to:

• Investigate active alerts by querying Prometheus metrics in context

• Correlate Loki log spikes with Grafana annotation events (deployments)

• Summarize dashboard panel state for on-call briefings

• Detect anomalous query patterns across multi-tenant Grafana orgs

Roadmap

• get_traces — query Tempo distributed traces

• create_annotation — mark AI-driven investigation events

• silence_alert — create Alertmanager silences via MCP

• Multi-org Grafana support

• GitHub Actions workflow for CI validation

Related Projects

License

MIT License. See LICENSE for details.