Grafana Cloud MCP
for LuumenAI
Query your Grafana Cloud stack from the terminal, with changes approved first
Ask about metrics, logs, traces, dashboards, datasources, alerts, and incidents in an authorized Grafana Cloud stack without leaving your shell. Every tool here is classed as a write, so calls are previewed and held for your approval by default, then recorded. Administrators set that per tool. Connect with OAuth via dynamic client registration.
The Grafana Cloud MCP toolbox
118 tools: 0 read, 118 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- WriteAdd activity to incidentAdd a note (userNote activity) to an existing incident's timeline using its ID. Approval by default
- WriteAgento11y manage agentsRead the agent catalog of Grafana Agent Observability (the grafana-agento11y-app plugin): which agents send telemetry, what their system prompts and tools are, how their prompt versions evolved, and… Approval by default
- WriteAgento11y manage conversationsList, search, and fetch LLM conversations from Grafana Agent Observability (the grafana-agento11y-app plugin). Approval by default
- WriteAgento11y manage eval collectionsManage the curated conversations of Grafana Agent Observability (the grafana-agento11y-app plugin): bookmark conversations as saved conversations and group them into collections. Approval by default
- WriteAgento11y manage eval rulesManage the evaluation rules and guards of Grafana Agent Observability (the grafana-agento11y-app plugin): the configuration that decides when evaluators run. Approval by default
- WriteAgento11y manage evaluatorsManage the evaluator catalog of Grafana Agent Observability (the grafana-agento11y-app plugin): read evaluators, evaluator templates, and the judge model catalog, and create, test, or delete… Approval by default
- WriteAgento11y manage experimentsManage the offline experiments of Grafana Agent Observability (the grafana-agento11y-app plugin), their trials, and their scores. Approval by default
- WriteAgento11y manage generationsFetch a single LLM generation and its evaluation scores from Grafana Agent Observability (the grafana-agento11y-app plugin). Approval by default
- WriteAgento11y manage test suitesManage the test suites of Grafana Agent Observability (the grafana-agento11y-app plugin), their versions, and their test cases. Approval by default
- WriteAlerting manage routingManage Grafana alerting routing configuration, including notification policies, contact points and time intervals. Approval by default
- WriteAlerting manage rulesManage Grafana alert rules with full CRUD capabilities and filtering. Approval by default
- WriteAlerting manage silencesManage Grafana alerting silences. Approval by default
- WriteAnalyze loki labelsAudits a Loki label strategy and optionally diagnoses query performance. Approval by default
- WriteAsk assistantSend a message to Grafana Assistant and wait for the full text reply. Approval by default
- WriteCheck datasources healthCheck datasource health. Approval by default
- WriteCreate annotationCreate a new annotation on a dashboard or panel. Approval by default
- WriteCreate datasourceCreate a datasource. Approval by default
- WriteCreate folderCreate a Grafana folder. Approval by default
- WriteCreate incidentCreate a new Grafana incident. Approval by default
- WriteCreate investigationStart a Grafana Assistant investigation: an agentic, multi-step root-cause analysis across the stack's metrics, logs, traces, dashboards, and alerts. Approval by default
- WriteCreate snapshotCreate a Grafana snapshot from a full dashboard payload. Approval by default
- WriteDelete snapshotDelete a Grafana snapshot by snapshot key. Approval by default
- WriteDescribe athena tableGet column names for an Athena table. Approval by default
- WriteDescribe clickhouse tableGet column schema for a ClickHouse table. Approval by default
- WriteDescribe infrastructureStart here when users ask about their infrastructure, services, or architecture. Approval by default
- WriteDescribe snowflake tableGet column schema for a Snowflake table. Approval by default
- WriteGenerate deeplinkGenerate deeplink URLs for Grafana resources. Approval by default
- WriteGet alert groupGet a specific alert group from Grafana OnCall by its ID. Approval by default
- WriteGet annotationsFetch Grafana annotations using filters such as dashboard UID, time range and tags. Approval by default
- WriteGet annotation tagsReturns annotation tags with optional filtering by tag name. Approval by default
- WriteGet assertionsGet assertion summary for a given entity with its type, name, env, site, namespace, and a time range Approval by default
- WriteGet current oncall usersGet the list of users currently on-call for a specific Grafana OnCall schedule ID. Approval by default
- WriteGet dashboard by uidRetrieves the complete dashboard, including panels, variables, and settings, for a specific dashboard identified by its UID. Approval by default
- WriteGet dashboard panel queriesRetrieve panel queries from a Grafana dashboard. Approval by default
- WriteGet dashboard propertyGet specific parts of a dashboard using JSONPath expressions to minimize context window usage. Approval by default
- WriteGet dashboard summaryGet a compact summary of a dashboard including title\, panel count\, panel types\, variables\, and other metadata without the full JSON. Approval by default
- WriteGet datasourceRetrieves detailed information about a specific datasource by UID or name. Approval by default
- WriteGet incidentGet a single incident by ID. Approval by default
- WriteGet investigationGet one Grafana Assistant investigation (AI-driven root-cause investigation) by ID. Approval by default
- WriteGet investigation threadGet the working thread of one Grafana Assistant investigation (AI-driven root-cause investigation) by ID: the user-visible conversation between the investigation agent and its tools. Approval by default
- WriteGet oncall shiftGet detailed information for a specific Grafana OnCall shift using its ID. Approval by default
- WriteGet panel imageRender a Grafana dashboard panel or full dashboard as a PNG image. Approval by default
- WriteGet pluginCheck whether a Grafana plugin is installed and retrieve its details (name, version, type, enabled status). Approval by default
- WriteGet query examplesGet example queries for a specific datasource type. Approval by default
- WriteGet resource descriptionList available permissions and assignment capabilities for a Grafana resource type. Approval by default
- WriteGet resource permissionsList all permissions set on a specific Grafana resource (e.g., dashboard, datasource, folder) by its type and ID. Approval by default
- WriteGet role assignmentsList all assignments for a specific role, showing which users, teams, and service accounts have been assigned this role. Approval by default
- WriteGet role detailsGet detailed information about a specific Grafana role by its UID, including permissions, metadata, and configuration. Approval by default
- WriteGet snapshotGet a Grafana snapshot by key, including snapshot metadata and dashboard payload. Approval by default
- WriteGrafana api requestMake an authenticated HTTP request to the Grafana API. Approval by default
- WriteInstall pluginInstall a Grafana plugin by its plugin ID. Approval by default
- WriteList alert groupsList alert groups from Grafana OnCall with filtering options. Approval by default
- WriteList all rolesList all roles in Grafana. Approval by default
- WriteList athena catalogsSTART HERE for Athena: List available data catalogs (e.g. Approval by default
- WriteList athena databasesList databases in an Athena catalog. Approval by default
- WriteList athena tablesList tables in an Athena database. Approval by default
- WriteList clickhouse tablesSTART HERE for ClickHouse: List available tables (name, database, engine, row count, size). Approval by default
- WriteList cloudwatch dimensionsList dimension keys for a CloudWatch metric. Approval by default
- WriteList cloudwatch metricsList metrics for a CloudWatch namespace. Approval by default
- WriteList cloudwatch namespacesSTART HERE for CloudWatch: List available namespaces (AWS/EC2, AWS/ECS, AWS/RDS, etc.). Approval by default
- WriteList datasourcesList all configured datasources in Grafana. Approval by default
- WriteList graphite metricsDiscover available metric paths in a Graphite datasource by browsing the metric tree. Approval by default
- WriteList graphite tagsList available tag names in a Graphite datasource that uses tag-based metrics. Approval by default
- WriteList incidentsList Grafana incidents. Approval by default
- WriteList investigation evidenceList the evidence citation index for one Grafana Assistant investigation (AI-driven root-cause investigation) by ID. Approval by default
- WriteList investigation profilesList the agent profiles available for Grafana Assistant investigations (AI-driven root-cause investigations) on this Grafana Cloud stack. Approval by default
- WriteList investigationsList Grafana Assistant investigations (AI-driven root-cause investigations) on this Grafana Cloud stack. Approval by default
- WriteList loki label namesLists all available label/field names (keys) found in logs within a specified Loki or VictoriaLogs datasource and time range. Approval by default
- WriteList loki label valuesRetrieves all unique values associated with a specific `labelName` within a Loki or VictoriaLogs datasource and time range. Approval by default
- WriteList oncall schedulesList Grafana OnCall schedules, optionally filtering by team ID. Approval by default
- WriteList oncall teamsList teams configured in Grafana OnCall. Approval by default
- WriteList oncall usersList users from Grafana OnCall. Approval by default
- WriteList prometheus label namesList label names in a PromQL-compatible datasource (Prometheus, Thanos, Mimir, Cloud Monitoring, etc.). Approval by default
- WriteList prometheus label valuesUse after list_prometheus_metric_names to find label values for filtering queries. Approval by default
- WriteList prometheus metric metadataList Prometheus metric metadata. Approval by default
- WriteList prometheus metric namesDISCOVERY: Call this first to find available metrics before querying. Approval by default
- WriteList pyroscope label namesLists all available label names (keys) found in profiles within a specified Pyroscope datasource, time range, and optional label matchers. Approval by default
- WriteList pyroscope label valuesLists all available label values for a particular label name found in profiles within a specified Pyroscope datasource, time range, and optional label matchers. Approval by default
- WriteList pyroscope profile typesLists all available profile types available in a specified Pyroscope datasource and time range. Approval by default
- WriteList snapshotsList Grafana dashboard snapshots with optional query and result limit filters. Approval by default
- WriteList snowflake tablesSTART HERE for Snowflake: List available tables (database, schema, name, kind, row count, size) via INFORMATION_SCHEMA. Approval by default
- WriteList team rolesList all roles assigned to one or more teams. Approval by default
- WriteList teamsSearch for Grafana teams by a query string. Approval by default
- WriteList user rolesList all roles assigned to one or more users. Approval by default
- WriteList users by orgList users in the Grafana organization. Approval by default
- WriteQuery athenaQuery Amazon Athena via Grafana. Approval by default
- WriteQuery clickhouseQuery ClickHouse via Grafana. Approval by default
- WriteQuery cloudwatchQuery AWS CloudWatch metrics via Grafana. Approval by default
- WriteQuery elasticsearchExecutes a search query against an Elasticsearch or OpenSearch datasource and retrieves matching documents. Approval by default
- WriteQuery graphiteWORKFLOW: list_graphite_metrics -> query_graphite. Approval by default
- WriteQuery graphite densityAnalyses metric data density for one or more Graphite series over a time window. Approval by default
- WriteQuery influxdbQuery an InfluxDB datasource via Grafana. Approval by default
- WriteQuery loki logsExecutes a log query against a Loki or VictoriaLogs datasource and returns matching log entries (or metric samples on Loki). Approval by default
- WriteQuery loki patternsRetrieves detected log patterns from a Loki datasource for a given stream selector and time range. Approval by default
- WriteQuery loki statsRetrieves index-level statistics about log streams matching a given selector within a Loki or VictoriaLogs datasource and time range. Approval by default
- WriteQuery prometheusWORKFLOW: list_prometheus_metric_names -> list_prometheus_label_values -> query_prometheus. Approval by default
- WriteQuery prometheus histogramQuery Prometheus histogram percentiles. Approval by default
- WriteQuery pyroscopeUnified Pyroscope query tool for fetching profiles or metrics from Pyroscope. Approval by default
- WriteQuery quickwitExecutes a search query against a Quickwit datasource and retrieves matching documents. Approval by default
- WriteQuery snowflakeQuery Snowflake via Grafana. Approval by default
- WriteRun panel queryExecutes one or more dashboard panel queries with optional time range and variable overrides. Approval by default
- WriteSearch dashboardsSearch for Grafana dashboards by a query string. Approval by default
- WriteSearch foldersSearch for Grafana folders by a query string. Approval by default
- WriteSearch plugin informationSearch the Grafana plugin catalog by keyword to discover available plugins before installing or getting plugin details on a specific instance. Approval by default
- WriteSuggest loki alloy label configGenerates an Alloy loki.process snippet enforcing an approved label set via stage.label_keep, with optional log-level normalisation and soft-enforcement placeholders. Approval by default
- WriteTempo docs-configDocumentation on Tempo configuration. Approval by default
- WriteTempo docs-traceqlDocumentation on TraceQL search. Approval by default
- WriteTempo get-attribute-namesGet a list of available attribute names that can be used in TraceQL queries. Approval by default
- WriteTempo get-attribute-valuesGet a list of values for a fully scoped attribute name. Approval by default
- WriteTempo get-traceRetrieve a specific trace by ID Approval by default
- WriteTempo traceql-metrics-instantRetrieve a single metric value given a TraceQL metrics query. Approval by default
- WriteTempo traceql-metrics-rangeRetrieve a metric series given a TraceQL metrics query. Approval by default
- WriteTempo traceql-searchSearch for traces using TraceQL queries Approval by default
- WriteUpdate alert groupUpdate the state of a Grafana OnCall alert group: acknowledge, unacknowledge, resolve, or unresolve it by ID. Approval by default
- WriteUpdate annotationUpdates the provided properties of an annotation by ID. Approval by default
- WriteUpdate dashboardCreate or update a dashboard. Approval by default
- WriteUpdate datasourceUpdate non-secret datasource fields by UID. Approval by default
- WriteUpdate incidentUpdate an existing Grafana incident by ID. Approval by default
Questions
How does LuumenAI connect to Grafana Cloud MCP?
Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Grafana Cloud MCP on its own?
Read actions answer immediately. Anything that writes — add activity to incident, agento11y manage agents, agento11y manage conversations, agento11y manage eval collections, and more — is shown as a plan and requires approval by default. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Grafana Cloud MCP — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
Adobe Marketing Agent MCPAdobe Experience Platform context, sandbox switches, and async task status
AffindaRead parsed documents, collections, and annotations — change them with approval
Agent MailGive the agent its own mailbox for reading threads and sending updates
AI/ML APIInspect assistants, threads, and runs — and change them as approved stepsPut Grafana Cloud MCP to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.