{"_id":"@brightbeamai/chap-coordinator-mcp","_rev":"5-b03fe0cd37c1fa7582610771633380a7","name":"@brightbeamai/chap-coordinator-mcp","dist-tags":{"latest":"0.2.13"},"versions":{"0.2.9":{"name":"@brightbeamai/chap-coordinator-mcp","version":"0.2.9","keywords":["chap","mcp","model-context-protocol","agent","tool","claude"],"author":{"name":"Brightbeam AI","email":"oss@brightbeam.com"},"license":"Apache-2.0","_id":"@brightbeamai/chap-coordinator-mcp@0.2.9","maintainers":[{"name":"brightbeamai","email":"eng-admin@brightbeam.com"}],"homepage":"https://github.com/BrightbeamAI/chap","bugs":{"url":"https://github.com/BrightbeamAI/chap/issues"},"dist":{"shasum":"e0165d6ec564f18d044f61ddd36fceb74c8de2bb","tarball":"https://registry.npmjs.org/@brightbeamai/chap-coordinator-mcp/-/chap-coordinator-mcp-0.2.9.tgz","fileCount":21,"integrity":"sha512-b+ie7CdQqQdsBKpefySU5Qk4NjT5qGZ1Yi7z9sqWgSDPGU2rLHIl9pABfRKWOt9eB61GvqJBoRqf+KFSl/uAvg==","signatures":[{"sig":"MEUCIHe9d4Z3IcE6bNr839XOF06770A+Kpi7xxy3J8zDfCDtAiEA5Afaf1KCiTLQJkEy0eNsfJjLBvN7CnLLFlzgGG9g/FE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3294484},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./tools":{"types":"./dist/tools.d.ts","import":"./dist/tools.js","require":"./dist/tools.cjs"},"./schemas":{"types":"./dist/schemas.d.ts","import":"./dist/schemas.js","require":"./dist/schemas.cjs"}},"gitHead":"5c2586af71ff0ce0b7c2b49ad9c2343da649dfbe","scripts":{"test":"tsx --test tests/*.test.ts","build":"tsup","typecheck":"tsc","prepublishOnly":"npm run typecheck && npm run test && npm run build"},"_npmUser":{"name":"brightbeamai","email":"eng-admin@brightbeam.com"},"repository":{"url":"git+https://github.com/BrightbeamAI/chap.git","type":"git","directory":"packages/coordinator-mcp"},"_npmVersion":"11.17.0","description":"MCP server adapter for the CHAP Coordinator. Exposes every CHAP method as an MCP tool.","directories":{},"_nodeVersion":"26.5.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.5.1","typescript":"^5.3.0","@types/node":"^20.11.0","@modelcontextprotocol/sdk":"^1.30.0","@brightbeamai/chap-coordinator":"file:../coordinator"},"peerDependencies":{"@modelcontextprotocol/sdk":"^1.30.0","@brightbeamai/chap-coordinator":"^0.2.9"},"_npmOperationalInternal":{"tmp":"tmp/chap-coordinator-mcp_0.2.9_1786964131431_0.47201853346121214","host":"s3://npm-registry-packages-npm-production"}},"0.2.10":{"name":"@brightbeamai/chap-coordinator-mcp","version":"0.2.10","keywords":["chap","mcp","model-context-protocol","agent","tool","claude"],"author":{"name":"Brightbeam AI","email":"oss@brightbeam.com"},"license":"Apache-2.0","_id":"@brightbeamai/chap-coordinator-mcp@0.2.10","maintainers":[{"name":"brightbeamai","email":"eng-admin@brightbeam.com"}],"homepage":"https://github.com/BrightbeamAI/chap","bugs":{"url":"https://github.com/BrightbeamAI/chap/issues"},"bin":{"chap-mcp-server":"dist/cli.js"},"dist":{"shasum":"65df08e3f1f444e1ea1640c0b9eb6bb0d65fe316","tarball":"https://registry.npmjs.org/@brightbeamai/chap-coordinator-mcp/-/chap-coordinator-mcp-0.2.10.tgz","fileCount":27,"integrity":"sha512-qYlG8mfo1OUOlxRw3SjkSO8ltLnYPJ4ifGjR8IDuzynPhDMMm5ydsybzbLl0g4mkYUJBDU8RevaEDr6KRHurjQ==","signatures":[{"sig":"MEUCIAENNtF+L8jj3k+FpaclwPre++aCjOt1owKF31y8SJJmAiEA05vQbzMYJA+XmnjzhMN1rz/TzbK7Mah62Uks8G7XO6M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6436401},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./cli":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"},"./tools":{"types":"./dist/tools.d.ts","import":"./dist/tools.js","require":"./dist/tools.cjs"},"./schemas":{"types":"./dist/schemas.d.ts","import":"./dist/schemas.js","require":"./dist/schemas.cjs"}},"gitHead":"7a4b1b174e63cb312aa0841bb25c30534aa040b6","mcpName":"io.github.brightbeamai/chap","scripts":{"test":"tsx --test tests/*.test.ts","build":"tsup","typecheck":"tsc","prepublishOnly":"npm run typecheck && npm run test && npm run build"},"_npmUser":{"name":"brightbeamai","email":"eng-admin@brightbeam.com"},"repository":{"url":"git+https://github.com/BrightbeamAI/chap.git","type":"git","directory":"packages/coordinator-mcp"},"_npmVersion":"11.17.0","description":"MCP server adapter for the CHAP Coordinator. Exposes every CHAP method as an MCP tool.","directories":{},"_nodeVersion":"26.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","@brightbeamai/chap-coordinator":"^0.2.10"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.5.1","typescript":"^5.3.0","@types/node":"^20.11.0","@modelcontextprotocol/sdk":"^1.30.0","@brightbeamai/chap-coordinator":"file:../coordinator"},"_npmOperationalInternal":{"tmp":"tmp/chap-coordinator-mcp_0.2.10_1787244378774_0.6688833477414213","host":"s3://npm-registry-packages-npm-production"}},"0.2.11":{"name":"@brightbeamai/chap-coordinator-mcp","version":"0.2.11","keywords":["chap","mcp","model-context-protocol","agent","tool","claude"],"author":{"name":"Brightbeam AI","email":"oss@brightbeam.com"},"license":"Apache-2.0","_id":"@brightbeamai/chap-coordinator-mcp@0.2.11","maintainers":[{"name":"brightbeamai","email":"eng-admin@brightbeam.com"}],"homepage":"https://github.com/BrightbeamAI/chap","bugs":{"url":"https://github.com/BrightbeamAI/chap/issues"},"bin":{"chap-mcp-server":"dist/cli.js"},"dist":{"shasum":"aa9747b7c90f12f6fb0c642cb88b839d26bc5581","tarball":"https://registry.npmjs.org/@brightbeamai/chap-coordinator-mcp/-/chap-coordinator-mcp-0.2.11.tgz","fileCount":27,"integrity":"sha512-uihvuNQ1yCRW87XliWTvGBRs02versSq6UAiASIj1IjIoJdKw6jyU755xhs4elDsiUgPlMeXrULKbdXlwfUdpg==","signatures":[{"sig":"MEYCIQDYdBHITXCiTKv1qJyVVWUTtlhXG6EMB62bJA7U51S5ZQIhAOY37O7ic3/JCpZ1h8LFyevSy/+r9g0HPfKOg8Ik6wzT","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6436401},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./cli":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"},"./tools":{"types":"./dist/tools.d.ts","import":"./dist/tools.js","require":"./dist/tools.cjs"},"./schemas":{"types":"./dist/schemas.d.ts","import":"./dist/schemas.js","require":"./dist/schemas.cjs"}},"gitHead":"b50f4c91b8e3d0166c2f233163e2beb69480a550","mcpName":"io.github.BrightbeamAI/chap","scripts":{"test":"tsx --test tests/*.test.ts","build":"tsup","typecheck":"tsc","prepublishOnly":"npm run typecheck && npm run test && npm run build"},"_npmUser":{"name":"brightbeamai","email":"eng-admin@brightbeam.com"},"repository":{"url":"git+https://github.com/BrightbeamAI/chap.git","type":"git","directory":"packages/coordinator-mcp"},"_npmVersion":"11.17.0","description":"MCP server adapter for the CHAP Coordinator. Exposes every CHAP method as an MCP tool.","directories":{},"_nodeVersion":"26.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","@brightbeamai/chap-coordinator":"^0.2.10"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.5.1","typescript":"^5.3.0","@types/node":"^20.11.0","@modelcontextprotocol/sdk":"^1.30.0","@brightbeamai/chap-coordinator":"file:../coordinator"},"_npmOperationalInternal":{"tmp":"tmp/chap-coordinator-mcp_0.2.11_1787246064321_0.9673617406856556","host":"s3://npm-registry-packages-npm-production"}},"0.2.12":{"name":"@brightbeamai/chap-coordinator-mcp","version":"0.2.12","keywords":["chap","mcp","model-context-protocol","agent","tool","claude"],"author":{"name":"Brightbeam AI","email":"oss@brightbeam.com"},"license":"Apache-2.0","_id":"@brightbeamai/chap-coordinator-mcp@0.2.12","maintainers":[{"name":"brightbeamai","email":"eng-admin@brightbeam.com"}],"homepage":"https://github.com/BrightbeamAI/chap","bugs":{"url":"https://github.com/BrightbeamAI/chap/issues"},"bin":{"chap-mcp-server":"dist/cli.js"},"dist":{"shasum":"251fbc631d64212fe725a4b7e85a2711a3f32e3e","tarball":"https://registry.npmjs.org/@brightbeamai/chap-coordinator-mcp/-/chap-coordinator-mcp-0.2.12.tgz","fileCount":27,"integrity":"sha512-N6xdI2QVQEMd6HjbIxPgbcCQ3/mwuNjQmW7cCtuDgcnsWgqmITaAoSBSZ2EXuKcVS09qHGs3AQxYjinIkyKvWQ==","signatures":[{"sig":"MEUCIQD6wbAMIRWEcnKSI4jrodaGlpeqbFWVXocScCxDNIF47QIgDjEg67gkSfnEYxvaCUpd7WCIMQNTH64QqCOxHcfMMtY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6436402},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./cli":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"},"./tools":{"types":"./dist/tools.d.ts","import":"./dist/tools.js","require":"./dist/tools.cjs"},"./schemas":{"types":"./dist/schemas.d.ts","import":"./dist/schemas.js","require":"./dist/schemas.cjs"}},"gitHead":"d1a1c387739727612b34b9df6402b85ab8eb584b","mcpName":"io.github.BrightbeamAI/chap","scripts":{"test":"tsx --test tests/*.test.ts","build":"tsup","typecheck":"tsc","prepublishOnly":"npm run typecheck && npm run test && npm run build"},"_npmUser":{"name":"brightbeamai","email":"eng-admin@brightbeam.com"},"repository":{"url":"git+https://github.com/BrightbeamAI/chap.git","type":"git","directory":"packages/coordinator-mcp"},"_npmVersion":"11.17.0","description":"MCP server adapter for the CHAP Coordinator. Exposes every CHAP method as an MCP tool.","directories":{},"_nodeVersion":"26.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","@brightbeamai/chap-coordinator":"^0.2.12"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.5.1","typescript":"^5.3.0","@types/node":"^20.11.0","@modelcontextprotocol/sdk":"^1.30.0","@brightbeamai/chap-coordinator":"file:../coordinator"},"_npmOperationalInternal":{"tmp":"tmp/chap-coordinator-mcp_0.2.12_1788735148044_0.9043930148478059","host":"s3://npm-registry-packages-npm-production"}},"0.2.13":{"name":"@brightbeamai/chap-coordinator-mcp","version":"0.2.13","description":"MCP server adapter for the CHAP Coordinator. Exposes every CHAP method as an MCP tool.","license":"Apache-2.0","author":{"name":"Brightbeam AI","email":"oss@brightbeam.com"},"homepage":"https://github.com/BrightbeamAI/chap","repository":{"type":"git","url":"git+https://github.com/BrightbeamAI/chap.git","directory":"packages/coordinator-mcp"},"bugs":{"url":"https://github.com/BrightbeamAI/chap/issues"},"keywords":["chap","mcp","model-context-protocol","agent","tool","claude"],"mcpName":"io.github.BrightbeamAI/chap","type":"module","engines":{"node":">=20"},"bin":{"chap-mcp-server":"dist/cli.js"},"main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./schemas":{"types":"./dist/schemas.d.ts","import":"./dist/schemas.js","require":"./dist/schemas.cjs"},"./tools":{"types":"./dist/tools.d.ts","import":"./dist/tools.js","require":"./dist/tools.cjs"},"./cli":{"types":"./dist/cli.d.ts","import":"./dist/cli.js"}},"scripts":{"build":"tsup","test":"tsx --test tests/*.test.ts","typecheck":"tsc","prepublishOnly":"npm run typecheck && npm run test && npm run build"},"dependencies":{"@brightbeamai/chap-coordinator":"^0.2.13","@modelcontextprotocol/sdk":"^1.30.0","zod":"^3.25 || ^4.0"},"devDependencies":{"@brightbeamai/chap-coordinator":"file:../coordinator","@modelcontextprotocol/sdk":"^1.30.0","zod":"^3.25 || ^4.0","@types/node":"^20.11.0","tsup":"^8.5.1","tsx":"^4.7.0","typescript":"^5.3.0"},"publishConfig":{"access":"public"},"gitHead":"8ac178aac3e9059f62e9c1b030307f530e57a9c6","_id":"@brightbeamai/chap-coordinator-mcp@0.2.13","_nodeVersion":"26.5.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-MjK4vDk3bBr0z6Oojd2gnOejPS0f3QjIUeNNTaGe0DzVkhUPjGhEcVc2Gjz/zARwvk4KnCZI3vgTVbniHKMJkw==","shasum":"a448b13bae4d78952e99feaa0996ca768f6fea57","tarball":"https://registry.npmjs.org/@brightbeamai/chap-coordinator-mcp/-/chap-coordinator-mcp-0.2.13.tgz","fileCount":27,"unpackedSize":842425,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCgO/EF6/uiQrZN5S/uXIKAdFso/NeiGdwd0yo+30li4QIgHKrwmcQzOx9D/MPqHu6d8l+IitVJxEXTadUT7R1kHAg="}]},"_npmUser":{"name":"brightbeamai","email":"eng-admin@brightbeam.com"},"directories":{},"maintainers":[{"name":"brightbeamai","email":"eng-admin@brightbeam.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/chap-coordinator-mcp_0.2.13_1788795997715_0.9804517181865229"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-17T10:55:31.235Z","modified":"2026-09-07T15:46:38.068Z","0.2.9":"2026-08-17T10:55:31.595Z","0.2.10":"2026-08-20T16:46:19.028Z","0.2.11":"2026-08-20T17:14:24.524Z","0.2.12":"2026-09-06T22:52:28.234Z","0.2.13":"2026-09-07T15:46:37.868Z"},"bugs":{"url":"https://github.com/BrightbeamAI/chap/issues"},"author":{"name":"Brightbeam AI","email":"oss@brightbeam.com"},"license":"Apache-2.0","homepage":"https://github.com/BrightbeamAI/chap","keywords":["chap","mcp","model-context-protocol","agent","tool","claude"],"repository":{"type":"git","url":"git+https://github.com/BrightbeamAI/chap.git","directory":"packages/coordinator-mcp"},"description":"MCP server adapter for the CHAP Coordinator. Exposes every CHAP method as an MCP tool.","maintainers":[{"name":"brightbeamai","email":"eng-admin@brightbeam.com"}],"readme":"# @brightbeamai/chap-coordinator-mcp\n\nMCP server adapter for the CHAP Coordinator. Wraps a `Coordinator`\ninstance and exposes every CHAP method as an [MCP](https://modelcontextprotocol.io)\ntool, so any MCP client (Claude Desktop, Cursor, Claude Code, the\nrest) can drive a CHAP workspace directly.\n\nSpec target: **MCP 2026-07-28**, serving MCP 2025-11-25 clients as well · CHAP 0.2.\n\n## Run it as a server\n\nThe package ships a stdio server, so an MCP client can use CHAP without any\ncode. Point the client at it:\n\n```json\n{\n  \"mcpServers\": {\n    \"chap\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@brightbeamai/chap-coordinator-mcp\"],\n      \"env\": { \"CHAP_DB_PATH\": \"~/chap.db\" }\n    }\n  }\n}\n```\n\nAll 39 methods arrive as tools named `chap.<method>`. Two environment\nvariables configure it:\n\n| Variable | Effect |\n|----------|--------|\n| `CHAP_DB_PATH` | Path to a SQLite file. Without it the coordinator runs in memory and every workspace is lost when the client restarts. |\n| `CHAP_PROFILES` | Comma-separated profiles for new workspaces. Defaults to Core plus review, whisper, deliberation, handoff, control, routing, modes and audit-scitt, so the audit chain is on from the first entry. |\n\nPersistence needs `better-sqlite3`, an optional native dependency of the\ncoordinator. If `CHAP_DB_PATH` is set and it cannot be loaded the server says\nso and exits rather than starting in memory and discarding the decisions it\nwas asked to keep.\n\nThe server is also listed in the [MCP registry](https://registry.modelcontextprotocol.io)\nas `io.github.BrightbeamAI/chap`.\n\n## Install\n\n```bash\nnpm install @brightbeamai/chap-coordinator-mcp\n```\n\nNode 20+ required. Runtime dependencies: `@brightbeamai/chap-coordinator`,\n`@modelcontextprotocol/sdk` and `zod`. The binary is `chap-mcp-server`.\n\n## Quick start\n\n```typescript\nimport { Coordinator } from \"@brightbeamai/chap-coordinator\";\nimport { makeChapMcpServer } from \"@brightbeamai/chap-coordinator-mcp\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\n\nconst coord = new Coordinator({\n  defaultProfiles: [\"core/1.0\", \"review/1.0\", \"audit-scitt/1.0\"],\n});\n\nconst server = makeChapMcpServer(coord, { name: \"chap\", version: \"0.2.13\" });\nawait server.connect(new StdioServerTransport());\n```\n\nThe returned `Server` is the official MCP SDK's `Server` class with\n`tools/list` and `tools/call` handlers pre-registered. Attach any MCP\ntransport (stdio, Streamable HTTP, etc.).\n\nA runnable reference server is at\n[`reference/mcp-server-ts/`](../../reference/mcp-server-ts/).\n\n## What gets exposed\n\nAll 39 CHAP methods become MCP tools named `chap.<method>`. Each\ntool's `inputSchema` is the JSON Schema for the corresponding method's\nparams. Tool descriptions are tuned for LLM consumption.\n\nThe `chap.` prefix avoids collisions with other MCP servers a client\nmight have loaded simultaneously.\n\n## Architecture\n\n- **One Coordinator, one MCP server.** Multi-workspace is handled\n  inside the Coordinator (workspaces are addressable by id); the MCP\n  layer is stateless and routes every tool call through\n  `coord.dispatch()`.\n- **Single-sourced schemas.** Tool inputs are described by JSON\n  Schemas (not Zod) and passed straight to the Coordinator without\n  re-validation at the MCP layer. The Coordinator's own dispatch\n  validates params and returns spec-correct JSON-RPC error codes,\n  which the adapter surfaces as MCP tool errors.\n- **Auth deferred.** The adapter ships unauthenticated; MCP's\n  OAuth 2.1 auth model attaches at the Streamable HTTP transport,\n  not inside the adapter.\n\n## Tests\n\n```bash\nnpm test\n```\n\nThe integration tests use the SDK's `InMemoryTransport.createLinkedPair()`\nto drive a wrapped Coordinator end-to-end, exercising every major\nprofile.\n\n## See also\n\n- The integration narrative: [`integrations/CHAP-with-MCP.md`](../../integrations/CHAP-with-MCP.md)\n- The five-minute walkthrough: [`examples/drive-chap-from-claude-desktop.md`](../../examples/drive-chap-from-claude-desktop.md)\n- The Python counterpart: [`chap_coordinator.transports.mcp_server`](../coordinator-py/chap_coordinator/transports/mcp_server.py)\n\n## License\n\nApache 2.0. See the parent repository's [LICENSE](../../LICENSE).\n","readmeFilename":"README.md"}