A [Model Context Protocol][mcp] (MCP) server for Grafana.
mcp-grafana is an MCP project maintained in the grafana/mcp-grafana repository. The maintainer describes its purpose as “A [Model Context Protocol][mcp] (MCP) server for Grafana”. Read the project documentation for the complete scope.
The documented pypi package is mcp-grafana. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| list_teams | Admin |
| list_users_by_org | Admin |
| list_all_roles | Admin |
| get_role_details | Admin |
| get_role_assignments | Admin |
| list_user_roles | Admin |
| list_team_roles | Admin |
| get_resource_permissions | Admin |
| get_resource_description | Admin |
| user_info | User |
| search_dashboards | Search |
| get_dashboard_by_uid | Dashboard |
| list_dashboard_versions | Dashboard |
| update_dashboard | Dashboard |
| get_dashboard_panel_queries | Dashboard |
| run_panel_query | RunPanelQuery |
| get_dashboard_property | Dashboard |
| get_dashboard_summary | Dashboard |
| list_datasources | Datasources |
| get_datasource | Datasources |
| get_query_examples | Examples |
| query_prometheus | Prometheus |
| list_prometheus_metric_metadata | Prometheus |
| list_prometheus_metric_names | Prometheus |
| list_prometheus_label_names | Prometheus |
| list_prometheus_label_values | Prometheus |
| query_prometheus_histogram | Prometheus |
| list_incidents | Incident |
| create_incident | Incident |
| add_activity_to_incident | Incident |
| update_incident | Incident |
| get_incident | Incident |
| list_incident_custom_fields | Incident |
| query_loki_logs | Loki |
| list_loki_label_names | Loki |
| list_loki_label_values | Loki |
| query_loki_stats | Loki |
| query_loki_patterns | Loki |
| analyze_loki_labels | Loki |
| suggest_loki_alloy_label_config | Config |
| query_influxdb | InfluxDB |
| list_sql_databases | SQL |
| list_sql_tables | SQL |
| describe_sql_table | SQL |
| query_sql | SQL |
| list_cloudwatch_namespaces | CloudWatch |
| list_cloudwatch_metrics | CloudWatch |
| list_cloudwatch_dimensions | CloudWatch |
| list_cloudwatch_dimension_values | CloudWatch |
| query_cloudwatch | CloudWatch |
| list_cloud_logging_projects | Cloud Logging |
| list_cloud_logging_buckets | Cloud Logging |
| list_cloud_logging_views | Cloud Logging |
| query_cloud_logging | Cloud Logging |
| query_elasticsearch | Elasticsearch/OpenSearch |
| query_quickwit | Quickwit |
| alerting_rules_read | Alerting |
| alerting_rules_write | Alerting |
| alerting_manage_routing | Alerting |
| alerting_routing_write | Alerting |
| alerting_silences_read | Alerting |
| alerting_silences_write | Alerting |
| list_oncall_schedules | OnCall |
| get_oncall_shift | OnCall |
| get_current_oncall_users | OnCall |
| list_oncall_teams | OnCall |
| list_oncall_users | OnCall |
| list_alert_groups | OnCall |
| get_alert_group | OnCall |
| update_alert_group | OnCall |
| list_pyroscope_label_names | Pyroscope |
| list_pyroscope_label_values | Pyroscope |
| list_pyroscope_profile_types | Pyroscope |
| query_pyroscope | Pyroscope |
| get_assertions | Asserts |
| agento11y_manage_conversations | Agent Observability |
| agento11y_manage_generations | Agent Observability |
| agento11y_manage_agents | Agent Observability |
| agento11y_manage_evaluators | Agent Observability |
| agento11y_manage_eval_rules | Agent Observability |
| agento11y_manage_eval_collections | Agent Observability |
| agento11y_manage_experiments | Agent Observability |
| agento11y_manage_test_suites | Agent Observability |
| ask_assistant | Assistant |
| generate_deeplink | Navigation |
| get_annotations | Annotations |
| create_annotation | Annotations |
| update_annotation | Annotations |
| delete_annotation | Annotations |
| get_annotation_tags | Annotations |
| list_snapshots | Snapshot |
| get_snapshot | Snapshot |
| create_snapshot | Snapshot |
| delete_snapshot | Snapshot |
| get_panel_image | Rendering |
| list_provisioning_repositories | Provisioning |
| validate_provisioning_file | Provisioning |
| search_docs | Docs |
| get_doc | Docs |
{
"mcpServers": {
"grafana": {
"command": "uvx",
"args": [
"mcp-grafana"
],
"env": {
"GRAFANA_URL": "http://localhost:3000",
"GRAFANA_SERVICE_ACCOUNT_TOKEN": "YOUR_GRAFANA_SERVICE_ACCOUNT_TOKEN"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| GRAFANA_URL | Declared in the maintainer’s client configuration. | Check documentation |
| GRAFANA_SERVICE_ACCOUNT_TOKEN | Declared in the maintainer’s client configuration. | Check documentation |
Give your coding agent the full DevTools toolbox: traces, network, console, heap snapshots and Lighthouse.
Workers, KV, R2 and D1 by conversation — Cloudflare's official remote servers for building and observability.
Dashboards, Prometheus and Loki queries, incidents and alerts — observability by conversation.
Errors with full context — stack traces, issue triage and AI-powered root-cause analysis from Sentry's server.
Connect Flutter applications with AI coding assistants via the Model Context Protocol.
Enables natural language interaction with Splunk Enterprise and Cloud for searching data and managing resources.