{"_id":"@caputchin/mcp","_rev":"7-0e3091970431e9a5effb5a9971ad81ba","name":"@caputchin/mcp","dist-tags":{"latest":"2.2.0"},"versions":{"1.0.0":{"name":"@caputchin/mcp","version":"1.0.0","keywords":["caputchin","mcp","model-context-protocol","ai","management"],"license":"MIT","_id":"@caputchin/mcp@1.0.0","maintainers":[{"name":"caputchiner","email":"info@caputchin.com"}],"homepage":"https://github.com/Caputchin/caputchin-sdk#readme","bugs":{"url":"https://github.com/Caputchin/caputchin-sdk/issues"},"bin":{"caputchin-mcp":"dist/cli.js"},"dist":{"shasum":"824160a00a9fd47dac0fa3d60c5545d1659060cd","tarball":"https://registry.npmjs.org/@caputchin/mcp/-/mcp-1.0.0.tgz","fileCount":6,"integrity":"sha512-sNkh0boXgOqH/d1QI5p6Yq7fcVREyPKZ+CKk/qR4jbbacTG3pg9HPN/YdFxLpG4ZHqR/eAARKc6Pqdg6tF/MkA==","signatures":[{"sig":"MEYCIQD8dYK0UjYPngyF9vpdI1Sv2dkhpLQBiLuqLqC/NnDLBwIhANmex0UwcNAuyJ9lLQDIDYqmswfXYZyesca3oljxwuiu","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41049},"type":"module","_from":"file:caputchin-mcp-1.0.0.tgz","exports":{"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js"},"./package.json":"./package.json"},"scripts":{"test":"vitest run","build":"tsup","start":"node dist/cli.js","coverage":"vitest run --coverage","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"caputchiner","email":"info@caputchin.com"},"_resolved":"/tmp/2ebcea2a73417c8f39b7b91283791dbb/caputchin-mcp-1.0.0.tgz","_integrity":"sha512-sNkh0boXgOqH/d1QI5p6Yq7fcVREyPKZ+CKk/qR4jbbacTG3pg9HPN/YdFxLpG4ZHqR/eAARKc6Pqdg6tF/MkA==","repository":{"url":"git+https://github.com/Caputchin/caputchin-sdk.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for managing Caputchin resources via AI agents","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"~1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1778672464157_0.5697483066775373","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@caputchin/mcp","version":"2.0.0","keywords":["caputchin","mcp","model-context-protocol","ai","management"],"license":"Apache-2.0","_id":"@caputchin/mcp@2.0.0","maintainers":[{"name":"caputchiner","email":"info@caputchin.com"}],"homepage":"https://github.com/Caputchin/caputchin-sdk#readme","bugs":{"url":"https://github.com/Caputchin/caputchin-sdk/issues"},"bin":{"caputchin-mcp":"dist/cli.js"},"dist":{"shasum":"ee4b91e625be4c5ffd5c54607023bf34c8393a23","tarball":"https://registry.npmjs.org/@caputchin/mcp/-/mcp-2.0.0.tgz","fileCount":6,"integrity":"sha512-TTSCfO0IJBNKZ0Mp8q2boZDBDzZAuoceoPUoo0UCR6e0p3UVJrDBBfN9PFVQ/xU3s5Y4/IuD9VHBEqEC3mwZyQ==","signatures":[{"sig":"MEUCIQC+ngFfIWCwJBrrs9akEztWilsptlKUKBRLopS6UZ+qkwIgNc/PBg883RGgUZbYCzX0p+bJocl06WRhTiwIBXaLbNo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43439},"type":"module","_from":"file:caputchin-mcp-2.0.0.tgz","exports":{"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js"},"./package.json":"./package.json"},"scripts":{"test":"vitest run","build":"tsup","start":"node dist/cli.js","coverage":"vitest run --coverage","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"caputchiner","email":"info@caputchin.com"},"_resolved":"/tmp/39e1a1186c7fd5a11e0d06d8c7b68a0e/caputchin-mcp-2.0.0.tgz","_integrity":"sha512-TTSCfO0IJBNKZ0Mp8q2boZDBDzZAuoceoPUoo0UCR6e0p3UVJrDBBfN9PFVQ/xU3s5Y4/IuD9VHBEqEC3mwZyQ==","repository":{"url":"git+https://github.com/Caputchin/caputchin-sdk.git","type":"git"},"_npmVersion":"10.9.8","description":"stdio MCP adapter for Caputchin: proxies the canonical /api/mcp tool catalogue and ships offline dev-onboarding tools.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"~1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_2.0.0_1779554490286_0.6961107129930781","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@caputchin/mcp","version":"2.0.1","keywords":["caputchin","mcp","model-context-protocol","ai","management"],"license":"Apache-2.0","_id":"@caputchin/mcp@2.0.1","maintainers":[{"name":"caputchiner","email":"info@caputchin.com"}],"homepage":"https://github.com/Caputchin/caputchin-sdk#readme","bugs":{"url":"https://github.com/Caputchin/caputchin-sdk/issues"},"bin":{"caputchin-mcp":"dist/cli.js"},"dist":{"shasum":"b98cb1daa91073c5e52b12521a3d5975c44f5427","tarball":"https://registry.npmjs.org/@caputchin/mcp/-/mcp-2.0.1.tgz","fileCount":6,"integrity":"sha512-zrLymJboaL4B6+Vkd8fS7bDlBINosismWZmLVGmMaK+w/GqRq6ofinElElZV24k4GfqUiwawsyiNXDfnD7wL9w==","signatures":[{"sig":"MEQCIHRwkBAvAIMwdwKkYJYVzYkDQB5YoPx1PvgUiP9zAZtoAiBGvyFD1OL6q/vwLlW1ydoDms3gAKvp1UVLYy6Gueuu9g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43441},"type":"module","_from":"file:caputchin-mcp-2.0.1.tgz","exports":{"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js"},"./package.json":"./package.json"},"scripts":{"test":"vitest run","build":"tsup","start":"node dist/cli.js","coverage":"vitest run --coverage","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"caputchiner","email":"info@caputchin.com"},"_resolved":"/tmp/542cbe020aba96edd2f01081e0b0130e/caputchin-mcp-2.0.1.tgz","_integrity":"sha512-zrLymJboaL4B6+Vkd8fS7bDlBINosismWZmLVGmMaK+w/GqRq6ofinElElZV24k4GfqUiwawsyiNXDfnD7wL9w==","repository":{"url":"git+https://github.com/Caputchin/caputchin-sdk.git","type":"git"},"_npmVersion":"10.9.8","description":"stdio MCP adapter for Caputchin: proxies the canonical /api/mcp tool catalogue and ships offline dev-onboarding tools.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"~1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^2.0.0","typescript":"^5.4.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^2.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_2.0.1_1779648433372_0.9985275928899031","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@caputchin/mcp","version":"2.1.0","keywords":["caputchin","mcp","model-context-protocol","ai","management"],"license":"Apache-2.0","_id":"@caputchin/mcp@2.1.0","maintainers":[{"name":"caputchiner","email":"info@caputchin.com"}],"homepage":"https://github.com/Caputchin/caputchin-sdk#readme","bugs":{"url":"https://github.com/Caputchin/caputchin-sdk/issues"},"bin":{"caputchin-mcp":"dist/cli.js"},"dist":{"shasum":"62ab783ef4b26d07057c95536fb6f3b5502daa49","tarball":"https://registry.npmjs.org/@caputchin/mcp/-/mcp-2.1.0.tgz","fileCount":6,"integrity":"sha512-Wq37zL0SvysStZ2yiga2xTLxABpQ+veFyvcrbZeJKmIkCUuI2rwca+fVSm5zty1v86ANpF5ksZfa1AdzXbADsQ==","signatures":[{"sig":"MEUCIQDSfPDNZmQuDtWlVUZsg4kpZo8Z0w2kkYwD51Wvz+I5mgIgKl6RDEtlrN0ogZEaywWWguo+X3bCKT1ngsbusAQtWa8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44968},"type":"module","_from":"file:caputchin-mcp-2.1.0.tgz","exports":{"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js"},"./package.json":"./package.json"},"scripts":{"docs":"typedoc && node ../../scripts/normalize-docs.mjs docs","test":"vitest run","build":"tsup","start":"node dist/cli.js","coverage":"vitest run --coverage","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"caputchiner","email":"info@caputchin.com"},"_resolved":"/tmp/147fd018ff4f80b8ae4a27c17e36ebc0/caputchin-mcp-2.1.0.tgz","_integrity":"sha512-Wq37zL0SvysStZ2yiga2xTLxABpQ+veFyvcrbZeJKmIkCUuI2rwca+fVSm5zty1v86ANpF5ksZfa1AdzXbADsQ==","repository":{"url":"git+https://github.com/Caputchin/caputchin-sdk.git","type":"git"},"_npmVersion":"11.13.0","description":"stdio MCP adapter for Caputchin: proxies the canonical /api/mcp tool catalogue and ships offline dev-onboarding tools.","directories":{},"_nodeVersion":"24.16.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"~1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^2.0.0","typedoc":"^0.28.19","typescript":"^5.4.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^2.0.0","typedoc-plugin-markdown":"^4.11.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_2.1.0_1780680142766_0.24608285721984524","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@caputchin/mcp","version":"2.1.1","keywords":["caputchin","mcp","model-context-protocol","ai","management"],"license":"Apache-2.0","_id":"@caputchin/mcp@2.1.1","maintainers":[{"name":"caputchiner","email":"info@caputchin.com"}],"homepage":"https://github.com/Caputchin/caputchin-sdk#readme","bugs":{"url":"https://github.com/Caputchin/caputchin-sdk/issues"},"bin":{"caputchin-mcp":"dist/cli.js"},"dist":{"shasum":"7f9ae50ad77807076d4224750dec864a7bac5e51","tarball":"https://registry.npmjs.org/@caputchin/mcp/-/mcp-2.1.1.tgz","fileCount":6,"integrity":"sha512-KHzlSQGBCNB7EKZkGOaWMGsb5YJASpTus+l2p/Nk59fA7kheAucmtGEJ05oDV7T74m0vAD1o/WUdvePKDUJiFQ==","signatures":[{"sig":"MEUCIQCy8jDJ5mCSyvP/YLYjUB76dTGx+/oEbGARAdCmVfiM8QIgQoMTmC38QNiM3fSeaIhPd93Y2z3SJoMH0STvSo2xlIw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44968},"type":"module","_from":"file:caputchin-mcp-2.1.1.tgz","exports":{"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js"},"./package.json":"./package.json"},"scripts":{"docs":"typedoc && node ../../scripts/normalize-docs.mjs docs","test":"vitest run","build":"tsup","start":"node dist/cli.js","coverage":"vitest run --coverage","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"caputchiner","email":"info@caputchin.com"},"_resolved":"/tmp/c254c37387b00371b1728b45ced14d53/caputchin-mcp-2.1.1.tgz","_integrity":"sha512-KHzlSQGBCNB7EKZkGOaWMGsb5YJASpTus+l2p/Nk59fA7kheAucmtGEJ05oDV7T74m0vAD1o/WUdvePKDUJiFQ==","repository":{"url":"git+https://github.com/Caputchin/caputchin-sdk.git","type":"git"},"_npmVersion":"11.13.0","description":"stdio MCP adapter for Caputchin: proxies the canonical /api/mcp tool catalogue and ships offline dev-onboarding tools.","directories":{},"_nodeVersion":"24.16.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"~1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^2.0.0","typedoc":"^0.28.19","typescript":"^5.4.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^2.0.0","typedoc-plugin-markdown":"^4.11.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_2.1.1_1781221178809_0.25896901203807143","host":"s3://npm-registry-packages-npm-production"}},"2.1.2":{"name":"@caputchin/mcp","version":"2.1.2","keywords":["caputchin","mcp","model-context-protocol","ai","management"],"license":"Apache-2.0","_id":"@caputchin/mcp@2.1.2","maintainers":[{"name":"caputchiner","email":"info@caputchin.com"}],"homepage":"https://github.com/Caputchin/caputchin-sdk#readme","bugs":{"url":"https://github.com/Caputchin/caputchin-sdk/issues"},"bin":{"caputchin-mcp":"dist/cli.js"},"dist":{"shasum":"9d623baa16e992d828e944dadd29038e5487b4cd","tarball":"https://registry.npmjs.org/@caputchin/mcp/-/mcp-2.1.2.tgz","fileCount":6,"integrity":"sha512-38yqYbz47g/QShBNQSmS1eh/xMA5yHbfovBJBpNRsDOAacif9VKrFUL5ex0cRiI96JSSyCmQ6/+B6tfvp9edFA==","signatures":[{"sig":"MEUCIQDHvu31L8VqKdtGyoND5UBlrymRHkz1CTGD+MD+gcuNcwIgb5c0Nsw92GQ/AlIIHFBWRVL5vuS1KfgKcwub8xYm/Dk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47366},"type":"module","_from":"file:caputchin-mcp-2.1.2.tgz","exports":{"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js"},"./package.json":"./package.json"},"scripts":{"docs":"typedoc && node ../../scripts/normalize-docs.mjs docs","test":"vitest run","build":"tsup","start":"node dist/cli.js","coverage":"vitest run --coverage","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"caputchiner","email":"info@caputchin.com"},"_resolved":"/tmp/e6309bc192b1cef0c14cb0376c22745e/caputchin-mcp-2.1.2.tgz","_integrity":"sha512-38yqYbz47g/QShBNQSmS1eh/xMA5yHbfovBJBpNRsDOAacif9VKrFUL5ex0cRiI96JSSyCmQ6/+B6tfvp9edFA==","repository":{"url":"git+https://github.com/Caputchin/caputchin-sdk.git","type":"git"},"_npmVersion":"11.13.0","description":"stdio MCP adapter for Caputchin: proxies the canonical /api/mcp tool catalogue and ships offline dev-onboarding tools.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"~1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^2.0.0","typedoc":"^0.28.19","typescript":"^5.4.0","@types/node":"^22.0.0","@vitest/coverage-v8":"^2.0.0","typedoc-plugin-markdown":"^4.11.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_2.1.2_1782732015404_0.5557770926020664","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@caputchin/mcp","version":"2.2.0","description":"stdio MCP adapter for Caputchin: proxies the canonical /api/mcp tool catalogue and ships offline dev-onboarding tools.","keywords":["caputchin","mcp","model-context-protocol","ai","management"],"homepage":"https://github.com/Caputchin/caputchin-sdk#readme","repository":{"type":"git","url":"git+https://github.com/Caputchin/caputchin-sdk.git"},"bugs":{"url":"https://github.com/Caputchin/caputchin-sdk/issues"},"license":"Apache-2.0","type":"module","publishConfig":{"access":"public"},"bin":{"caputchin-mcp":"dist/cli.js"},"exports":{"./server":{"types":"./dist/server.d.ts","import":"./dist/server.js"},"./package.json":"./package.json"},"dependencies":{"@modelcontextprotocol/sdk":"~1.29.0","zod":"^4.4.3"},"devDependencies":{"@types/node":"^22.0.0","@vitest/coverage-v8":"^2.0.0","tsup":"^8.0.0","typedoc":"^0.28.19","typedoc-plugin-markdown":"^4.11.0","typescript":"^5.4.0","vitest":"^2.0.0"},"scripts":{"build":"tsup","typecheck":"tsc --noEmit","test":"vitest run","test:watch":"vitest","coverage":"vitest run --coverage","start":"node dist/cli.js","docs":"typedoc && node ../../scripts/normalize-docs.mjs docs"},"_id":"@caputchin/mcp@2.2.0","_integrity":"sha512-7bk2eXiA3HZip1OC23qiI4I8x7yqkA94REUM9yQ7YHN2nmgSM5mabUsUXiKFuoOrceUmG/spyo3Wsyf/rbcf2g==","_resolved":"/tmp/10a41a59ef0cd4901832de0d89e8412b/caputchin-mcp-2.2.0.tgz","_from":"file:caputchin-mcp-2.2.0.tgz","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-7bk2eXiA3HZip1OC23qiI4I8x7yqkA94REUM9yQ7YHN2nmgSM5mabUsUXiKFuoOrceUmG/spyo3Wsyf/rbcf2g==","shasum":"76911332ab16fc4cfb064a6f16dd4b45cb6e469d","tarball":"https://registry.npmjs.org/@caputchin/mcp/-/mcp-2.2.0.tgz","fileCount":6,"unpackedSize":47532,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD9Du3q7QO1aW12boCP3V7TrzgXo9kkLsCIqem4DZg2WAIhANq2wHVsdnshsdROk542XEQrR6xr8tytUd8Y+nQBmneH"}]},"_npmUser":{"name":"caputchiner","email":"info@caputchin.com"},"directories":{},"maintainers":[{"name":"caputchiner","email":"info@caputchin.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_2.2.0_1783585928844_0.3736561032473791"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-13T11:41:04.014Z","modified":"2026-07-09T08:32:09.078Z","1.0.0":"2026-05-13T11:41:04.317Z","2.0.0":"2026-05-23T16:41:30.447Z","2.0.1":"2026-05-24T18:47:13.531Z","2.1.0":"2026-06-05T17:22:22.925Z","2.1.1":"2026-06-11T23:39:38.968Z","2.1.2":"2026-06-29T11:20:15.531Z","2.2.0":"2026-07-09T08:32:08.977Z"},"bugs":{"url":"https://github.com/Caputchin/caputchin-sdk/issues"},"license":"Apache-2.0","homepage":"https://github.com/Caputchin/caputchin-sdk#readme","keywords":["caputchin","mcp","model-context-protocol","ai","management"],"repository":{"type":"git","url":"git+https://github.com/Caputchin/caputchin-sdk.git"},"description":"stdio MCP adapter for Caputchin: proxies the canonical /api/mcp tool catalogue and ships offline dev-onboarding tools.","maintainers":[{"name":"caputchiner","email":"info@caputchin.com"}],"readme":"# @caputchin/mcp\n\nModel Context Protocol server for Caputchin over stdio. Works with Claude\nDesktop, Cursor, Claude Code, and any other MCP client that speaks stdio.\n\nThis package is a thin stdio adapter: it proxies the canonical management\ntool catalogue served by Caputchin's `/mcp` HTTP endpoint, and adds\noffline developer-onboarding tools (HTML and backend snippet generators)\nthat need no Caputchin account. The full tool list is defined in\n[caputchin-platform/apps/web/src/lib/mcp-tools.ts](https://github.com/Caputchin/caputchin-platform/blob/main/apps/web/src/lib/mcp-tools.ts)\nand updates the moment a new platform version deploys, no SDK release\nneeded to pick up new tools.\n\n## Install + run\n\n```sh\nnpx @caputchin/mcp\n```\n\nSet the management token before launching:\n\n| Env var | Required | Default | Notes |\n|---|---|---|---|\n| `CAPUTCHIN_TOKEN` | yes (default mode) | (none) | Management token starting with `cpt_pat_`. Mint one from the dashboard. |\n| `CAPUTCHIN_API_HOST` | no | `https://api.caputchin.com` | Override for staging or self-hosted deployments. Trailing slashes are stripped. The endpoint is `${CAPUTCHIN_API_HOST}/mcp`. |\n\nRun in local-only mode (no token; only the offline snippet generators load):\n\n```sh\nnpx @caputchin/mcp --local-only\n```\n\n## Claude Desktop config\n\n```json\n{\n  \"mcpServers\": {\n    \"caputchin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@caputchin/mcp\"],\n      \"env\": {\n        \"CAPUTCHIN_TOKEN\": \"cpt_pat_...\"\n      }\n    }\n  }\n}\n```\n\n## Tool surface\n\n### Remote tools (proxied from `/mcp`)\n\nFetched live from the platform on first `tools/list`; cached for the\nsession. Adding or removing a tool only requires a platform deploy,\nthis package does not need a release. See the\n[Management API docs](https://github.com/Caputchin/caputchin/blob/main/docs/management-api.md)\nand the [canonical catalogue source](https://github.com/Caputchin/caputchin-platform/blob/main/apps/web/src/lib/mcp-tools.ts)\nfor the complete list of tool names + input schemas.\n\nIf the platform endpoint is unreachable at startup, the SDK still serves\nthe local tools and exposes a sentinel `caputchin_remote_unavailable`\ntool whose description carries the failure reason, your agent learns\nwhy the management surface is empty without you having to debug\nnetwork state.\n\n### Local tools (no network)\n\n| Tool | Description |\n|---|---|\n| `caputchin_widget_snippet` | Generate an HTML snippet that mounts the widget. |\n| `caputchin_siteverify_example` | Copy-paste backend `/siteverify` snippet (node, javascript, typescript, python, go, php, curl). |\n\n## Migrating from `@caputchin/mcp@1.x`\n\nThe 1.x line shipped its own bundled tool catalogue. 2.0.0 deletes that\ncatalogue and switches to live proxy of `/api/mcp`. Customer-visible\nimplications:\n\n- Tool names + input shapes are identical (they always were, the\n  bundled catalogue mirrored the platform).\n- New tools added to the platform after `@1.0.0` are now reachable\n  without an SDK upgrade.\n- Customers pinned on `@1.x` continue to work; that branch is no longer\n  updated. Upgrade to `@2.x` to get catalogue freshness.\n\n## Full reference\n\n- [docs/management-api.md](https://github.com/Caputchin/caputchin/blob/main/docs/management-api.md): Management API surface\n- [docs/api.md](https://github.com/Caputchin/caputchin/blob/main/docs/api.md): Runtime endpoints (browser-side + customer backend)\n","readmeFilename":"README.md"}