When should you use this server
- Search, retrieve, and update dashboards programmatically
- Query Prometheus metrics or Loki logs directly from MCP clients
- Access and manage alert rules, contact points, and incidents
- Integrate OnCall schedules and shifts into automated workflows
- Perform Sift investigations, error detection, and performance profiling via Pyroscope
- Generate deep links for Grafana resources that can be shared in AI-driven reports
Key features
- Dashboard creation and management
- Metrics querying and visualization
- Log search and analysis
- Alerting and incident management
- OnCall schedule management
- Performance profiling with Pyroscope
- Deep links generation for sharing resources
Authentication
- Method: RBAC permissions and API scopes depending on the tool
- Notes: Different tools require different permission levels
Endpoints
- Grafana version: 9.0 or later (required for full functionality)
- Supported environments:
- Local Grafana (
http://localhost:3000) - Grafana Cloud (use your instance URL, e.g.
https://myinstance.grafana.net)
- Local Grafana (
Tools provided
list_teams
List all teams in the Grafana organization.list_users_by_org
List all users in an organization with their roles and permissions.search_dashboards
Search for dashboards by name, tag, or other criteria.get_dashboard_by_uid
Get a dashboard by its unique identifier (UID).update_dashboard
Create a new dashboard or update an existing one.get_dashboard_panel_queries
Get queries and datasource information for dashboard panels.get_dashboard_property
Extract dashboard data using JSONPath expressions.get_dashboard_summary
Retrieve a compact summary of a dashboard’s content and structure.list_datasources
List all configured datasources in the Grafana instance.get_datasource_by_uid
Get a datasource by its unique identifier (UID).get_datasource_by_name
Get a datasource by its name.query_prometheus
Execute a PromQL query against Prometheus datasources.list_prometheus_metric_metadata
List metadata about available Prometheus metrics.list_prometheus_metric_names
List available metric names in Prometheus datasources.list_prometheus_label_names
List available label names in Prometheus datasources.list_prometheus_label_values
List possible values for a specific Prometheus label.query_loki_logs
Run LogQL queries against Loki log datasources.list_loki_label_names
List available label names in Loki logs.list_loki_label_values
List possible values for a specific Loki log label.query_loki_stats
Retrieve statistics about log streams and volume.list_incidents
List incidents in Grafana Incident management.get_incident
Get detailed information about a specific incident.create_incident
Create a new incident in Grafana Incident management.add_activity_to_incident
Add an activity entry to an existing incident.list_alert_rules
List alert rules configured in Grafana.get_alert_rule_by_uid
Get detailed information about a specific alert rule.list_contact_points
List alert notification contact points.list_oncall_schedules
List OnCall rotation schedules.get_oncall_shift
Get details about a specific OnCall shift.get_current_oncall_users
Retrieve information about users currently on-call.list_oncall_teams
List teams configured in OnCall.list_oncall_users
List users participating in OnCall rotations.get_sift_investigation
Retrieve a Sift investigation by its UUID.get_sift_analysis
Get a specific analysis from a Sift investigation.list_sift_investigations
List available Sift investigations.find_error_pattern_logs
Detect error patterns in Loki logs using Sift.find_slow_requests
Find slow requests from Tempo datasources.list_pyroscope_label_names
List available label names in Pyroscope profiles.list_pyroscope_label_values
List possible values for a specific Pyroscope label.list_pyroscope_profile_types
List available profile types in Pyroscope.fetch_pyroscope_profile
Fetch a profile in DOT format for analysis.get_assertions
Retrieve assertion summaries for monitored entities.generate_deeplink
Generate shareable deep links to Grafana resources.Notes
- Tools respect RBAC permissions and require the correct API scopes
- Datasource-related operations may not work on Grafana versions older than 9.0
- Works with both Grafana Cloud and self-managed instances