How do I install MCP Grafana?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does MCP Grafana need an API key?

The publisher lists these environment variables: GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN, GRAFANA_USERNAME, GRAFANA_PASSWORD, GRAFANA_ORG_ID, GRAFANA_EXTRA_HEADERS, GRAFANA_FORWARD_HEADERS.

What transport does MCP Grafana use?

MCP Grafana is reached over HTTP.

MCP Grafana MCP server

Q: When was MCP Grafana last checked?

Last checked 2026-11-08. MCP server for Grafana # Grafana MCP server [![Unit Tests](https://github.com/grafana/mcp-grafana/actions/workflows/unit.yml/badge.svg)](https://github.com/grafana/mcp-grafana/actions/workflows/unit.yml) [![Integration Tests](https://github.com/grafana/mcp-grafana/actions/workflows/integration.yml/badge.svg)](https://github.com/grafana/mcp-grafana/actions/workflows/integration.yml) [![E2E Tests]

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.grafana.com/mcp

Credentials from the publisher

GRAFANA_URL — URL to your Grafana instance
GRAFANA_SERVICE_ACCOUNT_TOKEN — Service account token used to authenticate with your Grafana instance
GRAFANA_USERNAME — Username to authenticate with your Grafana instance
GRAFANA_PASSWORD — Password to authenticate with your Grafana instance
GRAFANA_ORG_ID — Organization ID for multi-org support. Can also be set via X-Grafana-Org-Id header in SSE/streamable HTTP transports.
GRAFANA_EXTRA_HEADERS — JSON object of additional HTTP headers to send with all Grafana API requests
GRAFANA_FORWARD_HEADERS — Comma-separated list of HTTP header names to forward from the incoming request to Grafana (SSE/streamable-http only). Example: Cookie,X-Session-Id

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http grafana-mcp-grafana-mcpso https://mcp.grafana.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "grafana-mcp-grafana-mcpso": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.grafana.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http

Overview

About MCP Grafana

MCP server for Grafana # Grafana MCP server [![Unit Tests](https://github.com/grafana/mcp-grafana/actions/workflows/unit.yml/badge.svg)](https://github.com/grafana/mcp-grafana/actions/workflows/unit.yml) [![Integration Tests](https://github.com/grafana/mcp-grafana/actions/workflows/integration.yml/badge.svg)](https://github.com/grafana/mcp-grafana/actions/workflows/integration.yml) [![E2E Tests]

Tools

No tool list yet. Remote servers get one after the first health check.

