OAUTH 2.1
OBSERVABILITY
Grafana Cloud MCP gives your agent observability across your Grafana stack: query metrics, logs, and traces, read dashboards and alert rules, check who is on call, and manage incidents and investigations.
For more tools, view docs.
import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
// Grafana Cloud tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["grafanacloudmcp"], toolNames: [
"grafanacloudmcp_query_prometheus",
"grafanacloudmcp_query_loki_logs",
"grafanacloudmcp_list_alert_groups"] },
pageSize: 100,
});
const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Check the checkout service error rate, pull its recent error logs, and list the alert groups that fired in the last hour" }] });import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";
const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();
const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["grafanacloudmcp"] }, pageSize: 100,
});
const res = await openai.chat.completions.create({
model: "gpt-5",
messages: [{ role: "user", content: "Check the checkout service error rate, pull its recent error logs, and list the alert groups that fired in the last hour" }],
tools,
});
// Execute the tool call with the user's vaulted Grafana Cloud OAuth token
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";
const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();
const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["grafanacloudmcp"] }, pageSize: 100,
});
const msg = await anthropic.messages.create({
model: "claude-sonnet-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Check the checkout service error rate, pull its recent error logs, and list the alert groups that fired in the last hour" }],
tools,
});
// Tool call runs with the user's vaulted Grafana Cloud OAuth token
await sk.tools.executeTool(msg.content, "user_123");import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";
const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["grafanacloudmcp"] }, pageSize: 100,
});
const agent = new Agent({
name: "observability_agent",
model: "gemini-2.5-pro",
instruction: "Grafana Cloud tools scoped to this user",
tools,
});
await agent.run("Check the checkout service error rate, pull its recent error logs, and list the alert groups that fired in the last hour");
.svg)
// shared token
audit → bot_service_account
// scalekit
audit → user_abc ✓
.svg)
