{"_id":"@act-sdk/mcp","_rev":"2-98613a0ba27b0b12b4e675821a124b44","name":"@act-sdk/mcp","dist-tags":{"latest":"3.0.1"},"versions":{"3.0.0":{"name":"@act-sdk/mcp","version":"3.0.0","_id":"@act-sdk/mcp@3.0.0","maintainers":[{"name":"act-sdk","email":"kupamakunura@gmail.com"}],"dist":{"shasum":"4449fcf59e2a6ba4a6ccd97c90cdb0d88bf98bef","tarball":"https://registry.npmjs.org/@act-sdk/mcp/-/mcp-3.0.0.tgz","fileCount":6,"integrity":"sha512-dRwkP0Owk0lMS24c7wUhOtMZ04CvlvCyclxyFhEHVfOvNECD4UmNWmEipkAVWSkB+VOkc4U8JUbg4PievRxTXw==","signatures":[{"sig":"MEUCIQCYrCgJUJD0MWjWjKSbj0syaveZv8f3EboKQNiD0vt21QIgElR+8+8owjpzdptwUkG7mfbZUm0tCh8oHlza5GAk7Ws=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9977},"main":"./dist/index.js","type":"module","_from":"file:act-sdk-mcp-3.0.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"private":false,"scripts":{"dev":"tsup --watch","build":"tsup","typecheck":"pnpm -s tsc --noEmit -p tsconfig.json"},"_npmUser":{"name":"act-sdk","email":"kupamakunura@gmail.com"},"_resolved":"/tmp/4caccbaff76da8f31deda6a6dbd4c6a5/act-sdk-mcp-3.0.0.tgz","_integrity":"sha512-dRwkP0Owk0lMS24c7wUhOtMZ04CvlvCyclxyFhEHVfOvNECD4UmNWmEipkAVWSkB+VOkc4U8JUbg4PievRxTXw==","_npmVersion":"11.6.4","description":"Translate Act SDK actions into MCP tools.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.0 || ^4.0.0","@act-sdk/core":"3.0.0","@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"peerDependencies":{"zod":"^3.25.0 || ^4.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_3.0.0_1775193762555_0.6277222097363406","host":"s3://npm-registry-packages-npm-production"}},"3.0.1":{"name":"@act-sdk/mcp","version":"3.0.1","private":false,"type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","zod":"^3.25.0 || ^4.0.0","@act-sdk/core":"3.0.1"},"peerDependencies":{"zod":"^3.25.0 || ^4.0.0"},"scripts":{"build":"tsup","dev":"tsup --watch","typecheck":"pnpm -s tsc --noEmit -p tsconfig.json"},"_id":"@act-sdk/mcp@3.0.1","description":"Translate Act SDK actions into MCP tools.","_integrity":"sha512-X4VlT9WHdoknnetrGU2HSOUNOOfsGoF+XtGptqmqreO7vSIEnzxgjh3ej3xwP+ys63iVEGGRwpYGe28kjeoivQ==","_resolved":"/tmp/608539db1c40165b6a3857eb6a7da1a5/act-sdk-mcp-3.0.1.tgz","_from":"file:act-sdk-mcp-3.0.1.tgz","_nodeVersion":"22.17.1","_npmVersion":"11.6.4","dist":{"integrity":"sha512-X4VlT9WHdoknnetrGU2HSOUNOOfsGoF+XtGptqmqreO7vSIEnzxgjh3ej3xwP+ys63iVEGGRwpYGe28kjeoivQ==","shasum":"d8cbffe7eb64c5bd016817ee29a25000d1203f8a","tarball":"https://registry.npmjs.org/@act-sdk/mcp/-/mcp-3.0.1.tgz","fileCount":6,"unpackedSize":9977,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFxwNIa2KEnIz6m7KjT3NyaXBBPoPq/0rQJ3qYNkyXrjAiAAyvDnbVTSO1eC6/IEzKjWe4llGoa26TwaHx8iZp7Dug=="}]},"_npmUser":{"name":"act-sdk","email":"kupamakunura@gmail.com"},"directories":{},"maintainers":[{"name":"act-sdk","email":"kupamakunura@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_3.0.1_1775195721303_0.43779321061608334"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-03T05:22:42.453Z","modified":"2026-04-03T05:55:21.565Z","3.0.0":"2026-04-03T05:22:42.699Z","3.0.1":"2026-04-03T05:55:21.450Z"},"description":"Translate Act SDK actions into MCP tools.","maintainers":[{"name":"act-sdk","email":"kupamakunura@gmail.com"}],"readme":"# @act-sdk/mcp\n\nTranslate Act SDK actions into MCP tools.\n\n## What is this?\n\nConverts your Act SDK action registry into an MCP server. Usually used via adapters, not directly.\n\n## Installation\n\n```bash\nnpm install @act-sdk/mcp @act-sdk/core\n```\n\n## Usage\n\n```typescript\nimport { createServer, registerTools } from '@act-sdk/mcp';\nimport config from './act-sdk.config';\n\n// Create MCP server from config\nconst server = createServer(config);\n\n// Or register tools on existing server\nconst server = new McpServer({ \n  name: 'my-app', \n  description: 'My server' \n});\nregisterTools(server, config);\n```\n\n## With Authentication Context\n\nPass auth context to all tool handlers:\n\n```typescript\nimport { createServer } from '@act-sdk/mcp';\n\n// Static context\nconst server = createServer(config, { \n  authInfo: { userId: '123' } \n});\n\n// Dynamic context (called per request)\nconst server = createServer(config, () => ({ \n  authInfo: getCurrentUser() \n}));\n```\n\n## API\n\n### `createServer(config, contextOrProvider?)`\n\nCreate an MCP server from your Act SDK config.\n\n**Parameters:**\n- `config` - ActSdkConfig with your action registry\n- `contextOrProvider` - Optional auth context or provider function\n\n**Returns:** `McpServer` instance\n\n### `registerTools(server, config, contextOrProvider?)`\n\nRegister actions as MCP tools on an existing server.\n\n**Parameters:**\n- `server` - Existing MCP server instance\n- `config` - ActSdkConfig with your action registry\n- `contextOrProvider` - Optional auth context or provider function\n\n## How It Works\n\nEach registered action becomes an MCP tool:\n- Action `id` → tool name\n- Action `description` → tool description\n- Action `input` schema → tool input schema\n- Validates input with Zod before calling handler\n- Passes context to handler for auth/request data\n\n## Direct Usage Not Recommended\n\nMost users should use **@act-sdk/adapters** instead:\n- `@act-sdk/adapters/stdio` - For CLI tools\n- `@act-sdk/adapters/nextjs` - For Next.js apps\n\nThese adapters call `createServer()` internally with proper transport setup.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}