Setup
Get a Logic Bee API workspace ready so coding-agent skills can run.
Prerequisites
- You work in a Logic Bee API repo, not in this documentation repo.
- Installation: Git, Node.js 25.x or newer, pnpm 10.x, clone,
.env,pnpm i - A client that can spawn a local stdio MCP server (Cursor, Claude Code, or another stdio client)
Confirm Node and the install
From the repo root:
node -v
pnpm -v
Expected result: Node.js 26.x or newer. pnpm 10.x.
If node_modules is missing, run pnpm i.
Native module better-sqlite3 must match this Node. hook_graph search and impact need FTS5.
Ensure modules
From the repo root:
pnpm i
Sometimes, the sqlite3 package is not compatible with the Node version so it needs rebuilding
pnpm rebuild better-sqlite3
Rebuild workspace indexes
pnpm update-workspace
writes generated files. Run it from the repo root before the first MCP call.
Enable the server in the client
- Open MCP settings in the client.
- Enable
logic-beeorbobWorkspace. - Refresh MCP, or reload the window.
If the tools are not visible, stop. Do not grep the tree for catalogs MCP owns.
Expected result: The session lists logic-bee tools, including flow_documents and hook_graph.
Test MCP
Run the smoke test to ensure all MCP routes are successful:
Thought1m12s
Querying every path in the MCP
Worked for 1m 12s
I am Logic Bee. I tested this local environment: Node, install, SQLite/FTS5, workspace indexes, and the logic-bee MCP (all 17 tools).
Expected Node: 22.x or newer. Native modules (better-sqlite3) must match that Node. Package manager: pnpm 10.x.
pnpm update-workspace ran in execute mode and wrote generated files (interface registry, hook barrels, canonical imports, hook-graph). It completed all 4 steps.
Captures this run: SAMPLE_FLOW_DOC = accounts/account. search_for_hook_pattern { pattern: "test" } returned 0 paths (Category C execution skipped). SAMPLE_DOC_ID = iSyCLP_bP41LszjTiLIKjsZK.
Preflight
| Requirement | Expected | Result |
|---|---|---|
pnpm update-workspace | exit 0 | 🟢 PASS (4/4 steps ok) |
| Node.js | 22.x or newer | 🟢 PASS (v26.7.0) |
| Package manager | pnpm 10.x | 🟢 PASS (10.30.1) |
| Workspace install | node_modules + better-sqlite3 + tsx | 🟢 PASS |
| SQLite load | SQLITE_LOAD_OK | 🟢 PASS |
| FTS5 | FTS5_OK | 🟢 PASS |
tar | on PATH | 🟢 PASS |
| MCP registration | .mcp.json or .cursor/mcp.json | 🟢 PASS |
| Indexes | project + hook present | 🟢 PASS |
MCP ping: flow_documents list total 179; hook_graph stats hooks 744, documents 179.
Category A — Discovery indexes
| Tool | Call 1 | Call 2 | Call 3 | Category |
|---|---|---|---|---|
| flow_documents | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| flow_document_schema | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| hook_graph | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| project_graph | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| search_for_hook_pattern | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
Category B — Scaffold + dry-run
Maintenance stayed dry-run (mode === "dry-run"). Scaffold used kebab slugs mcp-smoke* (leading _ stripped). Artifacts deleted afterward (mcp-smoke, mcp-smoke-alt, three connectors, three interface pairs). Paths verified gone.
| Tool | Call 1 | Call 2 | Call 3 | Category |
|---|---|---|---|---|
| generate_interface_registry | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| regenerate_hook_barrels | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| standardize_hook_imports | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| update_workspace | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| create_collection | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| create_hook | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| create_interface | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| create_connector | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
These Category C calls hit Atlas and may run hooks as the workspace owner. list_collections and query_db ran; no execute_hook / run-all-test-hooks (empty pattern: "test" catalog from that tool).
Category C — Mongo + execute
| Tool | Call 1 | Call 2 | Call 3 | Category |
|---|---|---|---|---|
| list_collections | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
| query_db | 🟢 PASS | 🟢 PASS | 🟢 PASS | 🟢 |
MCP smoke summary
| Category | Tools | Green calls | Red calls | Skipped | Status |
|---|---|---|---|---|---|
| Preflight | — | 9 | 0 | 0 | 🟢 |
| A Discovery | 5 | 15 | 0 | 0 | 🟢 |
| B Scaffold + dry-run | 8 | 24 | 0 | 0 | 🟢 |
| C Mongo + execute | 4 | 6 | 0 | 6 | 🟢 / ⚪ |
| Total | 17 | 45/51 | 0 | 6 | 🟢 with SKIP |
Smoke test finished. Reply rerun to run pnpm update-workspace + Preflight + A + B + C again, rerun A, rerun B, or rerun C for one category, or rerun failed for red/SKIP-with-FIX rows only. A full rerun always starts with pnpm update-workspace. Cleanup of _mcp_smoke* already ran after B; a Category B rerun will create those artifacts again.
🎉 First prompt
Run the smoke test to ensure all MCP routes are successful: