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 | ✅ | ✅ | v0.5 |
chrome-devtools |
Chrome DevTools | ❌ | stack.hasFrontend |
frontend-browser-tester | ✅ | — | v0.5 |
postgres |
Postgres MCP | ❌ | (per spec) | (per spec) | ✅ | ✅ | v0.5 |
filesystem |
Filesystem MCP | ✅ | never |
(empty — manual) | ✅ | — | v0.5 |
graphify |
graphify | ✅ | never |
(empty — manual) | ✅ | ⏳ | v1.0-rc2 (ADR-0015) |
⏳ = Codex install recipe deferred until the Codex adapter's MCP surface stabilises (per ADR-0015 §implementation).
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 . |
graphify |
claude mcp add graphify -- uvx graphifyy mcp (Python prereq) |
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/neverbeadsEnabled/brownfieldstack.has(<id>)/stack.hasFrontend/stack.hasBackend/stack.hasDatabase/stack.language(<lang>)detect.githubRemote/detect.gitlabRemote/detect.bitbucketRemoteos.darwin/os.linux/os.win32conformance.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.
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.