Grafana Cloud MCP

Grafana AI Marketplace

Plugin marketplace that exposes the official Grafana MCP server for AI-assisted observability workflows in Cursor, Claude Code, Kiro, and Grok Build.

Getting started

1. Docker must be installed and running.

2. Create a service account in Grafana with at least Viewer role (or Editor for write operations). Generate a token.

3. Set environment variables:

   export GRAFANA_URL="http://localhost:3000"
   export GRAFANA_SERVICE_ACCOUNT_TOKEN="<your token>"

For Grafana Cloud, use your instance URL instead (e.g. https://myinstance.grafana.net).

4. Install the plugin from the Cursor Marketplace, Claude Code plugin registry, Kiro Powers panel, or Grok Build Plugin Marketplace.

Add plugins in Claude Code

From any Claude Code session, add this marketplace from GitHub:

/plugin marketplace add grafana/ai-marketplace

Install plugins from this marketplace (grafana-ai-marketplace):

/plugin install grafana-assistant@grafana-ai-marketplace
/plugin install grafana-mcp@grafana-ai-marketplace

What's included

• MCP server (mcp.json) — runs the official grafana/mcp-grafana Docker image in stdio mode, providing 50+ tools for dashboards, datasources, Prometheus, Loki, alerting, incidents, OnCall, annotations, and more.
• Rule (rules/grafana-assistant.mdc) — best practices for using Grafana MCP tools effectively (context window management, write safety, deeplinks).
• Kiro steering (steering/) — workflow-specific guidance files loaded on-demand by Kiro.

See plugins/grafana-mcp/README.md for the full tool reference.

Architecture

Each plugin ships manifests for all four platforms while sharing all content (rules, skills, MCP config):

plugins/grafana-mcp/
├── .cursor-plugin/plugin.json   # Cursor manifest
├── .claude-plugin/plugin.json   # Claude Code manifest
├── .grok-plugin/plugin.json     # Grok Build manifest
├── POWER.md                     # Kiro manifest (frontmatter + onboarding)
├── mcp.json                     # Shared MCP server config
├── rules/                       # Shared rules
└── steering/                    # Kiro steering files

Root marketplace manifests:

• .cursor-plugin/marketplace.json — Cursor Marketplace
• .claude-plugin/marketplace.json — Claude Code plugin registry
• .grok-plugin/marketplace.json — Grok Build plugin marketplace
• .kiro-power/marketplace.json — Kiro Powers registry

Versions are kept in sync across all four formats and validated in CI.

Development

To validate the plugin structure (both formats):

node scripts/validate-template.mjs

To add more plugins, create a new directory under plugins/ and register it in all four marketplace manifests. See docs/add-a-plugin.md for details.