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)

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 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