Tool	Category	Description	Required RBAC Permissions	Required Scopes
`list_teams`	Admin*	List all teams	`teams:read`	`teams:*` or `teams:id:1`
`list_users_by_org`	Admin*	List users in an organization, with search and pagination	`org.users:read`	`global.users:*` or `global.users:id:123`
`list_all_roles`	Admin*	List all Grafana roles	`roles:read`	`roles:*`
`get_role_details`	Admin*	Get details for a Grafana role	`roles:read`	`roles:uid:editor`
`get_role_assignments`	Admin*	List assignments for a role	`roles:read`, `teams.roles:read`, `users.roles:read`	`roles:uid:editor`
`list_user_roles`	Admin*	List roles for users	`users.roles:read`	`global.users:id:123`
`list_team_roles`	Admin*	List roles for teams	`teams.roles:read`	`teams:id:7`
`get_resource_permissions`	Admin*	List permissions for a resource	`dashboards.permissions:read`, `datasources.permissions:read`, `folders.permissions:read`, `serviceaccounts.permissions:read`, `teams.permissions:read`, `users.permissions:read`	`dashboards:uid:abcd1234`
`get_resource_description`	Admin*	Describe a Grafana resource type	`dashboards.permissions:read`, `datasources.permissions:read`, `folders.permissions:read`, `serviceaccounts.permissions:read`, `teams.permissions:read`, `users.permissions:read`	`dashboards:*`
`user_info`	User	Current identity, capabilities, and accessible organizations	None	—
`search_dashboards`	Search	Search for dashboards by query, folder UID, tag, or starred	`dashboards:read`, `folders:read`	`dashboards:*` or `dashboards:uid:abc123`
`search_folders`	Search	Search for folders by title	`folders:read`	`folders:*` or `folders:uid:xyz789`
`get_dashboard_by_uid`	Dashboard	Get a dashboard by uid, optionally a saved version	`dashboard.grafana.app/dashboards:get`, `dashboards:read`, `dashboards:write`	`dashboards:uid:abc123`
`list_dashboard_versions`	Dashboard	List saved versions of a dashboard (version, author, time, message)	`dashboards:read`, `dashboards:write`	`dashboards:uid:abc123`
`update_dashboard`	Dashboard	Update or create a new dashboard	`dashboard.grafana.app/dashboards:create`, `dashboard.grafana.app/dashboards:get`, `dashboard.grafana.app/dashboards:update`, `dashboards:create`, `dashboards:read`, `dashboards:write`, `folders:read`	`dashboards:`, `folders:` or `folders:uid:xyz789`
`get_dashboard_panel_queries`	Dashboard	Get panel title, queries, datasource UID and type from a dashboard	`dashboard.grafana.app/dashboards:get`, `dashboards:read`	`dashboards:uid:abc123`
`run_panel_query`	RunPanelQuery*	Execute one or more dashboard panel queries	`dashboard.grafana.app/dashboards:get`, `dashboards:read`, `datasources:query`, `datasources:read`	`dashboards:uid:`, `datasources:uid:`
`get_dashboard_property`	Dashboard	Extract specific parts of a dashboard using JSONPath expressions	`dashboard.grafana.app/dashboards:get`, `dashboards:read`	`dashboards:uid:abc123`
`get_dashboard_summary`	Dashboard	Get a compact summary of a dashboard without full JSON	`dashboard.grafana.app/dashboards:get`, `dashboards:read`	`dashboards:uid:abc123`
`create_folder`	Dashboard	Create a folder	`folders:create`, `folders:read`, `folders:write`	`folders:*`
`list_datasources`	Datasources	List datasources	`datasources:read`	`datasources:*`
`get_datasource`	Datasources	Get a datasource by UID or name	`datasources:read`	`datasources:uid:prometheus-uid`
`check_datasources_health`	Datasources	Check the health of one or more datasources	`datasources:query`, `datasources:read`	`datasources:uid:*`
`create_datasource`	Datasources	Create a datasource	`datasources:create`, `datasources:read`	`datasources:*`
`update_datasource`	Datasources	Update a datasource	`datasources:read`, `datasources:write`	`datasources:*` or `datasources:uid:abc123`
`get_query_examples`	Examples*	Get example queries for a datasource type	None	`datasources:*`
`query_prometheus`	Prometheus	Execute a query against a Prometheus datasource	`datasources:query`, `datasources:read`	`datasources:uid:prometheus-uid`
`list_prometheus_metric_metadata`	Prometheus	List metric metadata	`datasources:query`, `datasources:read`	`datasources:uid:prometheus-uid`
`list_prometheus_metric_names`	Prometheus	List available metric names	`datasources:query`, `datasources:read`	`datasources:uid:prometheus-uid`
`list_prometheus_label_names`	Prometheus	List label names matching a selector	`datasources:query`, `datasources:read`	`datasources:uid:prometheus-uid`
`list_prometheus_label_values`	Prometheus	List values for a specific label	`datasources:query`, `datasources:read`	`datasources:uid:prometheus-uid`
`query_prometheus_histogram`	Prometheus	Calculate histogram percentile values	`datasources:query`, `datasources:read`	`datasources:uid:prometheus-uid`
`list_incidents`	Incident	List incidents in Grafana Incident, optionally with their custom field values	`plugins.app:access`	N/A
`create_incident`	Incident	Create an incident in Grafana Incident, optionally setting custom fields	`plugins.app:access`	N/A
`add_activity_to_incident`	Incident	Add an activity item to an incident in Grafana Incident	`plugins.app:access`	N/A
`update_incident`	Incident	Update an incident in Grafana Incident (status, severity, title, or custom fields)	`plugins.app:access`	N/A
`get_incident`	Incident	Get a single incident by ID, including its custom fields	`plugins.app:access`	N/A
`list_incident_custom_fields`	Incident	List the custom fields configured for incidents, with their types and select options	`plugins.app:access`	N/A
`query_loki_logs`	Loki	Query and retrieve logs using LogQL (either log or metric queries)	`datasources:query`, `datasources:read`	`datasources:uid:loki-uid`
`list_loki_label_names`	Loki	List all available label names in logs	`datasources:query`, `datasources:read`	`datasources:uid:loki-uid`
`list_loki_label_values`	Loki	List values for a specific log label	`datasources:query`, `datasources:read`	`datasources:uid:loki-uid`
`query_loki_stats`	Loki	Get statistics about log streams	`datasources:query`, `datasources:read`	`datasources:uid:loki-uid`
`query_loki_patterns`	Loki	Query detected log patterns to identify common structures	`datasources:query`, `datasources:read`	`datasources:uid:loki-uid`
`analyze_loki_labels`	Loki	Audit a Loki label strategy (live or static) and optionally diagnose query performance	`datasources:query`, `datasources:read`	`datasources:uid:loki-uid`
`suggest_loki_alloy_label_config`	Config	Generate an Alloy `loki.process` snippet enforcing approved labels	None	N/A
`query_influxdb`	InfluxDB*	Query InfluxDB using InfluxQL (v1) or Flux (v2)	`datasources:query`, `datasources:read`	`datasources:uid:influxdb-uid`
`list_sql_databases`	SQL*	List databases, schemas, or catalogs from a SQL datasource	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_sql_tables`	SQL*	List tables in a SQL datasource	`datasources:query`, `datasources:read`	`datasources:uid:*`
`describe_sql_table`	SQL*	Get column schema for a table	`datasources:query`, `datasources:read`	`datasources:uid:*`
`query_sql`	SQL*	Execute SQL queries with macro substitution	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloudwatch_namespaces`	CloudWatch*	List available AWS CloudWatch namespaces	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloudwatch_metrics`	CloudWatch*	List metrics in a namespace	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloudwatch_dimensions`	CloudWatch*	List dimensions for a metric	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloudwatch_dimension_values`	CloudWatch*	List values for a dimension key	`datasources:query`, `datasources:read`	`datasources:uid:*`
`query_cloudwatch`	CloudWatch*	Execute CloudWatch metric queries	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloudwatch_log_groups`	CloudWatch*	List CloudWatch log groups	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloudwatch_log_group_fields`	CloudWatch*	List fields discovered in a log group	`datasources:query`, `datasources:read`	`datasources:uid:*`
`query_cloudwatch_logs`	CloudWatch*	Execute CloudWatch Logs Insights queries	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloud_logging_projects`	Cloud Logging*	List GCP projects readable by a Google Cloud Logging datasource	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloud_logging_buckets`	Cloud Logging*	List log buckets in a GCP project	`datasources:query`, `datasources:read`	`datasources:uid:*`
`list_cloud_logging_views`	Cloud Logging*	List log views in a log bucket	`datasources:query`, `datasources:read`	`datasources:uid:*`
`query_cloud_logging`	Cloud Logging*	Query logs with the Cloud Logging query language	`datasources:query`, `datasources:read`	`datasources:uid:*`
`query_elasticsearch`	Elasticsearch/OpenSearch*	Query Elasticsearch or OpenSearch using Lucene syntax or Query DSL	`datasources:query`, `datasources:read`	`datasources:uid:datasource-uid`
`query_quickwit`	Quickwit*	Query Quickwit using Lucene syntax or Query DSL	`datasources:query`, `datasources:read`	`datasources:uid:quickwit-uid`
`alerting_rules_read`	Alerting	List and inspect alert rules (list, get, versions)	`alert.rules.external:read`, `alert.rules:read`, `datasources:read`, `folders:read`	`folders:*` or `folders:uid:alerts-folder`
`alerting_rules_write`	Alerting	Create, update and delete Grafana-managed rules, or explicitly create datasource-managed rules	`alert.provisioning.provenance:write`, `alert.rules.external:read`, `alert.rules.external:write`, `alert.rules:create`, `alert.rules:delete`, `alert.rules:read`, `alert.rules:write`, `datasources:read`, `folders:read`	`folders:*`, or `datasources:uid:<uid>` for external creation
`alerting_manage_routing`	Alerting	Manage notification policies, contact points, and time intervals	`alert.notifications.external:read`, `alert.notifications.receivers:read`, `alert.notifications.routes:read`, `alert.notifications.time-intervals:read`, `alert.notifications:read`, `datasources:query`, `datasources:read`, `notifications.alerting.grafana.app/routingtrees:get`	Global scope
`alerting_routing_write`	Alerting	Create Grafana-managed contact points by default, or explicitly create external Alertmanager receivers	`alert.notifications.external:read`, `alert.notifications.external:write`, `alert.notifications.receivers:create`, `alert.provisioning.provenance:write`, `datasources:read`	Global, or `datasources:uid:<uid>` for external creation
`alerting_silences_read`	Alerting	List and inspect alerting silences (list, get)	`alert.instances:read`, `alert.silences:read`	Global scope
`alerting_silences_write`	Alerting	Create, update, and expire alerting silences	`alert.instances:create`, `alert.instances:read`, `alert.instances:write`, `alert.silences:create`, `alert.silences:read`, `alert.silences:write`	Global scope
`list_oncall_schedules`	OnCall	List schedules from Grafana OnCall	`grafana-irm-app.schedules:read`, `plugins.app:access`	Plugin-specific scopes
`get_oncall_shift`	OnCall	Get details for a specific OnCall shift	`grafana-irm-app.schedules:read`, `plugins.app:access`	Plugin-specific scopes
`get_current_oncall_users`	OnCall	Get users currently on-call for a specific schedule	`grafana-irm-app.schedules:read`, `grafana-irm-app.user-settings:read`, `plugins.app:access`	Plugin-specific scopes
`list_oncall_teams`	OnCall	List teams from Grafana OnCall	`grafana-irm-app.user-settings:read`, `plugins.app:access`	Plugin-specific scopes
`list_oncall_users`	OnCall	List users from Grafana OnCall	`grafana-irm-app.user-settings:read`, `plugins.app:access`	Plugin-specific scopes
`list_alert_groups`	OnCall	List alert groups from Grafana OnCall with filtering options	`grafana-irm-app.alert-groups:read`, `plugins.app:access`	Plugin-specific scopes
`get_alert_group`	OnCall	Get a specific alert group from Grafana OnCall by its ID	`grafana-irm-app.alert-groups:read`, `plugins.app:access`	Plugin-specific scopes
`update_alert_group`	OnCall	Acknowledge, unacknowledge, resolve, or unresolve an alert group	`grafana-irm-app.alert-groups:read`, `grafana-irm-app.alert-groups:write`, `plugins.app:access`	Plugin-specific scopes
`list_pyroscope_label_names`	Pyroscope	List label names matching a selector	`datasources:query`, `datasources:read`	`datasources:uid:pyroscope-uid`
`list_pyroscope_label_values`	Pyroscope	List label values matching a selector for a label name	`datasources:query`, `datasources:read`	`datasources:uid:pyroscope-uid`
`list_pyroscope_profile_types`	Pyroscope	List available profile types	`datasources:query`, `datasources:read`	`datasources:uid:pyroscope-uid`
`query_pyroscope`	Pyroscope	Query profiles, metrics, or both from Pyroscope	`datasources:query`, `datasources:read`	`datasources:uid:pyroscope-uid`
`get_assertions`	Asserts	Get assertion summary for a given entity	`plugins.app:access`	Plugin-specific scopes
`agento11y_manage_conversations`	Agent Observability*	List, search, and fetch LLM conversations from Grafana Agent Observability	`grafana-agento11y-app.conversations:read`, `grafana-agento11y-app.data:read`, `plugins.app:access`	N/A
`agento11y_manage_generations`	Agent Observability*	Fetch LLM generation details and evaluation scores from Grafana Agent Observability	`grafana-agento11y-app.conversations:read`, `grafana-agento11y-app.data:read`, `plugins.app:access`	N/A
`agento11y_manage_agents`	Agent Observability*	Read the agent catalog: list agents, get one agent version in full, list version history, and per-version score aggregates	`grafana-agento11y-app.conversations:read`, `grafana-agento11y-app.data:read`, `plugins.app:access`	N/A
`agento11y_manage_evaluators`	Agent Observability*	Manage evaluators, evaluator templates, and the judge catalog (list, get, upsert, fork, test, delete)	`grafana-agento11y-app.conversations:read`, `grafana-agento11y-app.data:read`, `plugins.app:access`; with writes enabled also `grafana-agento11y-app.eval:write`	N/A
`agento11y_manage_eval_rules`	Agent Observability*	Manage eval rules and guards (list, get, create, update, preview, delete)	`grafana-agento11y-app.conversations:read`, `grafana-agento11y-app.data:read`, `plugins.app:access`; with writes enabled also `grafana-agento11y-app.eval:write`	N/A
`agento11y_manage_eval_collections`	Agent Observability*	Manage saved conversations and the collections that group them (list, get, save, create, update, delete, add and remove members)	`grafana-agento11y-app.conversations:read`, `grafana-agento11y-app.data:read`, `plugins.app:access`; with writes enabled also `grafana-agento11y-app.eval:write`	N/A
`agento11y_manage_experiments`	Agent Observability*	Read offline experiments, their trials, scores, artifact metadata, and filter facets; update and cancel an experiment	`grafana-agento11y-app.conversations:read`, `grafana-agento11y-app.data:read`, `plugins.app:access`; with writes enabled also `grafana-agento11y-app.eval:write`	N/A
`agento11y_manage_test_suites`	Agent Observability*	Manage the test suites that offline experiments run against, their versions, and their test cases (list, get, create, update, draft, publish, upsert, delete)	`grafana-agento11y-app.conversations:read`, `grafana-agento11y-app.data:read`, `plugins.app:access`; with writes enabled also `grafana-agento11y-app.eval:write`	N/A
`ask_assistant`	Assistant*	Send a prompt to Grafana Assistant and return the full text reply (multi-turn via `contextId`)	`grafana-assistant-app.chats:access`, `plugins.app:access`	Plugin-specific scopes
`generate_deeplink`	Navigation	Generate accurate deeplink URLs for Grafana resources	None	N/A
`get_annotations`	Annotations	Fetch annotations with filters	`annotations:read`	`annotations:*` or `annotations:id:123`
`create_annotation`	Annotations	Create a new annotation (standard or Graphite format)	`annotations:create`	`annotations:*`
`update_annotation`	Annotations	Update specific fields of an annotation (partial update)	`annotations:read`, `annotations:write`	`annotations:*`
`delete_annotation`	Annotations	Delete an annotation by ID

Tool

Add this server

Host a copy with our keys and logs.

Server facts

About MCP Grafana

Tools

Questions

How do I install MCP Grafana?

Does MCP Grafana need an API key?

What transport does MCP Grafana use?

When was MCP Grafana last checked?

Documentation

Grafana MCP server

Quick Start

Key features

Requirements

Features

Dashboards

Run Panel Query

Context Window Management

Datasources

Query Examples

Prometheus Querying

Loki Querying

InfluxDB Querying

SQL Datasource Querying

CloudWatch Querying

Google Cloud Logging Querying

Graphite Querying

Elasticsearch/OpenSearch Querying

Quickwit Querying

Agent Observability

Grafana Assistant

Incidents

Alerting

Grafana OnCall

Admin

User

Navigation

Annotations

Snapshots

Rendering

Provisioning

RBAC Permissions

RBAC Scopes

Tools