Terminal
Terminal/Skill
Explains how to connect to the hosted Grafana Cloud MCP server, its tool categories, access scopes and context-saving habits.
By Grafana Labs
Works with
npx skills add grafana/ai-marketplace --skill grafana-cloud-mcp-toolsHosted MCP server providing 60+ Grafana Cloud tools via Streamable HTTP transport with OAuth 2.1 authorization.
grafana-assistant-app.cloud-mcp:access permission (Editor role or higher has this by default)The Cloud MCP server connects via https://mcp.grafana.com/mcp using Streamable HTTP transport. No local installation or environment variables are required.
When authorizing, you choose which permissions to grant:
Organization Admins can grant write access by default. If write access is disabled on the consent page, the user needs the Assistant Admin role.
search_dashboards — search for dashboards by query stringsearch_folders — search for folders by query stringgenerate_deeplink — generate deeplink URLs for dashboards, panels, and Explore queriesget_dashboard_by_uid — retrieve the complete dashboard JSON by UIDget_dashboard_summary — compact summary without full JSON (preferred)get_dashboard_property — extract specific parts via JSONPathget_dashboard_panel_queries — retrieve panel queries with template variable substitutionupdate_dashboard — create or update a dashboard (Write)create_folder — create a Grafana folder (Write)list_datasources — list all configured data sources with optional type filteringget_datasource — get detailed information by UID or namelist_prometheus_metric_names — discover available metrics with regex filteringlist_prometheus_metric_metadata — list metadata about currently scraped metricslist_prometheus_label_names — list label names with optional series selectorlist_prometheus_label_values — get values for a specific labelquery_prometheus — execute PromQL instant or range queriesquery_prometheus_histogram — query histogram percentileslist_loki_label_names — list available label names in logslist_loki_label_values — get unique values for a specific labelquery_loki_logs — execute LogQL queries for log entries or metric valuesquery_loki_stats — get statistics about log streamsquery_loki_patterns — detect and analyze common log patternsIf you have Tempo data sources, the Cloud MCP server proxies tools from the Tempo data source, including TraceQL queries and attribute discovery.
list_pyroscope_label_names — list available label names in profileslist_pyroscope_label_values — list values for a specific labellist_pyroscope_profile_types — list available profile typesquery_pyroscope — query profiles or metrics from Pyroscopelist_clickhouse_tables — list available tables with metadatadescribe_clickhouse_table — get column schema for a tablequery_clickhouse — execute SQL queries against ClickHouse datasourceslist_cloudwatch_namespaces — list available AWS namespaceslist_cloudwatch_metrics — list metrics for a namespacelist_cloudwatch_dimensions — list dimension keys for a metricquery_cloudwatch — query AWS CloudWatch metricsquery_elasticsearch — execute Lucene or Query DSL searchesalerting_manage_rules — list, filter, create, and update alert rules (Read / Write)alerting_manage_routing — view routing configuration, notification policies, contact points (Read)get_annotations — fetch annotations filtered by dashboard UID, time range, or tagsget_annotation_tags — get annotation tags with optional filteringcreate_annotation — create a new annotation (Write)update_annotation — update an existing annotation (Write)list_incidents — list incidents with optional status filteringget_incident — get full incident details by IDcreate_incident — create a new incident (Write)add_activity_to_incident — add a note to an incident's timeline (Write)list_oncall_schedules — list OnCall schedules with optional team filteringget_oncall_shift — get detailed shift informationget_current_oncall_users — get users currently on-call for a schedulelist_oncall_teams — list OnCall teamslist_oncall_users — list OnCall users with optional filteringlist_alert_groups — list alert groups with filteringget_alert_group — get a specific alert group by IDlist_sift_investigations — list Sift investigationsget_sift_investigation — retrieve a Sift investigation by UUIDget_sift_analysis — retrieve a specific analysis from an investigationfind_error_pattern_logs — search Loki logs for elevated error patterns (Write)find_slow_requests — search Tempo datasources for slow requests (Write)ask_assistant — send a prompt to Grafana Assistant and get the full reply (Write)get_assertions — get assertion summary for an entityget_panel_image — render a dashboard panel as a PNG imagedescribe_infrastructure — retrieve pre-built summaries of service groupsget_query_examples — get example queries for datasource typesask_assistant to let Grafana Assistant plan the investigation and return a grounded reply. ask_assistant is write-scoped and requires grafana:write.ask_assistant is unavailable. Fall back to the appropriate read-only tools (for example describe_infrastructure, get_assertions, query_prometheus, query_loki_logs, list_incidents) and tell the user that the natural-language Assistant tool needs write scope. Re-authorizing only grants write if the user has the Assistant Admin role or the grafana-assistant-app.cloud-mcp.scope:write permission; otherwise a Grafana organization administrator must grant it first.ask_assistant.get_dashboard_summary instead of get_dashboard_by_uid to avoid consuming context with full dashboard JSON.get_dashboard_property with JSONPath to extract only the specific parts you need.search_dashboards to discover dashboards before retrieving by UID.generate_deeplink to provide clickable URLs rather than describing navigation steps.list_datasources, list_prometheus_metric_names) before writing queries.update_dashboard, create_incident, alerting_manage_rules) unless explicitly asked by the user.grafana-assistant-app.cloud-mcp:access permission. Editor and higher have this by default; other roles can be granted it explicitly.grafana:write OAuth scope, granted during OAuth consent. Granting that scope is itself gated by Grafana RBAC: the user needs the Assistant Admin role or the grafana-assistant-app.cloud-mcp.scope:write permission to authorize a write-scoped connection. Read-only access does not require it.