assistant-mcp

What problem does it solve?

Enable AI coding agents to access and control Grafana Cloud resources directly via the Model Context Protocol (MCP), removing context switching and manual API calls and allowing agents to run queries, inspect dashboards, and manage alerts from their coding environment.

Core Features & Use Cases

• Transports: support for stdio (agent-spawned subprocess) and SSE (long-lived server) to fit local, team, and editor-based workflows.
• Agent integrations: configuration examples and steps for Claude Code, Cursor, and VS Code MCP clients.
• Tooling exposed: run PromQL, LogQL, and TraceQL queries; search and retrieve dashboards; list and inspect alert rules and incidents; manage fleet collectors and pipelines when enabled.
• Use Case: have an agent retrieve the p95 latency for a service, search dashboards tagged "kubernetes", or list unhealthy collectors without leaving your editor.

Quick Start

Add a Grafana MCP server entry to your agent's MCP configuration with GRAFANA_URL and GRAFANA_API_KEY and run the mcp-grafana binary using stdio for single sessions or SSE for a shared server.