Grafana Cloud

At a glance

Set these per environment. See Connect an integration.

Variable	Required	Description
`GRAFANA_CLOUD_TOKEN`	Yes	Grafana service account token for your Grafana Cloud stack Docs.

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.
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).
Generate a token: Add a token to the service account and copy it to your .env as GRAFANA_CLOUD_TOKEN.
Verify access: Run Search Dashboards with your stack slug.

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

Tool	Access	Description
Search Dashboards	Read	Search dashboards and folders in the Grafana stack
Get Dashboard	Read	Get a dashboard’s full JSON model by UID
List Folders	Read	List dashboard folders in the Grafana stack
List Annotations	Read	List annotations and alert events in a time range
Create Annotation	Write	Create an annotation (e.g. mark a deploy) on a dashboard or globally
List Data Sources	Read	List data sources configured in the Grafana stack

Search my Grafana Cloud stack for dashboards about latency and list their titles and folders.
List the annotations in my Grafana stack from the last 24 hours and summarize any alert events.