How to Install Grafana MCP in Windsurf
Official Grafana integration — query dashboards, explore metrics, and manage alerts via AI
What Grafana MCP does
The official Grafana MCP server gives AI agents access to your Grafana instance — query dashboards, explore metrics data sources, manage alert rules, and troubleshoot incidents through natural language. Features: - Query any dashboard and retrieve panel data - Explore Prometheus, Loki, InfluxDB, and other data sources - Search and view alert rules and their states - Access annotation history for incident correlation - List and filter dashboards by folder and tag - Get data source health and configuration - Run raw PromQL, LogQL, and Flux queries - Export dashboard JSON for backup or migration The killer use case: "Something is wrong with the API" → Claude queries your Grafana, finds the latency spike, correlates with a deployment annotation, traces to the slow query in your Loki logs, and suggests the fix — all in one conversation. Works with Grafana Cloud and self-hosted instances.
Installation steps
- 1Copy the config below
- 2Open ~/.codeium/windsurf/mcp_config.json
- 3Paste inside "mcpServers": {}
- 4Restart Windsurf
Configuration
File location: ~/.codeium/windsurf/mcp_config.json
{
"grafanaMcp": {
"command": "npx",
"args": [
"-y",
"@grafana/mcp-server"
],
"env": {
"GRAFANA_URL": "https://your-instance.grafana.net",
"GRAFANA_API_KEY": "glsa_..."
}
}
}Install in other clients
For maintainers
If you maintain Grafana MCP, add this badge to your README to show it's verified on CuratedMCP:
[](https://curatedmcp.com/marketplace/grafana-mcp)