Skip to directory

About Grafana MCP

Grafana MCP integrates Grafana dashboards, folders, datasources, metrics/logs/traces, alerting, incidents, OnCall, annotations, snapshots, rendering, and user information.

What you can use it for

  • Grafana observability and administration
Connection and setup
Hosting
Vendor-hosted remote MCP
Transport
stdio
Endpoint
Local process; no hosted endpoint documented
Authentication
Grafana service account token or username/password, with RBAC permissions and scopes required per tool.

Requirements

  • Grafana 9.0 or later for full functionality
  • uv for the documented uvx install, or Docker/binary/Helm alternative
  • Grafana instance URL
  • Service account token with the RBAC permissions required for selected tools

Setup steps

  1. Create a Grafana service account and token with only the RBAC permissions required by the tools you plan to enable.
  2. Install with uvx using the official package mcp-grafana, or choose Docker, binary, or Helm from the official setup guide.
  3. Configure GRAFANA_URL and GRAFANA_SERVICE_ACCOUNT_TOKEN in the MCP client environment. For Grafana Cloud, use the stack URL.
  4. Add the local stdio server to the client and reload the connection.
  5. Start with read-only exploration. If desired, set --disable-write; also consider --disable-query because SQL/Influx queries can write depending on datasource permissions.
Tools 122

