At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key comes from
GRAFANA_CLOUD_TOKEN. - Docs: https://grafana.com/docs/grafana/latest/developers/http_api/auth/
Credentials
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. |
Setup
- 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
Tools
| 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 |
Example prompts
- 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.