Skip to main content

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.
  • 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/

Tools

ToolAccessDescription
Search DashboardsReadSearch dashboards and folders in the Grafana stack
Get DashboardReadGet a dashboard’s full JSON model by UID
List FoldersReadList dashboard folders in the Grafana stack
List AnnotationsReadList annotations and alert events in a time range
Create AnnotationWriteCreate an annotation (e.g. mark a deploy) on a dashboard or globally
List Data SourcesReadList 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.