Grafana’s current official tools table enumerates all 122 stored names. Optional tool families may be disabled by default; RBAC, scopes, instance version and flags determine effective exposure.

  • add_activity_to_incident

    Grafana MCP Server: add activity to incident.

    01
  • agento11y_manage_agents

    Grafana MCP Server: agento11y manage agents.

    02
  • agento11y_manage_conversations

    Grafana MCP Server: agento11y manage conversations.

    03
  • agento11y_manage_eval_collections

    Grafana MCP Server: agento11y manage eval collections.

    04
  • agento11y_manage_eval_rules

    Grafana MCP Server: agento11y manage eval rules.

    05
  • agento11y_manage_evaluators

    Grafana MCP Server: agento11y manage evaluators.

    06
  • agento11y_manage_experiments

    Grafana MCP Server: agento11y manage experiments.

    07
  • agento11y_manage_generations

    Grafana MCP Server: agento11y manage generations.

    08
  • agento11y_manage_test_suites

    Grafana MCP Server: agento11y manage test suites.

    09
  • alerting_manage_routing

    Grafana MCP Server: alerting manage routing.

    10
  • alerting_routing_write

    Grafana MCP Server: alerting routing write.

    11
  • alerting_rules_read

    Grafana MCP Server: alerting rules read.

    12
  • alerting_rules_write

    Grafana MCP Server: alerting rules write.

    13
  • alerting_silences_read

    Grafana MCP Server: alerting silences read.

    14
  • alerting_silences_write

    Grafana MCP Server: alerting silences write.

    15
  • analyze_loki_labels

    Grafana MCP Server: analyze loki labels.

    16
  • ask_assistant

    Grafana MCP Server: ask assistant.

    17
  • check_datasources_health

    Grafana MCP Server: check datasources health.

    18
  • create_annotation

    Grafana MCP Server: create annotation.

    19
  • create_datasource

    Grafana MCP Server: create datasource.

    20
  • create_folder

    Grafana MCP Server: create folder.

    21
  • create_incident

    Grafana MCP Server: create incident.

    22
  • create_snapshot

    Grafana MCP Server: create snapshot.

    23
  • delete_annotation

    Grafana MCP Server: delete annotation.

    24
  • delete_snapshot

    Grafana MCP Server: delete snapshot.

    25
  • describe_sql_table

    Grafana MCP Server: describe sql table.

    26
  • diff_tempo_traces

    Grafana MCP Server: diff tempo traces.

    27
  • generate_deeplink

    Grafana MCP Server: generate deeplink.

    28
  • get_alert_group

    Grafana MCP Server: get alert group.

    29
  • get_annotation_tags

    Grafana MCP Server: get annotation tags.

    30
  • get_annotations

    Grafana MCP Server: get annotations.

    31
  • get_assertions

    Grafana MCP Server: get assertions.

    32
  • get_current_oncall_users

    Grafana MCP Server: get current oncall users.

    33
  • get_dashboard_by_uid

    Grafana MCP Server: get dashboard by uid.

    34
  • get_dashboard_panel_queries

    Grafana MCP Server: get dashboard panel queries.

    35
  • get_dashboard_property

    Grafana MCP Server: get dashboard property.

    36
  • get_dashboard_summary

    Grafana MCP Server: get dashboard summary.

    37
  • get_datasource

    Grafana MCP Server: get datasource.

    38
  • get_doc

    Grafana MCP Server: get doc.

    39
  • get_incident

    Grafana MCP Server: get incident.

    40
  • get_oncall_shift

    Grafana MCP Server: get oncall shift.

    41
  • get_panel_image

    Grafana MCP Server: get panel image.

    42
  • get_plugin

    Grafana MCP Server: get plugin.

    43
  • get_query_examples

    Grafana MCP Server: get query examples.

    44
  • get_resource_description

    Grafana MCP Server: get resource description.

    45
  • get_resource_permissions

    Grafana MCP Server: get resource permissions.

    46
  • get_role_assignments

    Grafana MCP Server: get role assignments.

    47
  • get_role_details

    Grafana MCP Server: get role details.

    48
  • get_snapshot

    Grafana MCP Server: get snapshot.

    49
  • get_tempo_trace

    Grafana MCP Server: get tempo trace.

    50
  • get_tempo_traceql_docs

    Grafana MCP Server: get tempo traceql docs.

    51
  • grafana_api_request

    Grafana MCP Server: grafana api request.

    52
  • install_plugin

    Grafana MCP Server: install plugin.

    53
  • list_alert_groups

    Grafana MCP Server: list alert groups.

    54
  • list_all_roles

    Grafana MCP Server: list all roles.

    55
  • list_cloud_logging_buckets

    Grafana MCP Server: list cloud logging buckets.

    56
  • list_cloud_logging_projects

    Grafana MCP Server: list cloud logging projects.

    57
  • list_cloud_logging_views

    Grafana MCP Server: list cloud logging views.

    58
  • list_cloudwatch_dimension_values

    Grafana MCP Server: list cloudwatch dimension values.

    59
  • list_cloudwatch_dimensions

    Grafana MCP Server: list cloudwatch dimensions.

    60
  • list_cloudwatch_log_group_fields

    Grafana MCP Server: list cloudwatch log group fields.

    61
  • list_cloudwatch_log_groups

    Grafana MCP Server: list cloudwatch log groups.

    62
  • list_cloudwatch_metrics

    Grafana MCP Server: list cloudwatch metrics.

    63
  • list_cloudwatch_namespaces

    Grafana MCP Server: list cloudwatch namespaces.

    64
  • list_dashboard_versions

    Grafana MCP Server: list dashboard versions.

    65
  • list_datasources

    Grafana MCP Server: list datasources.

    66
  • list_graphite_metrics

    Grafana MCP Server: list graphite metrics.

    67
  • list_graphite_tags

    Grafana MCP Server: list graphite tags.

    68
  • list_incident_custom_fields

    Grafana MCP Server: list incident custom fields.

    69
  • list_incidents

    Grafana MCP Server: list incidents.

    70
  • list_loki_label_names

    Grafana MCP Server: list loki label names.

    71
  • list_loki_label_values

    Grafana MCP Server: list loki label values.

    72
  • list_oncall_schedules

    Grafana MCP Server: list oncall schedules.

    73
  • list_oncall_teams

    Grafana MCP Server: list oncall teams.

    74
  • list_oncall_users

    Grafana MCP Server: list oncall users.

    75
  • list_prometheus_label_names

    Grafana MCP Server: list prometheus label names.

    76
  • list_prometheus_label_values

    Grafana MCP Server: list prometheus label values.

    77
  • list_prometheus_metric_metadata

    Grafana MCP Server: list prometheus metric metadata.

    78
  • list_prometheus_metric_names

    Grafana MCP Server: list prometheus metric names.

    79
  • list_provisioning_repositories

    Grafana MCP Server: list provisioning repositories.

    80
  • list_pyroscope_label_names

    Grafana MCP Server: list pyroscope label names.

    81
  • list_pyroscope_label_values

    Grafana MCP Server: list pyroscope label values.

    82
  • list_pyroscope_profile_types

    Grafana MCP Server: list pyroscope profile types.

    83
  • list_snapshots

    Grafana MCP Server: list snapshots.

    84
  • list_sql_databases

    Grafana MCP Server: list sql databases.

    85
  • list_sql_tables

    Grafana MCP Server: list sql tables.

    86
  • list_team_roles

    Grafana MCP Server: list team roles.

    87
  • list_teams

    Grafana MCP Server: list teams.

    88
  • list_tempo_attribute_names

    Grafana MCP Server: list tempo attribute names.

    89
  • list_tempo_attribute_values

    Grafana MCP Server: list tempo attribute values.

    90
  • list_user_roles

    Grafana MCP Server: list user roles.

    91
  • list_users_by_org

    Grafana MCP Server: list users by org.

    92
  • query_cloud_logging

    Grafana MCP Server: query cloud logging.

    93
  • query_cloudwatch

    Grafana MCP Server: query cloudwatch.

    94
  • query_cloudwatch_logs

    Grafana MCP Server: query cloudwatch logs.

    95
  • query_elasticsearch

    Grafana MCP Server: query elasticsearch.

    96
  • query_graphite

    Grafana MCP Server: query graphite.

    97
  • query_graphite_density

    Grafana MCP Server: query graphite density.

    98
  • query_influxdb

    Grafana MCP Server: query influxdb.

    99
  • query_loki_logs

    Grafana MCP Server: query loki logs.

    100
  • query_loki_patterns

    Grafana MCP Server: query loki patterns.

    101
  • query_loki_stats

    Grafana MCP Server: query loki stats.

    102
  • query_prometheus

    Grafana MCP Server: query prometheus.

    103
  • query_prometheus_histogram

    Grafana MCP Server: query prometheus histogram.

    104
  • query_pyroscope

    Grafana MCP Server: query pyroscope.

    105
  • query_quickwit

    Grafana MCP Server: query quickwit.

    106
  • query_sql

    Grafana MCP Server: query sql.

    107
  • query_tempo_metrics

    Grafana MCP Server: query tempo metrics.

    108
  • run_panel_query

    Grafana MCP Server: run panel query.

    109
  • search_dashboards

    Grafana MCP Server: search dashboards.

    110
  • search_docs

    Grafana MCP Server: search docs.

    111
  • search_folders

    Grafana MCP Server: search folders.

    112
  • search_plugin_information

    Grafana MCP Server: search plugin information.

    113
  • search_tempo_traces

    Grafana MCP Server: search tempo traces.

    114
  • suggest_loki_alloy_label_config

    Grafana MCP Server: suggest loki alloy label config.

    115
  • update_alert_group

    Grafana MCP Server: update alert group.

    116
  • update_annotation

    Grafana MCP Server: update annotation.

    117
  • update_dashboard

    Grafana MCP Server: update dashboard.

    118
  • update_datasource

    Grafana MCP Server: update datasource.

    119
  • update_incident

    Grafana MCP Server: update incident.

    120
  • user_info

    Grafana MCP Server: user info.

    121
  • validate_provisioning_file

    Grafana MCP Server: validate provisioning file.

    122
Limitations and notes
  • The current reference lists 122 tool identifiers; optional categories are disabled unless enabled at startup. Requirements reflect the current Grafana MCP release.
Original sources
  • official tool reference

    Current Grafana reference table enumerates exactly 122 tool identifiers, matching stored names. Tool categories can be disabled by default or enabled explicitly; instance version, RBAC, scopes and server flags affect exposure.

  • official documentation or source

    Current Grafana reference table enumerates exactly 122 tool identifiers, matching stored names. Tool categories can be disabled by default or enabled explicitly; instance version, RBAC, scopes and server flags affect exposure.

Documentation checked 2026-10-28T13:00:03.000Z. Connection has not been runtime tested.