{
  "markdown": "# Avo MCP\n\nmcp-name: io.github.avohq/avo\n\nThe **Avo MCP server** (`https://mcp.avo.app/mcp`) lets Claude, Codex, Cursor, Gemini, and other MCP clients read and edit your [Avo](https://www.avo.app) tracking plan. This repo also ships [Agent Skills](https://docs.claude.com/en/docs/claude-code/skills) and a Claude Code plugin that guide effective use of the server.\n\nEach skill is a self-contained directory with a `SKILL.md` (instructions + metadata) and bundled resources. Claude loads them automatically when relevant to guide effective use of the Avo MCP server's tools (`search`, `get`, `save_items`, `workflow`, and the branch tools).\n\n## Installing the Avo MCP server\n\nThe Avo MCP server is a remote, OAuth-protected HTTP server at `https://mcp.avo.app/mcp`. Add it to your MCP client:\n\n**Claude Code (CLI)**\n\n```bash\nclaude mcp add --transport http avo https://mcp.avo.app/mcp\n```\n\nYou'll sign in through the browser on first use. The first time you make a change, you'll also get a one-time read → write re-auth prompt.\n\n**Claude.ai / Claude Desktop**\n\nAdd a custom connector pointing at `https://mcp.avo.app/mcp` (Settings → Connectors → Add custom connector). Authenticate when prompted.\n\n**Cursor and other MCP clients**\n\nAdd a remote (streamable HTTP) MCP server to your client's config:\n\n```json\n{\n  \"mcpServers\": {\n    \"avo\": { \"type\": \"http\", \"url\": \"https://mcp.avo.app/mcp\" }\n  }\n}\n```\n\n> If you install the Claude Code **plugin** (below), it registers this server for you — these steps are for connecting the server directly (other clients, or Claude Code without the plugin).\n\n## Skills\n\n### `data-designer` — Work with an existing Avo tracking plan\n\nExplore, search, and design against an existing Avo tracking plan: look events / properties / metrics up by name, id, meaning, or structural filter; review, prioritize, and implement branches; design tracking for a new feature or PRD against what already exists; make small branch edits; and combine Avo with a connected data MCP (Amplitude, Mixpanel, PostHog, BigQuery, Snowflake, Databricks, Redshift) to diagnose tracking gaps.\n\n- Path: [`skills/data-designer/`](skills/data-designer/)\n\n### `data-designer-new-plan` — Bootstrap a brand-new Avo tracking plan\n\nBootstrap a tracking plan from scratch in an empty or near-empty workspace: run a purpose meeting (problems, goals, metrics, key funnels), agree a naming convention, and seed the first categories and `start → milestone → complete` events with event / user / system properties and constraints — then create a branch.\n\n- Path: [`skills/data-designer-new-plan/`](skills/data-designer-new-plan/)\n\n## Use as a Claude Code plugin\n\nThis repo is also a Claude Code plugin marketplace. Installing the `avo` plugin bundles both skills **and** registers the Avo MCP server (`https://mcp.avo.app/mcp`) in one step:\n\n```bash\nclaude plugin marketplace add avohq/avo-mcp\nclaude plugin install avo@avo-mcp\n```\n\nThe plugin's layout:\n\n- `.claude-plugin/marketplace.json` — the marketplace manifest (lists the `avo` plugin)\n- `.claude-plugin/plugin.json` — the `avo` plugin manifest\n- `.mcp.json` — registers the Avo MCP server\n- `skills/` — the two skills, auto-discovered when the plugin is installed\n\n## Install skills only (no plugin)\n\nTo use the skills without the plugin / MCP registration, copy a skill directory into your personal or project skills folder:\n\n```bash\ncp -R skills/data-designer ~/.claude/skills/data-designer\ncp -R skills/data-designer-new-plan ~/.claude/skills/data-designer-new-plan\n```\n\n## Writing model\n\nAll writes happen on a branch, never on `main`; the MCP never merges — merging a branch into `main` is always a human step in the Avo web app.\n\n## Source\n\nThis repo is the source of truth for these skills. Avo's internal tooling syncs them from here (there's no build step to run in this repo). For the canonical, always-current Avo MCP tool list, see the [Avo MCP tools reference](https://www.avo.app/docs/reference/avo-mcp/tools).\n\n## License\n\nThe contents of this repository — the `data-designer` and `data-designer-new-plan` Agent Skills and the plugin manifest and configuration — are released under the [MIT License](./LICENSE).\n\nThis covers **only the files in this repository**. It grants no rights to the Avo MCP server (`https://mcp.avo.app/mcp`), the Avo web application, Avo SDKs, or any other Avo software or service — these are separate works, governed by Avo's [Terms of Service](https://www.avo.app/l/terms) and your agreement with Avo.\n",
  "bytes": 4497,
  "sha": "d85546e55d2cb8d6a6bc3379c90a653762e6aad1972b961851994c574ffd0da1",
  "repo_slug": "avohq/avo-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_avohq_avo_28315222/readme"
}