grafana-mcp-adapter
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GRAFANA_TOKEN | Yes | A Grafana service account token with read-only permissions. | |
| GRAFANA_BASE_URL | Yes | The base URL of the Grafana instance (e.g., https://grafana.example.com). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| grafana_healthA | Read-only Grafana health/config check. |
| grafana_search_dashboardsA | Read-only search of Grafana dashboards (by title substring and/or tags). Returns uid, title, folder, tags and url for each. Use the uid with grafana_get_dashboard to fetch the full dashboard JSON. |
| grafana_get_dashboardA | Read-only fetch of a Grafana dashboard's full JSON by uid (panels, variables, queries, meta). Get the uid from grafana_search_dashboards. |
| grafana_list_datasourcesA | Read-only list of configured Grafana datasources. Returns uid, name, type and is_default. Use a datasource uid with grafana_query. |
| grafana_queryA | Read-only metric/log query via Grafana's /api/ds/query. Provide the datasource uid (from grafana_list_datasources), a raw expression (PromQL for Prometheus, LogQL for Loki, etc.), and an optional time range. By default returns a compact per-series digest (labels + count/first/last/min/max/avg); pass raw=true for the full (potentially very large) frames. |
| grafana_logs_linkA | Read-only: build a permanent Grafana Explore (Loki) link for a customer's logs AND return a preview of the most recent lines. Identify the customer/component with free text (e.g. client='april', component='gateway') — it matches case-insensitively against the |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a distinct Grafana operation: health check, datasource listing, dashboard search and retrieval, general querying, and a specialized logs link builder. No functional overlap exists.
All tools share the 'grafana_' prefix and mostly follow a verb_noun pattern (get_dashboard, list_datasources, search_dashboards). Exceptions like 'health' (noun) and 'logs_link' (noun_noun) are minor inconsistencies within an otherwise coherent scheme.
With 6 tools, the server covers the essential read-only Grafana operations without being excessive. Each tool serves a clear purpose and earns its place.
The set covers core read-only functionality: health, datasources, dashboards, querying, and logs linking. Missing are alerting and annotations, but the surface is complete for common exploration tasks and tools are well-connected (e.g., search_dashboards feeds get_dashboard).