How to connect Grafana Cloud to Grok Bot

Connect Grok Bot to Grafana Cloud MCP. List cpu spikes for your service, show top error logs for payment-api, and more using natural language, with authentication handled for you.

Grafana Cloud MCP logoGrafana Cloud MCP
Dcr Oauth

Grafana Cloud MCP is Grafana's observability platform for metrics, logs, traces, dashboards, alerts, and datasources. Query and explore your Grafana Cloud observability data in a unified way.

118 Tools

Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.

This guide explains how to connect Grafana Cloud to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Grafana Cloud in plain language.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Grafana Cloud MCP with

Why use Composio?

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:

  • Connect to 1,700+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
  • Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Handle large tool responses outside the model context to keep conversations lean.

Connecting Grafana Cloud to Grok Bot

Once Grok Bot is set up, you connect Grafana Cloud entirely from its interface, and the whole flow takes under a minute.

Set up Grok Bot

Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from x.ai/bot and sign in. An iPhone companion app is also available, and your bots sync across devices.

Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.

Connect Grafana Cloud

1. Add the Composio plugin

Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.

Add to Grok Bot

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.

Composio authorization screen with Authorize and Deny

3. Connect your Grafana Cloud account

Back in the chat, ask your bot to connect to Grafana Cloud or give it any Grafana Cloud task.

For example, ask it to:

  • "List CPU spikes for your service"
  • "Show top error logs for payment-api"
  • "Create alert for high latency on checkout"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in your Grok bot, and your Grafana Cloud account is ready to use.

What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.

With Composio Connect, your Grok bot can securely access apps like Grafana Cloud through MCP without you sharing account credentials directly with the agent.

What is the Grafana Cloud MCP server, and what's possible with it?

The Grafana Cloud MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Grafana Cloud account. It provides structured and secure access to your dashboards, datasources, alerts, incidents, and observability data, so your agent can inspect dashboards, check datasource health, manage alerts, handle incidents, and investigate root causes on your behalf.

  • Dashboard analysis and navigation: Have your agent summarize dashboards, inspect panel queries and settings, fetch annotations, and generate links to relevant Grafana resources.
  • Alert management: Let the agent create and update alert rules, manage notification routing and contact points, and configure alert silences.
  • Incident response: Direct your agent to create incidents, retrieve incident details, add timeline notes, and identify who is currently on call.
  • Root cause investigations: Instruct your agent to start and review investigations across metrics, logs, traces, dashboards, and alerts when diagnosing service problems.
  • Datasource and infrastructure checks: Have your agent describe your infrastructure, inspect datasources, check their health, and create new datasources when needed.

Way Forward

Now that Grafana Cloud is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

TOOLS

Supported Tools

Every Grafana Cloud MCP action and event your agent gets out of the box.

Add activity to incident

Add a note (userNote activity) to an existing incident's timeline using its ID.

Agento11y manage agents

Read the agent catalog of Grafana Agent Observability (the grafana-agento11y-app plugin): which agents send telemetry, what their system prompts and tools are, how their prompt versions evolved, and how each version scored.

Agento11y manage conversations

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

Agento11y manage eval collections

Manage the curated conversations of Grafana Agent Observability (the grafana-agento11y-app plugin): bookmark conversations as saved conversations and group them into collections.

Agento11y manage eval rules

Manage the evaluation rules and guards of Grafana Agent Observability (the grafana-agento11y-app plugin): the configuration that decides when evaluators run.

Agento11y manage evaluators

Manage the evaluator catalog of Grafana Agent Observability (the grafana-agento11y-app plugin): read evaluators, evaluator templates, and the judge model catalog, and create, test, or delete evaluators.

Agento11y manage experiments

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

Agento11y manage generations

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

Agento11y manage test suites

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

Alerting manage routing

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

Alerting manage rules

Manage Grafana alert rules with full CRUD capabilities and filtering.

Alerting manage silences

Manage Grafana alerting silences.

Analyze loki labels

Audits a Loki label strategy and optionally diagnoses query performance.

Ask assistant

Send a message to Grafana Assistant and wait for the full text reply.

Check datasources health

Check datasource health.

Create annotation

Create a new annotation on a dashboard or panel.

Create datasource

Create a datasource.

Create folder

Create a Grafana folder.

Create incident

Create a new Grafana incident.

Create investigation

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

Create snapshot

Create a Grafana snapshot from a full dashboard payload.

Delete snapshot

Delete a Grafana snapshot by snapshot key.

Describe athena table

Get column names for an Athena table.

Describe clickhouse table

Get column schema for a ClickHouse table.

Describe infrastructure

Start here when users ask about their infrastructure, services, or architecture.

Describe snowflake table

Get column schema for a Snowflake table.

Generate deeplink

Generate deeplink URLs for Grafana resources.

Get alert group

Get a specific alert group from Grafana OnCall by its ID.

Get annotations

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

Get annotation tags

Returns annotation tags with optional filtering by tag name.

Get assertions

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

Get current oncall users

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

Get dashboard by uid

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

Get dashboard panel queries

Retrieve panel queries from a Grafana dashboard.

Get dashboard property

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

Get dashboard summary

Get a compact summary of a dashboard including title\, panel count\, panel types\, variables\, and other metadata without the full JSON.

