Grafana Cloud

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
GRAFANA_CLOUD_TOKENYesGrafana service account token for your Grafana Cloud stack Docs.

Setup

  1. Find your stack slug: Your Grafana Cloud stack URL looks like https://<stack>.grafana.net - the subdomain is the 'stack' parameter every tool requires. Free Grafana Cloud accounts include one stack.
  2. Create a service account: In your stack, go to Administration → Users and access → Service accounts, and create a service account with the Viewer role (Editor if you want to create annotations).
  3. Generate a token: Add a token to the service account and copy it to your .env as GRAFANA_CLOUD_TOKEN.
  4. Verify access: Run Search Dashboards with your stack slug.

Provider notes

  • Tokens are scoped to a single stack; pass that stack's slug as the 'stack' parameter on every call
  • Service account tokens are sent as 'Authorization: Bearer <token>'
  • These tools call the Grafana instance HTTP API (dashboards, folders, annotations, data sources) - not the Cloud portal API or hosted Loki/Prometheus endpoints

Provider API reference.

Tools

ToolAccessDescription
Search Dashboards<br /><code className="reference-identifier">grafana-cloud__search_dashboards</code>ReadSearch dashboards
Get Dashboard<br /><code className="reference-identifier">grafana-cloud__get_dashboard</code>ReadGet dashboard
List Folders<br /><code className="reference-identifier">grafana-cloud__list_folders</code>ReadList folders
List Annotations<br /><code className="reference-identifier">grafana-cloud__list_annotations</code>ReadList annotations
Create Annotation<br /><code className="reference-identifier">grafana-cloud__create_annotation</code>WriteCreate annotation
List Data Sources<br /><code className="reference-identifier">grafana-cloud__list_datasources</code>ReadList data sources

Verify the connection

Call a read tool such as grafana-cloud__search_dashboards with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.