{
  "markdown": "# Grafana AI Marketplace\n\nPlugin marketplace for AI-assisted Grafana observability workflows in **Cursor**, **Claude Code**, **Kiro**, **Grok Build**, and **Codex**.\n\nTwo ways to connect Grafana, depending on the plugin:\n\n- **Hosted Grafana Cloud MCP** (`grafana-cloud-mcp`) — the hosted `https://mcp.grafana.com/mcp` server over Streamable HTTP with OAuth 2.1. No local Docker and no service-account token.\n- **Local Grafana MCP** (`grafana-mcp`) — the official [`grafana/mcp-grafana`](https://github.com/grafana/mcp-grafana) Docker image in stdio mode, using a Grafana service-account token.\n\n## Getting started\n\n### Hosted Grafana Cloud MCP (OAuth, no local setup)\n\n1. Have a Grafana Cloud account with the **Assistant Cloud MCP User** role or the `grafana-assistant-app.cloud-mcp:access` permission (Editor and higher have it by default).\n2. Install the `grafana-cloud-mcp` plugin from your platform's marketplace.\n3. When prompted, enter your Grafana Cloud URL and authorize the connection in your browser. Choose read-only or read + write access during consent.\n\nAuthorizing **read + write** access additionally requires the **Assistant Admin** role or the `grafana-assistant-app.cloud-mcp.scope:write` permission. If **Write** is unavailable on the OAuth consent page, ask your Grafana organization administrator to grant it.\n\nNo Docker, environment variables, or service-account token are required.\n\n### Local Grafana MCP (Docker + service-account token)\n\n1. [Docker](https://docs.docker.com/get-docker/) must be installed and running.\n2. Create a [service account](https://grafana.com/docs/grafana/latest/administration/service-accounts/) in Grafana with at least **Viewer** role (or **Editor** for write operations) and generate a token.\n3. Set environment variables:\n\n   ```bash\n   export GRAFANA_URL=\"http://localhost:3000\"\n   export GRAFANA_SERVICE_ACCOUNT_TOKEN=\"<your token>\"\n   ```\n\n   For Grafana Cloud, use your instance URL instead (e.g. `https://myinstance.grafana.net`).\n4. Install the `grafana-mcp` plugin from your platform's marketplace.\n\n### Add this marketplace\n\nClaude Code:\n\n```shell\n/plugin marketplace add grafana/ai-marketplace\n/plugin install grafana-cloud-mcp@grafana-ai-marketplace\n```\n\nCodex:\n\n```shell\ncodex plugin marketplace add grafana/ai-marketplace\n```\n\nCursor, Kiro, and Grok Build install from their respective marketplace UIs.\n\n## What's included\n\n- **`grafana-cloud-mcp`** — hosted Grafana Cloud MCP server (OAuth 2.1), plus the `grafana-cloud-mcp-tools` skill covering 60+ tools for dashboards, datasources, Prometheus, Loki, Tempo, Pyroscope, alerting, incidents, OnCall, annotations, and Grafana Assistant (`ask_assistant`). Packaged for Codex as an app-plus-skills plugin.\n- **`grafana-mcp`** — local `grafana/mcp-grafana` Docker MCP server (stdio) for self-hosted or token-based setups.\n- **`grafana-assistant`** — skills and rules for developing and using the Grafana Assistant app and CLI (Cursor/Claude/Kiro/Grok).\n\nSee each plugin's `README.md` for its full tool reference.\n\n## Architecture\n\nEach plugin ships manifests for the platforms it targets and shares components (rules, skills, MCP config) where the formats allow. Not every plugin targets every platform, and platform manifests are not automatically identical — each format has its own manifest and, where needed, format-specific fields.\n\n```text\nplugins/grafana-cloud-mcp/\n├── .cursor-plugin/plugin.json   # Cursor manifest\n├── .claude-plugin/plugin.json   # Claude Code manifest\n├── .grok-plugin/plugin.json     # Grok Build manifest (when targeted)\n├── .codex-plugin/plugin.json    # Codex manifest (mcpServers + skills + listing metadata)\n├── POWER.md                     # Kiro manifest (frontmatter + onboarding)\n├── .mcp.json                    # Hosted MCP server config (Streamable HTTP)\n├── mcp.json                     # Shared MCP server config\n├── skills/                      # Shared skills (SKILL.md)\n├── assets/logo.svg              # Marketplace/listing logo\n└── steering/                    # Kiro steering files\n```\n\nRoot marketplace manifests:\n\n- `.cursor-plugin/marketplace.json` — Cursor Marketplace\n- `.claude-plugin/marketplace.json` — Claude Code plugin registry\n- `.grok-plugin/marketplace.json` — Grok Build plugin marketplace\n- `.kiro-power/marketplace.json` — Kiro Powers registry\n- `.agents/plugins/marketplace.json` — Codex marketplace\n\nVersions are kept in sync across the Cursor and Claude Code formats and validated in CI.\n\n## Development\n\nValidate the plugin structure across all formats:\n\n```bash\nnode scripts/validate-template.mjs\n```\n\nTo add a plugin, create a directory under `plugins/` and register it in the applicable marketplace manifests. See `docs/add-a-plugin.md` for details.\n",
  "bytes": 4738,
  "sha": "ad83408925538b6ecaa51cdd3256c0d9ed33b8f78377e92aeeb07303c28ab519",
  "repo_slug": "grafana/ai-marketplace",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_grafana_ai_marketplace_grafana_mcp_b15247d7/readme"
}