Grafana MCP Server

28 MCP tools for Grafana — dashboards, alerts, data sources, annotations, organizations, users, and teams.

Overview

The Grafana MCP Server is the largest MCP server in the platform with 28 tools covering the full Grafana HTTP API. It enables Compass chat users to query dashboards, inspect alert rules, manage data sources, create annotations, and administer organizations and teams — all through natural language.

Property	Value
Port	50056
Transport	JSON-RPC at /jsonrpc
Namespace	f3iai

Tools

Dashboards

Tool	Description
grafana_list_dashboards	List all dashboards, optionally filtered by folder or tag
grafana_get_dashboard	Get a dashboard by UID, including all panels and queries
grafana_search_dashboards	Search dashboards by title or tag
grafana_create_dashboard	Create a new dashboard from a JSON model
grafana_update_dashboard	Update an existing dashboard
grafana_delete_dashboard	Delete a dashboard by UID
grafana_get_dashboard_permissions	Get permissions for a specific dashboard
grafana_list_dashboard_versions	List version history of a dashboard

Alerts

Tool	Description
grafana_list_alert_rules	List all alert rules
grafana_get_alert_rule	Get details of a specific alert rule
grafana_list_alert_instances	List currently firing or pending alert instances
grafana_list_contact_points	List notification contact points
grafana_list_notification_policies	List alert notification routing policies
grafana_get_alert_history	Get the state history for an alert rule

Data Sources

Tool	Description
grafana_list_datasources	List all configured data sources
grafana_get_datasource	Get details of a specific data source
grafana_test_datasource	Test connectivity to a data source
grafana_query_datasource	Execute a query against a data source and return results

Annotations

Tool	Description
grafana_list_annotations	List annotations, filtered by time range or dashboard
grafana_create_annotation	Create a new annotation on a dashboard or globally
grafana_delete_annotation	Delete an annotation by ID

Organizations and Users

Tool	Description
grafana_list_orgs	List all Grafana organizations
grafana_list_users	List all users in the current organization
grafana_get_user	Get details of a specific user
grafana_list_teams	List all teams
grafana_get_team	Get details of a specific team
grafana_get_team_members	List members of a team

Folders

Tool	Description
grafana_list_folders	List all dashboard folders

Common Use Cases

• “Show me all firing alerts” — calls grafana_list_alert_instances
• “What dashboards exist for Kubernetes?” — calls grafana_search_dashboards with tag filter
• “Test the Prometheus data source” — calls grafana_test_datasource
• “Add an annotation for today’s deployment” — calls grafana_create_annotation
• “Who has access to the Infrastructure dashboard?” — calls grafana_get_dashboard_permissions
• “Query the last hour of CPU usage from Prometheus” — calls grafana_query_datasource

Authentication

The server authenticates to Grafana using a service account API key:

Environment Variable	Description
GRAFANA_URL	Grafana base URL
GRAFANA_API_KEY	Service account token with Admin role

Health Endpoints

Endpoint	Purpose
/health	Liveness — process is running
/ready	Readiness — can reach the Grafana API