Grafana Cloud

​

At a glance

• Availability: Experimental (how to enable).
• Authentication: API key.
• Connection: The key comes from GRAFANA_CLOUD_TOKEN.
• Provider documentation: Authentication reference.

​

Credentials

Set these per environment. See Connect an integration.

​

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

​

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.