Grafana Cloud MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Grafana Cloud MCP or direct API to query metrics, fetch logs and traces, list dashboards, and manage alerts and incidents through natural language.

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

Try Grafana Cloud MCP now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Grafana Cloud MCP
Try asking
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.

SETUP GUIDE

Connect Grafana Cloud MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Grafana Cloud MCP
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Grafana Cloud MCP API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Grafana Cloud MCP Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Grafana Cloud MCP actions with your Agent

Why Use Composio?

AI Native Grafana Cloud MCP Integration

  • Supports both Grafana Cloud MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Grafana Cloud MCP data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Grafana Cloud MCP access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Grafana Cloud MCP
  • Scoped, least privilege access to Grafana Cloud MCP resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Grafana Cloud MCP with any AI Agent Framework

Choose a Framework you want to connect Grafana Cloud MCP with

FAQ

Frequently asked questions

Yes, Grafana Cloud MCP requires you to configure your own Dcr Oauth credentials. Once set up, Composio handles secure credential storage and management for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

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