MCP Catalog Reference

Purpose #

The v1.0 catalog at a glance: every entry, its triggers, sensitivity, default scope, and adapters covered. The authoritative entries live at .docs/docs/specs/mcp-catalog.md §11 and in packages/mcp-catalog/src/catalog.ts.

Entries #

ID	Name	Sensitive	Triggers	Default scope	claude-code?	codex?	First shipped
`context7`	Context7	❌	`always`	researcher, architect	✅	✅	v0.1
`beads-mcp`	Beads MCP (`cgb`)	❌	`beadsEnabled`	planner, maintainer	✅	✅	v0.1
`playwright`	Playwright	❌	`stack.hasFrontend`	tester-reviewer, frontend-browser-tester	✅	✅	v0.1
`github`	GitHub MCP	✅	`detect.githubRemote`	researcher, planner, maintainer	✅	✅	v0.5
`chrome-devtools`	Chrome DevTools	❌	`stack.hasFrontend`	frontend-browser-tester, builder	✅	—	v0.5
`postgres`	Postgres MCP	✅	`never`	builder, architect	✅	✅	v0.5
`filesystem`	Filesystem MCP	✅	`never`	(empty — manual)	✅	—	v0.5
`sentry`	Sentry MCP	✅	`never`	builder, tester-reviewer, maintainer	✅	⏳	v1.0-rc3
`notion`	Notion MCP	✅	`never`	researcher, architect, planner	✅	⏳	v1.0-rc3
`linear`	Linear MCP	✅	`never`	researcher, planner, maintainer	✅	⏳	v1.0-rc3
`graphify`	graphify	✅	`never`	researcher, architect (manual)	✅	⏳	v1.0-rc2 (ADR-0015)

⏳ = Codex install recipe deferred until the Codex adapter's MCP surface stabilises. graphify per ADR-0015 §implementation; sentry/notion/linear carry no codex install block in catalog.ts yet.

Authoritative source: packages/mcp-catalog/src/catalog.ts. The product spec .docs/docs/specs/mcp-catalog.md §11 still documents only the original eight and is pending an update for sentry/notion/linear (tracked separately).

Install commands (claude-code) #

ID	`claude mcp add` command
`context7`	`claude mcp add context7 -- npx -y @upstash/context7-mcp`
`beads-mcp`	`claude mcp add beads -- bd mcp serve`
`playwright`	`claude mcp add playwright -- npx -y @playwright/mcp@latest`
`github`	`claude mcp add github -- npx -y @modelcontextprotocol/server-github`
`chrome-devtools`	`claude mcp add chrome-devtools -- npx -y @benjaminr/chrome-devtools-mcp`
`filesystem`	`claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .`
`sentry`	`claude mcp add sentry -e SENTRY_AUTH_TOKEN=<your-token> -- npx -y @sentry/mcp-server`
`notion`	`claude mcp add notion -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <your-token>","Notion-Version":"2022-06-28"}' -- npx -y @notionhq/notion-mcp-server`
`linear`	`claude mcp add --transport sse linear https://mcp.linear.app/sse`
`graphify`	`claude mcp add graphify -- uvx --from "graphifyy[mcp]" graphify-mcp` (Python prereq; serves a pre-built `graphify-out/graph.json` — build it first; smoke-tested ADR-0030)

For codex configBlock snippets, see .docs/docs/specs/mcp-catalog.md §11.

Trigger evaluation summary #

OR-only; no AND, no negation. Full grammar at .docs/docs/specs/mcp-catalog.md §7:

always / never
beadsEnabled / brownfield
stack.has(<id>) / stack.hasFrontend / stack.hasBackend / stack.hasDatabase / stack.language(<lang>)
detect.githubRemote / detect.gitlabRemote / detect.bitbucketRemote
os.darwin / os.linux / os.win32
conformance.minimum / conformance.standard / conformance.strict

Adding a new entry #

See tutorials/add-an-mcp-catalog-entry.md and the checklist at .docs/docs/specs/mcp-catalog.md Appendix B.

Code-understanding companions (`cgb` slot) #

The researcher cgb (code-graph) slot can be filled two ways:

graphify — the catalogued MCP server above (aidokit mcp add graphify). Code parsed locally; non-code content uses your AI model.
Understand-Anything — an AI-CLI plugin (Lum1104/Understand-Anything), installed via your CLI's plugin system, not the MCP catalog. It has no claude mcp add recipe, so per ADR-0030 it is documented rather than catalogued.

Install commands and the trust boundary for both: see how-to-guides/code-understanding-graph.md.

Custom (non-catalog) MCPs #

aidokit mcp add <id> --custom-url <url> is the escape hatch. The CLI treats them as securitySensitive: true regardless of actual risk: forced confirmation, source: 'custom' in .aido/state.json, cannot be referenced by stack packs.