Get datasource

Retrieves detailed information about a specific datasource by UID or name.

Get incident

Get a single incident by ID.

Get investigation

Get one Grafana Assistant investigation (AI-driven root-cause investigation) by ID.

Get investigation thread

Get the working thread of one Grafana Assistant investigation (AI-driven root-cause investigation) by ID: the user-visible conversation between the investigation agent and its tools.

Get oncall shift

Get detailed information for a specific Grafana OnCall shift using its ID.

Get panel image

Render a Grafana dashboard panel or full dashboard as a PNG image.

Get plugin

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

Get query examples

Get example queries for a specific datasource type.

Get resource description

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

Get resource permissions

List all permissions set on a specific Grafana resource (e.

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

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

Get snapshot

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

Grafana api request

Make an authenticated HTTP request to the Grafana API.

Install plugin

Install a Grafana plugin by its plugin ID.

List alert groups

List alert groups from Grafana OnCall with filtering options.

List all roles

List all roles in Grafana.

List athena catalogs

START HERE for Athena: List available data catalogs (e.

List athena databases

List databases in an Athena catalog.

List athena tables

List tables in an Athena database.

List clickhouse tables

START HERE for ClickHouse: List available tables (name, database, engine, row count, size).

List cloudwatch dimensions

List dimension keys for a CloudWatch metric.

List cloudwatch metrics

List metrics for a CloudWatch namespace.

List cloudwatch namespaces

START HERE for CloudWatch: List available namespaces (AWS/EC2, AWS/ECS, AWS/RDS, etc.

List datasources

List all configured datasources in Grafana.

List graphite metrics

Discover available metric paths in a Graphite datasource by browsing the metric tree.

List graphite tags

List available tag names in a Graphite datasource that uses tag-based metrics.

List incidents

List Grafana incidents.

List investigation evidence

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

List investigation profiles

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

List investigations

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

List loki label names

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

List loki label values

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

List oncall schedules

List Grafana OnCall schedules, optionally filtering by team ID.

List oncall teams

List teams configured in Grafana OnCall.

List oncall users

List users from Grafana OnCall.

List prometheus label names

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

List prometheus label values

Use after list_prometheus_metric_names to find label values for filtering queries.

List prometheus metric metadata

List Prometheus metric metadata.

List prometheus metric names

DISCOVERY: Call this first to find available metrics before querying.

List pyroscope label names

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

List pyroscope label values

Lists all available label values for a particular label name found in profiles within a specified Pyroscope datasource, time range, and optional label matchers.

List pyroscope profile types

Lists all available profile types available in a specified Pyroscope datasource and time range.

List snapshots

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

List snowflake tables

START HERE for Snowflake: List available tables (database, schema, name, kind, row count, size) via INFORMATION_SCHEMA.

List team roles

List all roles assigned to one or more teams.

List teams

Search for Grafana teams by a query string.

List user roles

List all roles assigned to one or more users.

List users by org

List users in the Grafana organization.

Query athena

Query Amazon Athena via Grafana.

Query clickhouse

Query ClickHouse via Grafana.

Query cloudwatch

Query AWS CloudWatch metrics via Grafana.

Query elasticsearch

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

Query graphite

WORKFLOW: list_graphite_metrics -> query_graphite.

Query graphite density

Analyses metric data density for one or more Graphite series over a time window.

Query influxdb

Query an InfluxDB datasource via Grafana.

Query loki logs

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

Query loki patterns

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

Query loki stats

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

Query prometheus

WORKFLOW: list_prometheus_metric_names -> list_prometheus_label_values -> query_prometheus.

Query prometheus histogram

Query Prometheus histogram percentiles.

Query pyroscope

Unified Pyroscope query tool for fetching profiles or metrics from Pyroscope.

Query quickwit

Executes a search query against a Quickwit datasource and retrieves matching documents.

Query snowflake

Query Snowflake via Grafana.

Run panel query

Executes one or more dashboard panel queries with optional time range and variable overrides.

Search dashboards

Search for Grafana dashboards by a query string.

Search folders

Search for Grafana folders by a query string.

Search plugin information

Search the Grafana plugin catalog by keyword to discover available plugins before installing or getting plugin details on a specific instance.

Suggest loki alloy label config

Generates an Alloy loki.

Tempo docs config

Documentation on Tempo configuration.

Tempo docs traceql

Documentation on TraceQL search.

Tempo get attribute names

Get a list of available attribute names that can be used in TraceQL queries.

Tempo get attribute values

Get a list of values for a fully scoped attribute name.

Tempo get trace

Retrieve a specific trace by ID

Tempo traceql metrics instant

Retrieve a single metric value given a TraceQL metrics query.

Tempo traceql metrics range

Retrieve a metric series given a TraceQL metrics query.

Tempo traceql search

Search for traces using TraceQL queries

Update alert group

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

Update annotation

Updates the provided properties of an annotation by ID.

Update dashboard

Create or update a dashboard.

Update datasource

Update non-secret datasource fields by UID.

Update incident

Update an existing Grafana incident by ID.

FAQ

Frequently asked questions

Start with Grafana Cloud MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Grafana Cloud MCP tool your agent needs.Free to start.

Start building