> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Grafana Cloud

> Search Grafana Cloud dashboards, folders, annotations, and data sources

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key comes from `GRAFANA_CLOUD_TOKEN`.
* **Docs**: [https://grafana.com/docs/grafana/latest/developers/http\_api/auth/](https://grafana.com/docs/grafana/latest/developers/http_api/auth/)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable              | Required | Description                                                                                                                                  |
| --------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `GRAFANA_CLOUD_TOKEN` | Yes      | Grafana service account token for your Grafana Cloud stack [Docs](https://grafana.com/docs/grafana/latest/administration/service-accounts/). |

## 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.

* 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: [https://grafana.com/docs/grafana/latest/developers/http\_api/](https://grafana.com/docs/grafana/latest/developers/http_api/)

## 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.