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

# Grafana

> How to set up the Grafana connector, plus the actions and events that are available.

![Grafana](https://stackone-logos.com/api/grafana/filled/svg)

Previewv3.0.0[See changelog](https://docs.stackone.com/connectors/grafana/changelog.md)

[239 actions](#actions) · [19 events](#events) · 3 auth methods

Observability
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [MCP (OAuth) · Connector Profile](https://docs.stackone.com/connectors/grafana/guides/connector-profile/mcp-oauth.md)
>
> Authorize through the MCP server. Endpoints and client registration are discovered at connect time.

> [card] [Service Account Token · Connector Profile](https://docs.stackone.com/connectors/grafana/guides/connector-profile/service-account-token.md)
>
> Connect using a Grafana Service Account Token with appropriate permissions

> [card] [Basic Authentication · Connector Profile](https://docs.stackone.com/connectors/grafana/guides/connector-profile/basic-authentication.md)
>
> For self-hosted Grafana only, as Grafana Cloud does not accept basic auth on its HTTP API. Uses a Grafana user's usernam...

Optionally, configure receiving Events for Grafana into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/grafana/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [MCP (OAuth) · Link Account](https://docs.stackone.com/connectors/grafana/guides/link-account/mcp-oauth.md)

> [card] [Service Account Token · Link Account](https://docs.stackone.com/connectors/grafana/guides/link-account/service-account-token.md)

> [card] [Basic Authentication · Link Account](https://docs.stackone.com/connectors/grafana/guides/link-account/basic-authentication.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

Basic Authentication

MCP (OAuth)

Service Account Token

No auth methods found

Scopes

Select all
|
Clear

alert.provisioning:read

alert.provisioning:write

alert.rules:read

alert.rules:write

annotations:read

annotations:write

dashboards.permissions:read

dashboards.permissions:write

dashboards:read

dashboards:write

datasources:read

datasources:write

folders.permissions:read

folders.permissions:write

folders:read

folders:write

library.panels:read

library.panels:write

org.users:read

org.users:write

orgs:read

orgs:write

playlists:read

playlists:write

serviceaccounts:read

serviceaccounts:write

snapshots:read

snapshots:write

teams.permissions:read

teams.permissions:write

teams:read

teams:write

No scopes found

239 actions

ActionDescriptionRequired scopes

List Alert Rules`grafana_list_alert_rules`

Retrieve all provisioned alert rules

`alert.rules:read`

Get Alert Rule`grafana_get_alert_rule`

Retrieve a specific alert rule by its UID

`alert.rules:read`

Create Alert Rule`grafana_create_alert_rule`

Create a new alert rule

`alert.rules:write`

Update Alert Rule`grafana_update_alert_rule`

Update an existing alert rule by its UID

`alert.rules:write`

Delete Alert Rule`grafana_delete_alert_rule`

Delete an alert rule by its UID

`alert.rules:write`

List Contact Points`grafana_list_contact_points`

Retrieve all alert notification contact points

`alert.provisioning:read`

Create Contact Point`grafana_create_contact_point`

Create a new alert notification contact point

`alert.provisioning:write`

Delete Contact Point`grafana_delete_contact_point`

Delete an alert notification contact point by its UID

`alert.provisioning:write`

Get Notification Policies`grafana_get_notification_policies`

Retrieve the notification policy tree

`alert.provisioning:read`

List Mute Timings`grafana_list_mute_timings`

Retrieve all mute timing configurations

`alert.provisioning:read`

Get Mute Timing`grafana_get_mute_timing`

Retrieve a specific mute timing by its name

`alert.provisioning:read`

Create Mute Timing`grafana_create_mute_timing`

Create a new mute timing configuration

`alert.provisioning:write`

Update Mute Timing`grafana_update_mute_timing`

Update an existing mute timing configuration by its name

`alert.provisioning:write`

Delete Mute Timing`grafana_delete_mute_timing`

Delete a mute timing by its name

`alert.provisioning:write`

Update Contact Point`grafana_update_contact_point`

Update an existing alert notification contact point by its UID

`alert.provisioning:write`

Update Notification Policies`grafana_update_notification_policies`

Update the notification policy tree

`alert.provisioning:write`

List Annotations`grafana_list_annotations`

Retrieve annotations filtered by time range, tags, dashboard, or user

`annotations:read`

Create Annotation`grafana_create_annotation`

Create a new annotation on a dashboard or organization-wide

`annotations:write`

Update Annotation`grafana_update_annotation`

Update an existing annotation by its ID

`annotations:write`

Delete Annotation`grafana_delete_annotation`

Delete an annotation by its ID

`annotations:write`

List Annotation Tags`grafana_list_annotation_tags`

Retrieve all tags used in annotations

`annotations:read`

Search Dashboards`grafana_search_dashboards`

Search for dashboards and folders by query, tags, or type

`dashboards:read`

Get Dashboard`grafana_get_dashboard`

Retrieve a dashboard by its UID

`dashboards:read`

Get Dashboard Permissions`grafana_get_dashboard_permissions`

Retrieve all permissions for a dashboard

`dashboards.permissions:read`

Update Dashboard Permissions`grafana_update_dashboard_permissions`

Update permissions for a dashboard

`dashboards.permissions:write`

List Dashboard Versions`grafana_list_dashboard_versions`

Retrieve all versions of a dashboard

`dashboards:read`

Get Dashboard Version`grafana_get_dashboard_version`

Retrieve a specific version of a dashboard

`dashboards:read`

Create Dashboard`grafana_create_dashboard`

Create or update a dashboard

`dashboards:write`

Delete Dashboard`grafana_delete_dashboard`

Delete a dashboard by its UID

`dashboards:write`

Star Dashboard`grafana_star_dashboard`

Star a dashboard for the authenticated user

`dashboards:read`

Unstar Dashboard`grafana_unstar_dashboard`

Remove a star from a dashboard for the authenticated user

`dashboards:read`

Get Home Dashboard`grafana_get_home_dashboard`

Retrieve the home dashboard for the current organization

`dashboards:read`

List Dashboard Tags`grafana_list_dashboard_tags`

Retrieve all dashboard tags in the Grafana instance

`dashboards:read`

List Data Sources`grafana_list_datasources`

Retrieve all data sources configured in the Grafana instance

`datasources:read`

Get Data Source`grafana_get_datasource`

Retrieve a specific data source by its UID

`datasources:read`

Create Data Source`grafana_create_datasource`

Create a new data source in Grafana

`datasources:write`

Update Data Source`grafana_update_datasource`

Update an existing data source by its UID

`datasources:write`

Delete Data Source`grafana_delete_datasource`

Delete a data source by its UID

`datasources:write`

List Correlations`grafana_list_correlations`

Retrieve all correlations across data sources

`datasources:read`

Create Correlation`grafana_create_correlation`

Create a new correlation between two data sources

`datasources:write`

Delete Correlation`grafana_delete_correlation`

Delete a correlation by its UID

`datasources:write`

List Folders`grafana_list_folders`

Retrieve all folders the authenticated user has permission to view

`folders:read`

Get Folder`grafana_get_folder`

Retrieve a specific folder by its UID

`folders:read`

Create Folder`grafana_create_folder`

Create a new folder for organizing dashboards

`folders:write`

Update Folder`grafana_update_folder`

Update an existing folder's title

`folders:write`

Delete Folder`grafana_delete_folder`

Delete a folder and all its dashboards

`folders:write`

Get Folder Permissions`grafana_get_folder_permissions`

Retrieve all permissions for a folder

`folders.permissions:read`

Update Folder Permissions`grafana_update_folder_permissions`

Update permissions for a folder

`folders.permissions:write`

Get Unified Credentials`grafana_unified_get_me`

Get the current Grafana connection's unified credentials and identity.

List Unified Groups`grafana_unified_list_groups`

List unified groups in Grafana.

`teams:read`

Get Unified Group`grafana_unified_get_group`

Get a unified Grafana group by ID.

`teams:read`

List Unified Organizations`grafana_unified_list_organizations`

List unified organizations in Grafana.

`orgs:read`

Get Unified Organization`grafana_unified_get_organization`

Get a unified Grafana organization by ID.

`orgs:read`

List Unified Resource Types`grafana_unified_list_resource_types`

List unified resource types in Grafana.

`orgs:read`

List Unified Resource Users`grafana_unified_list_resource_users`

List unified resource users in Grafana.

`teams.permissions:read`

List Unified Roles`grafana_unified_list_roles`

List unified roles in Grafana.

`orgs:read`

Get Unified Role`grafana_unified_get_role`

Get a unified Grafana role by ID.

`orgs:read`

List Unified Users`grafana_unified_list_users`

List unified users in Grafana.

`org.users:read`

Get Unified User`grafana_unified_get_user`

Get a unified Grafana user by ID.

`org.users:read`

Add Activity To Incident`grafana_add_activity_to_incident`

Add a note (userNote activity) to an existing incident's timeline using its ID. The note body can include URLs which wil...

Manage Agent Observability Agents`grafana_agento11y_manage_agents`

Read the agent catalog of Grafana Agent Observability (the grafana-agento11y-app plugin): which agents send telemetry, w\...

Manage Agent Observability Conversations`grafana_agento11y_manage_conversations`

List, search, and fetch LLM conversations from Grafana Agent Observability (the grafana-agento11y-app plugin). Operation...

Manage Agent Observability Saved Conversations And Collections`grafana_agento11y_manage_eval_collections`

Manage the curated conversations of Grafana Agent Observability (the grafana-agento11y-app plugin): bookmark conversatio...

Manage Agent Observability Eval Rules And Guards`grafana_agento11y_manage_eval_rules`

Manage the evaluation rules and guards of Grafana Agent Observability (the grafana-agento11y-app plugin): the configurat...

Manage Agent Observability Evaluators`grafana_agento11y_manage_evaluators`

Manage the evaluator catalog of Grafana Agent Observability (the grafana-agento11y-app plugin): read evaluators, evaluat...

Manage Agent Observability Experiments`grafana_agento11y_manage_experiments`

Manage the offline experiments of Grafana Agent Observability (the grafana-agento11y-app plugin), their trials, and thei...

Manage Agent Observability Generations`grafana_agento11y_manage_generations`

Fetch a single LLM generation and its evaluation scores from Grafana Agent Observability (the grafana-agento11y-app plug...

Manage Agent Observability Test Suites`grafana_agento11y_manage_test_suites`

Manage the test suites of Grafana Agent Observability (the grafana-agento11y-app plugin), their versions, and their test...

Manage Alerting Routing`grafana_alerting_manage_routing`

Manage Grafana alerting routing configuration, including notification policies, contact points and time intervals. Notif...

Write Alerting Routing`grafana_alerting_routing_write`

Create Grafana-managed contact points for alert notifications using operation 'create\_contact\_point'. Requires name, typ...

Read Alert Rules`grafana_alerting_rules_read`

List and inspect Grafana alert rules with filtering capabilities. When to use: - Understanding why an alert is or isn't...

Write Alert Rules`grafana_alerting_rules_write`

Create, update, and delete Grafana alert rules. When to use: - Creating, updating, or deleting alert rules Operation 'up...

Read Alerting Silences`grafana_alerting_silences_read`

List and inspect Grafana alerting silences. A silence temporarily suppresses notifications for alerts whose labels match...

Write Alerting Silences`grafana_alerting_silences_write`

Create, update, and delete Grafana alerting silences. A silence temporarily suppresses notifications for alerts whose la...

Analyze Loki Label Strategy`grafana_analyze_loki_labels`

Audits a Loki label strategy and optionally diagnoses query performance. Returns per-label verdicts, missing base labels...

Application Observability Services`grafana_app_observability_handler`

Inspect Application Observability services on this Grafana stack. Commands: list finds services across Knowledge Graph s...

Application Observability Operations`grafana_app_observability_operation_handler`

Inspect Application Observability operations on this Grafana stack. Commands: top ranks operations across services by la...

Ask Grafana Assistant`grafana_ask_assistant`

Send a message to Grafana Assistant and wait for the full text reply. The assistant may use tools, metrics, logs, and ot...

Assistant Search`grafana_assistant_search`

Historical/indexed memory search across your Grafana stack: infrastructure/service groups, dashboards, past investigatio...

Check Datasources Health`grafana_check_datasources_health`

Check datasource health. Filter by type or UIDs; omit both to check all.

Create Alert Rule`grafana_create_alert_creation`

Save the exact draft after the user's Create alert rule action. Retain ruleUid for status checks. Never automatically re...

Create Annotation`grafana_mcp_create_annotation`

Create a new annotation on a dashboard or panel. Set format to 'graphite' and provide 'what' for Graphite-format annotat...

Create Datasource`grafana_mcp_create_datasource`

Create a datasource in two steps. Called with only the type, it returns the fields to fill in and creates nothing. Calle...

Create Folder`grafana_mcp_create_folder`

Create a Grafana folder. Provide a title and optional UID. Returns the created folder.

Create Incident`grafana_create_incident`

Create a new Grafana incident. Requires title, severity, and room prefix. Allows setting status, labels and custom field...

Create Assistant Investigation`grafana_create_investigation`

Start a Grafana Assistant investigation: an agentic, multi-step root-cause analysis across the stack's metrics, logs, tr...

Create Snapshot`grafana_mcp_create_snapshot`

Create a Grafana snapshot from a full dashboard payload. Supports optional expiration and external snapshot fields.

Delete Annotation`grafana_mcp_delete_annotation`

Permanently delete an annotation by ID. The annotation cannot be recovered afterwards.

Delete Snapshot`grafana_mcp_delete_snapshot`

Delete a Grafana snapshot by snapshot key.

Describe SQL Table`grafana_describe_sql_table`

Describe SQL columns: names, types, and available metadata. BigQuery includes nested field paths and descriptions; schem...

Diff Tempo Traces`grafana_diff_tempo_traces`

Compare two complete traces. Returns a compact summary and includes the full span-level patch when it is at most 64 KiB....

Frontend Observability`grafana_frontend_observability_handler`

Manage Frontend Observability apps and inspect their browser telemetry on this Grafana stack. Commands: list returns pag...

Generate Navigation Deeplink`grafana_generate_deeplink`

Generate deeplink URLs for Grafana resources. Supports dashboards (requires dashboardUid or provisioningPreview), panels...

Get IRM Alert Group`grafana_get_alert_group`

Get a specific alert group from Grafana OnCall by its ID. Returns the full alert group details, including the most recen...

Get Annotation Tags`grafana_get_annotation_tags`

Returns annotation tags with optional filtering by tag name. Only the provided filters are applied.

Get Annotations`grafana_get_annotations`

Fetch Grafana annotations using filters such as dashboard UID, time range and tags.

Get Assertions Summary`grafana_get_assertions`

Get assertion summary for a given entity with its type, name, env, site, namespace, and a time range

Read Grafana Assistant Conversation`grafana_get_assistant_conversation`

Read the transcript of an existing Grafana Assistant conversation by ID. Covers conversations started anywhere, includin...

Get Current On-call Users`grafana_get_current_oncall_users`

Get the list of users currently on-call for a specific Grafana OnCall schedule ID. Returns the schedule ID, name, and a...

Get Dashboard Details`grafana_get_dashboard_by_uid`

Retrieves the complete dashboard, including panels, variables, and settings, for a specific dashboard identified by its...

Get Dashboard Panel Queries`grafana_get_dashboard_panel_queries`

Retrieve panel queries from a Grafana dashboard. Supports all datasource types (Prometheus, Loki, CloudWatch, SQL, etc.)...

Get Dashboard Property`grafana_get_dashboard_property`

Get specific parts of a dashboard using JSONPath expressions to minimize context window usage. JSONPath targets the dash...

Get Dashboard Summary`grafana_get_dashboard_summary`

Get a compact summary of a dashboard including title, panel count, panel types, variables, and other metadata without th...

Get Datasource`grafana_mcp_get_datasource`

Retrieves detailed information about a specific datasource by UID or name. Returns the full datasource model, including...

Get Doc`grafana_get_doc`

Fetch a Grafana documentation page. Set outline\_only=true to get the heading structure first, then call again with a sec...

Get Incident Details`grafana_get_incident`

Get a single incident by ID. Returns the full incident details including title, status, severity, labels, custom fields,...

Get Investigation`grafana_get_investigation`

Get one Grafana Assistant investigation (AI-driven root-cause investigation) by ID. Returns the investigation's identifi...

Get Investigation Report`grafana_get_investigation_report`

Read the report of one Grafana Assistant investigation (AI-driven root-cause investigation) as markdown. Returns the rep...

Get Investigation Thread`grafana_get_investigation_thread`

Get the working thread of one Grafana Assistant investigation (AI-driven root-cause investigation) by ID: the user-visib...

Get OnCall Shift`grafana_get_oncall_shift`

Get detailed information for a specific Grafana OnCall shift using its ID. A shift represents a designated time period w\...

Get Panel Or Dashboard Image`grafana_get_panel_image`

Render a Grafana dashboard panel, full dashboard or Explore view as a PNG image. Returns the image as base64 encoded dat...

Get Plugin`grafana_get_plugin`

Check whether a Grafana plugin is installed and retrieve its details (name, version, type, enabled status). Returns inst...

Get Query Examples`grafana_get_query_examples`

Get example queries for a specific datasource type. Provides sample queries with descriptions for Prometheus (PromQL), L...

Get Resource Description`grafana_get_resource_description`

List available permissions and assignment capabilities for a Grafana resource type.

Get Resource Permissions`grafana_get_resource_permissions`

List all permissions set on a specific Grafana resource (e.g., dashboard, datasource, folder) by its type and ID.

Get Role Assignments`grafana_get_role_assignments`

List all assignments for a specific role, showing which users, teams, and service accounts have been assigned this role.

Get Role Details`grafana_get_role_details`

Get detailed information about a specific Grafana role by its UID, including permissions, metadata, and configuration.

Get Snapshot`grafana_mcp_get_snapshot`

Get a Grafana snapshot by key, including snapshot metadata and dashboard payload.

Get Tempo Trace`grafana_get_tempo_trace`

Retrieve a specific trace by ID. Returns its spans grouped by service and resource, with span attributes, events and lin...

Get TraceQL Documentation`grafana_get_tempo_traceql_docs`

Retrieve TraceQL reference documentation with examples, covering attribute filters, aggregates, structural operators, an...

Grafana API Request`grafana_api_request`

Make an authenticated HTTP request to the Grafana API. Supports any Grafana API endpoint with optional jq-style response...

Install Plugin`grafana_install_plugin`

Install a Grafana plugin by its plugin ID. When version is omitted, the tool looks up the latest version and returns it...

Kubernetes Monitoring`grafana_kubernetes_handler`

Inspect the Kubernetes Monitoring inventory on this Grafana stack. The read-only list and get commands resolve the same...

List IRM Alert Groups`grafana_list_alert_groups`

List alert groups from Grafana OnCall with filtering options. Supports filtering by alert group ID, route ID, integratio...

List All Roles`grafana_list_all_roles`

List all roles in Grafana. Optionally filter to show only roles that can be delegated by the current user. Returns role...

List CloudWatch Dimension Values`grafana_list_cloudwatch_dimension_values`

List values for a CloudWatch dimension key (e.g. the specific cluster names behind a ClusterName dimension). Requires re...

List CloudWatch Dimensions`grafana_list_cloudwatch_dimensions`

List dimension keys for a CloudWatch metric. Requires region. Supports cross-account monitoring via optional accountId p...

List CloudWatch Log Group Fields`grafana_list_cloudwatch_log_group_fields`

List the fields discovered in a CloudWatch log group, for use in Logs Insights queries. Requires region.

List CloudWatch Log Groups`grafana_list_cloudwatch_log_groups`

List CloudWatch log group names, optionally filtered by name prefix. Returns at most 50 log groups; use prefix to narrow\...

List CloudWatch Metrics`grafana_list_cloudwatch_metrics`

List metrics for a CloudWatch namespace. Requires region. Supports cross-account monitoring via optional accountId param...

List CloudWatch Namespaces`grafana_list_cloudwatch_namespaces`

List available CloudWatch namespaces (AWS/EC2, AWS/ECS, AWS/RDS, etc.). Requires region. Supports cross-account monitori...

List Dashboard Versions`grafana_mcp_list_dashboard_versions`

List saved versions of a Grafana dashboard. Returns compact metadata: version number, author, timestamp, and save messag...

List Datasources`grafana_mcp_list_datasources`

List all configured datasources in Grafana. Use this to discover available datasources and their UIDs. Supports filterin...

List Graphite Metrics`grafana_list_graphite_metrics`

Discover available metric paths in a Graphite datasource by browsing the metric tree. Returns nodes matching the query p...

List Graphite Tags`grafana_list_graphite_tags`

List available tag names in a Graphite datasource that uses tag-based metrics. Returns a list of tag name strings (e.g....

List Incident Custom Fields`grafana_list_incident_custom_fields`

List the custom fields configured for Grafana incidents, including their type and, for select fields, the options that m...

List Incidents`grafana_list_incidents`

List Grafana incidents. Allows filtering by status ('active', 'resolved') and optionally including drill incidents. Retu...

List Investigation Evidence`grafana_list_investigation_evidence`

List the evidence citation index for one Grafana Assistant investigation (AI-driven root-cause investigation) by ID. Inv...

List Investigation Profiles`grafana_list_investigation_profiles`

List the agent profiles available for Grafana Assistant investigations (AI-driven root-cause investigations) on this Gra...

List Investigations`grafana_list_investigations`

List Grafana Assistant investigations (AI-driven root-cause investigations) on this Grafana Cloud stack. Returns one sum...

List Loki Label Names`grafana_list_loki_label_names`

Lists all available label/field names (keys) found in logs within a specified Loki or VictoriaLogs datasource and time r...

List Loki Label Values`grafana_list_loki_label_values`

Retrieves all unique values associated with a specific `labelName` within a Loki or VictoriaLogs datasource and time ran...

List OnCall Schedules`grafana_list_oncall_schedules`

List Grafana OnCall schedules, optionally filtering by team ID. If a specific schedule ID is provided, retrieves details...

List OnCall Teams`grafana_list_oncall_teams`

List teams configured in Grafana OnCall. Returns a list of team objects with their details. Supports pagination.

List OnCall Users`grafana_list_oncall_users`

List users from Grafana OnCall. These are OnCall users (separate from Grafana users). Can retrieve all users in the OnCa...

List Prometheus Label Names`grafana_list_prometheus_label_names`

List label names in a PromQL-compatible datasource (Prometheus, Thanos, Mimir, Cloud Monitoring, etc.). Allows filtering...

List Prometheus Label Values`grafana_list_prometheus_label_values`

Gets the values for a specific label name in a PromQL-compatible datasource (Prometheus, Thanos, Mimir, Cloud Monitoring...

List Prometheus Metric Metadata`grafana_list_prometheus_metric_metadata`

List Prometheus metric metadata. Returns metadata about metrics currently scraped from targets. Note: This endpoint is e...

List Prometheus Metric Names`grafana_list_prometheus_metric_names`

Lists metric names in a PromQL-compatible datasource (Prometheus, Thanos, Mimir, Cloud Monitoring, etc.). Filters metric...

List Pyroscope Label Names`grafana_list_pyroscope_label_names`

Lists all available label names (keys) found in profiles within a specified Pyroscope datasource, time range, and option...

List Pyroscope Label Values`grafana_list_pyroscope_label_values`

Lists all available label values for a particular label name found in profiles within a specified Pyroscope datasource,...

List Pyroscope Profile Types`grafana_list_pyroscope_profile_types`

Lists all available profile types available in a specified Pyroscope datasource and time range. Returns a list of all av...

List Snapshots`grafana_mcp_list_snapshots`

List Grafana dashboard snapshots with optional query and result limit filters.

List SQL Databases`grafana_list_sql_databases`

List databases, schemas, or catalogs. Athena: omit catalog to list catalogs; set it to list databases. BigQuery: list da...

List SQL Tables`grafana_list_sql_tables`

List SQL tables and available metadata. BigQuery returns table/view names only; schema is the required dataset and datab...

List Team Roles`grafana_list_team_roles`

List all roles assigned to one or more teams. Returns a map of team IDs to their assigned roles.

List Teams`grafana_mcp_list_teams`

Search for Grafana teams by a query string. Returns a list of matching teams with details like name, ID, and URL.

List Tempo Attribute Names`grafana_list_tempo_attribute_names`

List available attribute names for TraceQL queries. Without a scope (resource, span, etc.) the response can be very larg...

List Tempo Attribute Values`grafana_list_tempo_attribute_values`

List values for a fully scoped attribute name (e.g. resource.service.name). Useful for discovering what values exist for...

List User Roles`grafana_list_user_roles`

List all roles assigned to one or more users. Returns a map of user IDs to their assigned roles, excluding built-in role...

List Users By Org`grafana_list_users_by_org`

List users in the Grafana organization, optionally filtered by a search query. Results are paginated; the response inclu...

Query CloudWatch`grafana_query_cloudwatch`

Query AWS CloudWatch metrics via Grafana. Requires region. Time formats: 'now-1h', '2026-02-02T19:00:00Z', '173851920000...

Query CloudWatch Logs`grafana_query_cloudwatch_logs`

Run a CloudWatch Logs Insights query against one or more log groups via Grafana and return the result rows. Requires reg...

Query Elasticsearch`grafana_query_elasticsearch`

Executes a search query against an Elasticsearch or OpenSearch datasource and retrieves matching documents. Supports Luc...

Query Graphite Metrics`grafana_query_graphite`

Executes a Graphite render API query against a Graphite datasource and returns matching metric series with their datapoi...

Query Graphite Metric Density`grafana_query_graphite_density`

Analyses metric data density for one or more Graphite series over a time window. Returns per-series statistics: fillRati...

Query InfluxDB`grafana_query_influxdb`

Query an InfluxDB datasource via Grafana. Supports both InfluxQL (v1.x) and Flux (v2.x). The 'dialect' parameter selects...

Query Loki Logs`grafana_query_loki_logs`

Executes a log query against a Loki or VictoriaLogs datasource and returns matching log entries (or metric samples on Lo...

Query Loki Patterns`grafana_query_loki_patterns`

Retrieves detected log patterns from a Loki datasource for a given stream selector and time range. Returns a list of pat...

Get Loki Log Statistics`grafana_query_loki_stats`

Retrieves index-level statistics about log streams matching a given selector within a Loki or VictoriaLogs datasource an...

Query Prometheus Metrics`grafana_query_prometheus`

Query a PromQL-compatible datasource (Prometheus, Thanos, Mimir, Cloud Monitoring, etc.) using a PromQL expression. Retu...

Query Prometheus Histogram Percentile`grafana_query_prometheus_histogram`

Query Prometheus histogram percentiles from classic histogram '\_bucket' series. Generates histogram\_quantile PromQL. Exa...

Query Pyroscope`grafana_query_pyroscope`

Unified Pyroscope query tool for fetching profiles or metrics from Pyroscope. Profile data shows WHICH functions consume...

Query Quickwit`grafana_query_quickwit`

Executes a search query against a Quickwit datasource and retrieves matching documents. Supports Lucene query syntax (e....

Query SQL`grafana_query_sql`

Query ClickHouse, Snowflake, Athena, MySQL, PostgreSQL, MSSQL, or BigQuery via Grafana. Supports datasource-specific tim...

Query Tempo Metrics`grafana_query_tempo_metrics`

Compute trace-derived metrics using a TraceQL metrics query. The syntax is unlike PromQL. Use type 'instant' for a singl...

Create An Alert Draft`grafana_render_alert_creation`

Open an interactive draft for a Grafana-managed Prometheus alert. Supply the actual datasource UID, valid PromQL express...

Display Alert Status`grafana_render_alert_status`

Display read-only Grafana-managed alert rule status, current instances, 14-day state history, silence state and real que...

Check Alert Creation Status`grafana_resolve_alert_creation`

Read the saved definition for a previously submitted alert draft. Never repeats the write; missing or conflicting defini...

Run Gcx Command`grafana_run_gcx_command`

Run a gcx (Grafana Cloud CLI) command against the user's Grafana stack and return its output. Use this as the fallback w\...

Run Panel Query`grafana_run_panel_query`

Executes one or more dashboard panel queries with optional time range and variable overrides. Accepts an array of panel...

Search Alert Metrics`grafana_search_alert_creation_metrics`

Search metric names on a Prometheus datasource by case-insensitive substring, using the caller's Grafana access. Returns...

Search Dashboards`grafana_mcp_search_dashboards`

Search Grafana dashboards by query and/or folderUid, folderPath, tag, and starred. Returns matching dashboards with titl...

Search Docs`grafana_search_docs`

Search Grafana documentation. Returns matching pages with title, URL, description, and product. Call with no query to li...

Search Folders`grafana_search_folders`

Search for Grafana folders by a query string. Returns matching folders with details like title, UID, and URL.

Search Plugins`grafana_search_plugin_information`

Search the Grafana plugin catalog by keyword, purpose, or partial name (e.g. 'azure monitoring', 'loki', 'database'). Re...

Search Tempo Traces`grafana_search_tempo_traces`

Search for traces using TraceQL queries. Returns each matching trace with its root service, root span name, start time a...

Send Feedback`grafana_send_feedback`

Send feedback about this MCP server to Grafana Labs: a missing capability, a broken or confusing tool, or an idea. Feedb...

Simulate Alert Rule`grafana_simulate_alert_creation`

Simulate the current draft on Grafana without saving. Requires a write-enabled connection because Grafana requires rule-...

Suggest Alloy Label Enforcement Config`grafana_suggest_loki_alloy_label_config`

Generates an Alloy loki.process snippet enforcing an approved label set via stage.label\_keep, with optional log-level no...

Update IRM Alert Group`grafana_update_alert_group`

Update the state of a Grafana OnCall alert group: acknowledge, unacknowledge, resolve, or unresolve it by ID. Returns th...

Update Alert Rule`grafana_update_alert_status`

Silence one Grafana-managed alert rule for 2, 6 or 12 hours, or expire the displayed silences scoped only to it. Intende...

Update Annotation`grafana_mcp_update_annotation`

Updates the provided properties of an annotation by ID. Only fields included in the request are modified; omitted fields...

Create Or Update Dashboard`grafana_update_dashboard`

Create or update a dashboard. Returns the saved dashboard UID and dashboard link in the 'url' field, using the instance...

Update Datasource`grafana_mcp_update_datasource`

Update non-secret datasource fields by UID in two steps. Called with only the uid, it returns the datasource's field sch...

Update Incident`grafana_update_incident`

Update an existing Grafana incident by ID. Allows changing the status ('active' or 'resolved'), the severity, the title,...

Get Current User Info`grafana_user_info`

Get information about the current Grafana identity: login, email, name, whether it is a Grafana (server) admin, the curr...

Wait For Investigation`grafana_wait_for_investigation`

Wait for a Grafana Assistant investigation (AI-driven root-cause investigation) to settle, up to timeoutSeconds (default...

Get Organization`grafana_get_organization`

Retrieve the current organization's details

`orgs:read`

Update Organization`grafana_update_organization`

Update the current organization's name

`orgs:write`

List Organization Users`grafana_list_org_users`

List all users in the current organization

`org.users:read`

Add Organization User`grafana_add_org_user`

Add an existing user to the current organization

`org.users:write`

Update Organization User Role`grafana_update_org_user_role`

Update a user's role in the current organization

`org.users:write`

Remove Organization User`grafana_remove_org_user`

Remove a user from the current organization

`org.users:write`

Get Organization Preferences`grafana_get_org_preferences`

Retrieve the current organization's preference settings

`orgs:read`

Update Organization Preferences`grafana_update_org_preferences`

Update the current organization's preference settings

`orgs:write`

List Playlists`grafana_list_playlists`

Retrieve all playlists

`playlists:read`

Get Playlist`grafana_get_playlist`

Retrieve a specific playlist by its UID

`playlists:read`

Create Playlist`grafana_create_playlist`

Create a new playlist

`playlists:write`

Update Playlist`grafana_update_playlist`

Update an existing playlist by its UID

`playlists:write`

Delete Playlist`grafana_delete_playlist`

Delete a playlist by its UID

`playlists:write`

List Service Accounts`grafana_list_service_accounts`

Retrieve all service accounts with pagination

`serviceaccounts:read`

Get Service Account`grafana_get_service_account`

Retrieve a specific service account by its ID

`serviceaccounts:read`

Create Service Account`grafana_create_service_account`

Create a new service account

`serviceaccounts:write`

Update Service Account`grafana_update_service_account`

Update a service account's name or role

`serviceaccounts:write`

Delete Service Account`grafana_delete_service_account`

Delete a service account by its ID

`serviceaccounts:write`

List Service Account Tokens`grafana_list_service_account_tokens`

Retrieve all tokens for a service account

`serviceaccounts:read`

Create Service Account Token`grafana_create_service_account_token`

Create a new token for a service account

`serviceaccounts:write`

Delete Service Account Token`grafana_delete_service_account_token`

Delete a specific token from a service account

`serviceaccounts:write`

List Teams`grafana_list_teams`

Retrieve all teams with pagination

`teams:read`

Get Team`grafana_get_team`

Retrieve a specific team by its ID

`teams:read`

Create Team`grafana_create_team`

Create a new team in the organization

`teams:write`

Update Team`grafana_update_team`

Update a team's name or email

`teams:write`

Delete Team`grafana_delete_team`

Delete a team by its ID

`teams:write`

List Team Members`grafana_list_team_members`

Retrieve all members of a team

`teams.permissions:read`

Add Team Member`grafana_add_team_member`

Add a user to a team

`teams.permissions:write`

Remove Team Member`grafana_remove_team_member`

Remove a user from a team

`teams.permissions:write`

Get Health`grafana_get_health`

Check the health status of the Grafana instance

Get Frontend Settings`grafana_get_frontend_settings`

Retrieve Grafana frontend configuration settings

List Snapshots`grafana_list_snapshots`

Retrieve all dashboard snapshots

`snapshots:read`

Get Snapshot`grafana_get_snapshot`

Retrieve a dashboard snapshot by its key

`snapshots:read`

Delete Snapshot`grafana_delete_snapshot`

Delete a dashboard snapshot by its key

`snapshots:write`

List Library Elements`grafana_list_library_elements`

Retrieve all reusable library elements (panels)

`library.panels:read`

Get Library Element`grafana_get_library_element`

Retrieve a specific library element by its UID

`library.panels:read`

Create Short URL`grafana_create_short_url`

Create a shortened URL for a Grafana path

Create Snapshot`grafana_create_snapshot`

Create a new dashboard snapshot

`snapshots:write`

Create Library Element`grafana_create_library_element`

Create a new reusable library element (panel)

`library.panels:write`

Delete Library Element`grafana_delete_library_element`

Delete a library element by its UID

`library.panels:write`

Update Library Element`grafana_update_library_element`

Update an existing library element by its UID

`library.panels:write`

## Events

Tags

Select all
|
Clear

Alerts

IRM Alert Groups

IRM Schedules

IRM Shift Swaps

Verification

No tags found

19 events

EventDescriptionTags

Ping Verification`grafana_webhook_ping`

Acknowledges webhook connectivity checks from Grafana without emitting an event.

Verification

Alert Firing Event`grafana_webhook_alert_firing`

Processes Grafana alerting notifications when one or more alert instances start firing.

Alerts

Alert Resolved Event`grafana_webhook_alert_resolved`

Processes Grafana alerting notifications when every alert instance in a group returns to normal.

Alerts

IRM Alert Group Created Event`grafana_webhook_irm_alert_group_created`

Processes Grafana IRM outgoing webhook deliveries fired when a new IRM alert group is created from an incoming alert.

IRM Alert Groups

IRM Alert Group Acknowledged Event`grafana_webhook_irm_alert_group_acknowledged`

Processes Grafana IRM outgoing webhook deliveries fired when an alert group is acknowledged.

IRM Alert Groups

IRM Alert Group Resolved Event`grafana_webhook_irm_alert_group_resolved`

Processes Grafana IRM outgoing webhook deliveries fired when an alert group is resolved.

IRM Alert Groups

IRM Alert Group Silenced Event`grafana_webhook_irm_alert_group_silenced`

Processes Grafana IRM outgoing webhook deliveries fired when an alert group is silenced.

IRM Alert Groups

IRM Alert Group Unsilenced Event`grafana_webhook_irm_alert_group_unsilenced`

Processes Grafana IRM outgoing webhook deliveries fired when a silenced alert group is unsilenced.

IRM Alert Groups

IRM Alert Group Unresolved Event`grafana_webhook_irm_alert_group_unresolved`

Processes Grafana IRM outgoing webhook deliveries fired when a resolved alert group is reopened.

IRM Alert Groups

IRM Alert Group Unacknowledged Event`grafana_webhook_irm_alert_group_unacknowledged`

Processes Grafana IRM outgoing webhook deliveries fired when an acknowledgement is removed from an alert group.

IRM Alert Groups

IRM Alert Group Escalation Event`grafana_webhook_irm_alert_group_escalation`

Processes Grafana IRM outgoing webhook deliveries fired when an escalation chain reaches a Trigger webhook step that ref...

IRM Alert Groups

IRM Alert Group Status Changed Event`grafana_webhook_irm_alert_group_status_changed`

Processes Grafana IRM outgoing webhook deliveries fired when an alert group changes state.

IRM Alert Groups

IRM Alert Group Personal Notification Event`grafana_webhook_irm_alert_group_personal_notification`

Processes Grafana IRM outgoing webhook deliveries fired when IRM sends a personal notification to a user for an alert gr...

IRM Alert Groups

IRM Schedule On-Call Changed Event`grafana_webhook_irm_schedule_oncall_changed`

Processes Grafana IRM outgoing webhook deliveries fired when the set of users on call for a schedule changes.

IRM Schedules

IRM Schedule Shift Started Event`grafana_webhook_irm_schedule_shift_started`

Processes Grafana IRM outgoing webhook deliveries fired when an on-call shift starts in a schedule.

IRM Schedules

IRM Schedule Shift Ended Event`grafana_webhook_irm_schedule_shift_ended`

Processes Grafana IRM outgoing webhook deliveries fired when an on-call shift ends in a schedule.

IRM Schedules

IRM Schedule Going On-Call Event`grafana_webhook_irm_schedule_going_oncall`

Processes Grafana IRM outgoing webhook deliveries fired when a user is about to go on call.

IRM Schedules

IRM Shift Swap Created Event`grafana_webhook_irm_shift_swap_created`

Processes Grafana IRM outgoing webhook deliveries fired when a shift swap request is created.

IRM Shift Swaps

IRM Shift Swap Taken Event`grafana_webhook_irm_shift_swap_taken`

Processes Grafana IRM outgoing webhook deliveries fired when a shift swap request is taken by another user.

IRM Shift Swaps


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.