Grafana Cloud

View saved version →

---
name: grafana-cloud-mcp-tools
description: Connect to and use the Grafana Cloud MCP server effectively, including natural-language Grafana Assistant questions and observability investigations. Covers setup, OAuth authorization, tool categories, read/write access scopes, and best practices for context window management. Use when the user wants to set up Grafana Cloud MCP, ask Grafana Assistant a question, investigate metrics, logs, traces, profiles, dashboards, alerts, or incidents, needs guidance on which tool to use, or wants to understand access scopes.
---

# Grafana Cloud MCP Server

Hosted MCP server providing 60+ Grafana Cloud tools via Streamable HTTP transport with OAuth 2.1 authorization.

## Prerequisites

- Grafana Cloud account (self-hosted users should use the local OSS MCP server instead)
- **Assistant Cloud MCP User** role or `grafana-assistant-app.cloud-mcp:access` permission (Editor role or higher has this by default)
- An administrator must have accepted the Grafana Assistant terms and conditions

## Configuration

The Cloud MCP server connects via `https://mcp.grafana.com/mcp` using Streamable HTTP transport. No local installation or environment variables are required.

### Setup steps

1. The MCP server connects automatically when the plugin loads.
2. When prompted, enter your Grafana Cloud URL and authorize the connection in your browser.
3. Your OAuth token is valid for 1 hour and refreshes automatically for 30 days.

## Read and write access

When authorizing, you choose which permissions to grant:

- **Read access**: View dashboards, alerts, incidents, and query data sources. Always available.
- **Write access**: Create and modify dashboards, alerts, and incidents. You can uncheck this to grant read-only access.

Organization Admins can grant write access by default. If write access is disabled on the consent page, the user needs the **Assistant Admin** role.

## Tool categories

### Search and navigation

- `search_dashboards` — search for dashboards by query string
- `search_folders` — search for folders by query string
- `generate_deeplink` — generate deeplink URLs for dashboards, panels, and Explore queries

### Dashboards and folders

- `get_dashboard_by_uid` — retrieve the complete dashboard JSON by UID
- `get_dashboard_summary` — compact summary without full JSON (preferred)
- `get_dashboard_property` — extract specific parts via JSONPath
- `get_dashboard_panel_queries` — retrieve panel queries with template variable substitution
- `update_dashboard` — create or update a dashboard (**Write**)
- `create_folder` — create a Grafana folder (**Write**)

### Datasources

- `list_datasources` — list all configured data sources with optional type filtering
- `get_datasource` — get detailed information by UID or name

### Prometheus

- `list_prometheus_metric_names` — discover available metrics with regex filtering
- `list_prometheus_metric_metadata` — list metadata about currently scraped metrics
- `list_prometheus_label_names` — list label names with optional series selector
- `list_prometheus_label_values` — get values for a specific label
- `query_prometheus` — execute PromQL instant or range queries
- `query_prometheus_histogram` — query histogram percentiles

### Loki

- `list_loki_label_names` — list available label names in logs
- `list_loki_label_values` — get unique values for a specific label
- `query_loki_logs` — execute LogQL queries for log entries or metric values
- `query_loki_stats` — get statistics about log streams
- `query_loki_patterns` — detect and analyze common log patterns

### Tempo

If you have Tempo data sources, the Cloud MCP server proxies tools from the Tempo data source, including TraceQL queries and attribute discovery.

### Pyroscope

- `list_pyroscope_label_names` — list available label names in profiles
- `list_pyroscope_label_values` — list values for a specific label
- `list_pyroscope_profile_types` — list available profile types
- `query_pyroscope` — query profil

Preview of the first 4,000 characters. Read full instructions →