{"_id":"@atomic-content-protocol/mcp","_rev":"4-84089e4cf4cb687509163c65ee233251","name":"@atomic-content-protocol/mcp","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@atomic-content-protocol/mcp","version":"0.1.0","keywords":["acp","atomic-content-protocol","mcp","model-context-protocol","ai","llm"],"author":{"url":"https://www.stacks.inc/","name":"Stacks, Inc"},"license":"Apache-2.0","_id":"@atomic-content-protocol/mcp@0.1.0","maintainers":[{"name":"stacklist","email":"kyle@stacklist.com"},{"name":"acp-sdk","email":"martina@stacklist.com"}],"homepage":"https://atomiccontentprotocol.org","bugs":{"url":"https://github.com/atomic-content-protocol/sdk/issues"},"dist":{"shasum":"1c5e92dd7b417d096893f22244e94f1038c43cf3","tarball":"https://registry.npmjs.org/@atomic-content-protocol/mcp/-/mcp-0.1.0.tgz","fileCount":91,"integrity":"sha512-0ZmUlfE4RYfeBYEBjq32zmy2Augvcha595LqcCb6xcjNu/qdTaU4V3UEb9Vf7kJuKB5+p3LYZIYoxtY6/x99ew==","signatures":[{"sig":"MEUCIQCHvQk4uFchhOEooAnfKl7jhhTqZVNGlRpfk9JYHf+B/wIgJJVGHUhuFtdJJYOHYwaflU0XBbK7PC6DVmEw8QGhXRg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148918},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b374e870c9830e3f660264b1a61dbc4417ebb552","scripts":{"lint":"tsc --noEmit","test":"echo 'No tests yet'","build":"tsc","clean":"rm -rf dist"},"_npmUser":{"name":"acp-sdk","email":"martina@stacklist.com"},"repository":{"url":"git+https://github.com/atomic-content-protocol/sdk.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.9.2","description":"MCP server for the Atomic Content Protocol — exposes ACO tools to AI agents","directories":{},"_nodeVersion":"23.6.1","dependencies":{"zod":"^3.24.0","zod-to-json-schema":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0","@atomic-content-protocol/core":"^0.1.0","@atomic-content-protocol/enrichment":"^0.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.1.0","typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1776630936172_0.639303851235193","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@atomic-content-protocol/mcp","version":"0.1.1","keywords":["acp","atomic-content-protocol","mcp","model-context-protocol","ai","llm"],"author":{"url":"https://www.stacks.inc/","name":"Stacks, Inc"},"license":"Apache-2.0","_id":"@atomic-content-protocol/mcp@0.1.1","maintainers":[{"name":"stacklist","email":"kyle@stacklist.com"},{"name":"acp-sdk","email":"martina@stacklist.com"}],"homepage":"https://atomiccontentprotocol.org","bugs":{"url":"https://github.com/atomic-content-protocol/sdk/issues"},"dist":{"shasum":"d2dec5fa784cc164e3c99ef03902ae1ede7f1018","tarball":"https://registry.npmjs.org/@atomic-content-protocol/mcp/-/mcp-0.1.1.tgz","fileCount":95,"integrity":"sha512-oFTyKav4J4cDFztaxIreVi9z5sn8p7a1Sr1orArN75hrTF92wlABcssSqXap1IMmhm5S2bpjmiDCfB5IDbvTww==","signatures":[{"sig":"MEUCIH6Ev72NSK6Ebk7WkpjNwYpuKgiDM/kYvrsfvwTpVnUKAiEAmBaqyvNpisI00P4KoTXknwfKDDgQcxqGODwQblSMY9k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":150325},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"47ae86e3becfdac45001f8a0dbc34b1fb6dfec34","scripts":{"lint":"tsc --noEmit","test":"echo 'No tests yet'","build":"tsc","clean":"rm -rf dist"},"_npmUser":{"name":"acp-sdk","email":"martina@stacklist.com"},"repository":{"url":"git+https://github.com/atomic-content-protocol/sdk.git","type":"git","directory":"packages/mcp"},"_npmVersion":"10.9.2","description":"MCP server for the Atomic Content Protocol — exposes ACO tools to AI agents","directories":{},"_nodeVersion":"23.6.1","dependencies":{"zod":"^3.24.0","zod-to-json-schema":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0","@atomic-content-protocol/core":"^0.1.1","@atomic-content-protocol/enrichment":"^0.1.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.1.0","typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1776716791954_0.7357097462006592","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@atomic-content-protocol/mcp","version":"0.2.0","keywords":["acp","atomic-content-protocol","mcp","model-context-protocol","ai","llm"],"author":{"url":"https://www.stacks.inc/","name":"Stacks, Inc"},"license":"Apache-2.0","_id":"@atomic-content-protocol/mcp@0.2.0","maintainers":[{"name":"stacklist","email":"kyle@stacklist.com"},{"name":"acp-sdk","email":"martina@stacklist.com"}],"homepage":"https://atomiccontentprotocol.org","bugs":{"url":"https://github.com/atomic-content-protocol/sdk/issues"},"dist":{"shasum":"6071063afc3f11b4e3220b650bf6f2cd55b87d5b","tarball":"https://registry.npmjs.org/@atomic-content-protocol/mcp/-/mcp-0.2.0.tgz","fileCount":107,"integrity":"sha512-52UdxsdqhIiZiA7NdDqBOuJy+HigMVgeijCEOb37P/TMK8rM54zploe/WMssV6Yim9yHHtXWdt9EliOBTXBlBA==","signatures":[{"sig":"MEUCIQCzmUp0pZaT4Bjxwpxez+8QuOS5BLozsKNGCuwtZw8uvQIgC/Wnnn6NtPqZJ/oSitH7C41eauZUGMNWevo8TNlDgwU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atomic-content-protocol%2fmcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":157995},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"gitHead":"36e5541054e17d16a94c3152556dbfb16b7f177d","scripts":{"lint":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","test":"vitest run","build":"tsc","clean":"rm -rf dist"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:43ed966a-63bd-4fa6-bb67-85fca82844de"}},"repository":{"url":"git+https://github.com/atomic-content-protocol/sdk.git","type":"git","directory":"packages/mcp"},"_npmVersion":"12.0.2","description":"MCP server for the Atomic Content Protocol — exposes ACO tools to AI agents","directories":{},"_nodeVersion":"22.23.2","dependencies":{"zod":"^3.24.0","zod-to-json-schema":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0","@atomic-content-protocol/core":"^0.2.0","@atomic-content-protocol/enrichment":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^5.0.0","typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1789375571241_0.2799376155007325","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@atomic-content-protocol/mcp","version":"0.2.1","description":"MCP server for the Atomic Content Protocol — exposes ACO tools to AI agents","author":{"name":"Stacks, Inc","url":"https://www.stacks.inc/"},"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"scripts":{"build":"tsc","test":"vitest run","clean":"rm -rf dist","lint":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json"},"dependencies":{"@atomic-content-protocol/core":"^0.2.1","@atomic-content-protocol/enrichment":"^0.2.1","@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.24.0","zod-to-json-schema":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0","vitest":"^5.0.0"},"license":"Apache-2.0","engines":{"node":">=20.0.0"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/atomic-content-protocol/sdk.git","directory":"packages/mcp"},"homepage":"https://atomiccontentprotocol.org","bugs":{"url":"https://github.com/atomic-content-protocol/sdk/issues"},"keywords":["acp","atomic-content-protocol","mcp","model-context-protocol","ai","llm"],"gitHead":"5d1371c8fa4d990983eb12de2b3f9660ca244b88","_id":"@atomic-content-protocol/mcp@0.2.1","_nodeVersion":"22.23.2","_npmVersion":"12.0.2","dist":{"integrity":"sha512-331dNwaOjHfzqZ+9LIZ9LW7EoLfOnXGsU4YrBmHlIfOWrRtfZGcLfUwzOIaQuAKKMBir0oPCWWJCpBTM0ka5lg==","shasum":"aec17f6aad7ec26930775054a71258475fe1e31f","tarball":"https://registry.npmjs.org/@atomic-content-protocol/mcp/-/mcp-0.2.1.tgz","fileCount":107,"unpackedSize":157995,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atomic-content-protocol%2fmcp@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDMrSkXSu3pUn7qEAy/feiGEs68+fiVKa6JVGQxcroBxwIhAKAwPJ96GuqzDYeMF1fMknuEoAkXPFpDaXR9i0jjpsCg"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:43ed966a-63bd-4fa6-bb67-85fca82844de"}},"directories":{},"maintainers":[{"name":"stacklist","email":"kyle@stacklist.com"},{"name":"acp-sdk","email":"martina@stacklist.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.1_1789387258978_0.8282799058940935"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-19T20:35:36.079Z","modified":"2026-09-14T12:00:59.567Z","0.1.0":"2026-04-19T20:35:36.331Z","0.1.1":"2026-04-20T20:26:32.094Z","0.2.0":"2026-09-14T08:46:11.376Z","0.2.1":"2026-09-14T12:00:59.098Z"},"bugs":{"url":"https://github.com/atomic-content-protocol/sdk/issues"},"author":{"name":"Stacks, Inc","url":"https://www.stacks.inc/"},"license":"Apache-2.0","homepage":"https://atomiccontentprotocol.org","keywords":["acp","atomic-content-protocol","mcp","model-context-protocol","ai","llm"],"repository":{"type":"git","url":"git+https://github.com/atomic-content-protocol/sdk.git","directory":"packages/mcp"},"description":"MCP server for the Atomic Content Protocol — exposes ACO tools to AI agents","maintainers":[{"name":"stacklist","email":"kyle@stacklist.com"},{"name":"acp-sdk","email":"martina@stacklist.com"}],"readme":"# @atomic-content-protocol/mcp\n\nMCP server for the [Atomic Content Protocol](https://atomiccontentprotocol.org) — exposes ACO operations as tools that AI agents can call via the [Model Context Protocol](https://modelcontextprotocol.io).\n\n## Try it free — hosted server\n\nA hosted MCP server is live at [`mcp.atomiccontentprotocol.org`](https://mcp.atomiccontentprotocol.org/mcp). Use it as a **custom connector** in Claude Desktop, Cursor, or any MCP-compatible client — **on us**. No install, no API keys, no setup. We cover the LLM costs.\n\n### Add to Claude Desktop\n\nSettings → Connectors → *Add custom connector*\n\n- **Name:** `ACP`\n- **URL:** `https://mcp.atomiccontentprotocol.org/mcp`\n\nThe `enrich_url`, `enrich_content`, and `enrich_batch` tools are immediately available in any chat.\n\nRate-limited to 50 enrichments/hour per client (a batch of N counts as N). For higher limits, private data, or self-hosting, use the package below and bring your own key.\n\n## Self-host\n\n```bash\nnpm install @atomic-content-protocol/mcp @atomic-content-protocol/core\n```\n\n```typescript\nimport { ACPMCPServer } from \"@atomic-content-protocol/mcp\";\nimport { FilesystemAdapter } from \"@atomic-content-protocol/core\";\n\nconst storage = new FilesystemAdapter(\"./my-vault\");\n\nconst server = new ACPMCPServer({\n  storage,\n  enrichment: {\n    providers: {\n      anthropic: { apiKey: process.env.ANTHROPIC_API_KEY! },\n    },\n  },\n});\n\nawait server.start();\n```\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `create_aco`, `read_aco`, `update_aco`, `delete_aco`, `list_acos` | CRUD over the vault. `update_aco` accepts `relationships` and `body`. |\n| `create_container`, `read_container`, `list_containers` | Group ACOs. |\n| `enrich_aco`, `enrich_batch` | Run pipelines (`unified`, `tag`, `summary`, `entity`, `classification`, `embed`). Existing values are kept unless `force`. `embed` stores a vector for search. |\n| `search_acos`, `find_similar` | Full-text search; vector similarity over stored embeddings with overlap fallback. |\n| `detect_relationships` | Suggest edges from overlap + stored embeddings; apply with `update_aco`. |\n| `validate_vault`, `export_aco` | Schema validation report; Markdown/JSON export. |\n\n## Exports\n\n- `ACPMCPServer` — server class (`listTools()`, `callTool()`, `start()`, `close()`)\n- `ToolRegistry` — per-instance registry (the module-level `registerTool` family is deprecated)\n- `adaptToolForMCP`, `zodSchemaToJsonSchema` — adapter helpers\n- `PIPELINE_NAMES`, `needsPipeline`, `runPipelines` — enrichment helpers\n\n## Links\n\n- Protocol spec: [atomiccontentprotocol.org](https://atomiccontentprotocol.org)\n- Repository: [github.com/atomic-content-protocol/sdk](https://github.com/atomic-content-protocol/sdk)\n\n## Stewardship\n\nThe Atomic Content Protocol is an open standard stewarded by [Stacks, Inc](https://www.stacks.inc/) — the company behind [Stacklist](https://stacklist.com).\n\n## License\n\nApache-2.0\n","readmeFilename":"README.md"}