{"_id":"@a11code/mcp","_rev":"5-c04f753b6ca9b11fcb48236327920904","name":"@a11code/mcp","dist-tags":{"latest":"0.24.1"},"versions":{"0.21.0":{"name":"@a11code/mcp","version":"0.21.0","license":"MIT","_id":"@a11code/mcp@0.21.0","maintainers":[{"name":"a11tech","email":"magicforestapp@gmail.com"}],"bin":{"a11-mcp":"dist/server.js"},"dist":{"shasum":"32ce4c23ded0c9b9073cc01f14c32d5e3ae503e2","tarball":"https://registry.npmjs.org/@a11code/mcp/-/mcp-0.21.0.tgz","fileCount":4,"integrity":"sha512-oqQggAwtk6RTxw7QEeMCYNOFBZ+LfRinZAHDj9/cx55jETJ9VBNu53hx1M9QoTFLo7UHL4R8oa74DVEyjKmXiw==","signatures":[{"sig":"MEUCIAZJGJfCDNj0ft+XD3Ax8YnqwgK5fwXwvIgVMnO3bvGHAiEAmSLvd3PnQUM6RJaKcccaEELK+VZdwc0kgfk8jeFb/cA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1061499},"main":"dist/server.js","types":"dist/server.d.ts","engines":{"node":">=20"},"gitHead":"bab2f9e83fb7c88bded5a6eac9da5bd9861f5400","scripts":{"dev":"tsup src/server.ts --format cjs --watch --target node20","test":"yarn build && tsx tests/runAll.ts","build":"tsup src/server.ts --format cjs --dts --clean --target node20","test:fast":"tsx tests/runAll.ts","typecheck":"tsc --noEmit","prepublishOnly":"yarn typecheck && yarn test && yarn build"},"_npmUser":{"name":"a11tech","email":"magicforestapp@gmail.com"},"_npmVersion":"10.9.1","description":"A11 MCP server — dev-time tools for coding agents building on A11","directories":{},"resolutions":{"zod":"^3.25.76"},"_nodeVersion":"23.3.0","dependencies":{"zod":"^3.25.76","@a11code/sdk":"^0.1.6","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","jest":"^29.7.0","next":"14","tsup":"^8.0.0","react":"^18.2.0","fastify":"^5.8.5","ts-jest":"^29.1.0","typescript":"^5.4.0","@types/jest":"^29.5.0","@types/node":"^20.0.0","@types/react":"^18.2.0","@types/express":"^5.0.6","@tanstack/react-router":"^1.170.15"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.21.0_1784929868842_0.13455248878533754","host":"s3://npm-registry-packages-npm-production"}},"0.22.0":{"name":"@a11code/mcp","version":"0.22.0","license":"MIT","_id":"@a11code/mcp@0.22.0","maintainers":[{"name":"a11tech","email":"magicforestapp@gmail.com"}],"bin":{"a11-mcp":"dist/server.js"},"dist":{"shasum":"74f5ffcdce6546faecc1d4c4c14ff584a6495a84","tarball":"https://registry.npmjs.org/@a11code/mcp/-/mcp-0.22.0.tgz","fileCount":4,"integrity":"sha512-8awevH86Yt3hRKQ/F+K2r+b/rifhVNEGAilPgYxQmumuZdT4qIo9s0oyOLHOGOvS89E6zTkhVm4KxirQVSkmWA==","signatures":[{"sig":"MEQCIC6ty5EGP1BM9TFnQpThQceaoNf+WbJiqzdSPikX0AvQAiBS6UuBVqe1gjJECuDyt/sQIVmiteImO9PuENwZC4YToA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1066910},"main":"dist/server.js","types":"dist/server.d.ts","engines":{"node":">=20"},"gitHead":"8a5ec2c8c02140f51454d9b6d204cd2851b6f37d","scripts":{"dev":"tsup src/server.ts --format cjs --watch --target node20","test":"yarn build && tsx tests/runAll.ts","build":"tsup src/server.ts --format cjs --dts --clean --target node20","test:fast":"tsx tests/runAll.ts","typecheck":"tsc --noEmit","prepublishOnly":"yarn typecheck && yarn test && yarn build"},"_npmUser":{"name":"a11tech","email":"magicforestapp@gmail.com"},"_npmVersion":"10.9.1","description":"A11 MCP server — dev-time tools for coding agents building on A11","directories":{},"resolutions":{"zod":"^3.25.76"},"_nodeVersion":"23.3.0","dependencies":{"zod":"^3.25.76","@a11code/sdk":"^0.1.6","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","jest":"^29.7.0","next":"14","tsup":"^8.0.0","react":"^18.2.0","fastify":"^5.8.5","ts-jest":"^29.1.0","typescript":"^5.4.0","@types/jest":"^29.5.0","@types/node":"^20.0.0","@types/react":"^18.2.0","@types/express":"^5.0.6","@tanstack/react-router":"^1.170.15"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.22.0_1785946839829_0.23675669574726","host":"s3://npm-registry-packages-npm-production"}},"0.23.0":{"name":"@a11code/mcp","version":"0.23.0","license":"SEE LICENSE IN LICENSE","_id":"@a11code/mcp@0.23.0","maintainers":[{"name":"a11tech","email":"magicforestapp@gmail.com"}],"bin":{"a11-mcp":"dist/server.js"},"dist":{"shasum":"49c9f8bcf62ce8cd7d2870ffea9b0fab2aa44084","tarball":"https://registry.npmjs.org/@a11code/mcp/-/mcp-0.23.0.tgz","fileCount":5,"integrity":"sha512-/+77wACZooQDCgF6vik47lxIhChz2//CkNuOeeneqKU+kV5befcZjIyAK6D49XhHCDnp+yxtuxWqX8lIidoYFw==","signatures":[{"sig":"MEQCIBUGECClagenjYgnHAIL4/zAuli1KJ3vW8tF8JMRxTLYAiBklt5hURe2sNtCd4uYmpzJcw5r9DEylMoBrKFDYInKLg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1075563},"main":"dist/server.js","types":"dist/server.d.ts","engines":{"node":">=20"},"gitHead":"960f3d2ab375c73862b8d68317459ea7f726a45f","scripts":{"dev":"tsup src/server.ts --format cjs --watch --target node20","test":"yarn build && tsx tests/runAll.ts","build":"tsup src/server.ts --format cjs --dts --clean --target node20","test:fast":"tsx tests/runAll.ts","typecheck":"tsc --noEmit","prepublishOnly":"yarn typecheck && yarn test && yarn build"},"_npmUser":{"name":"a11tech","email":"magicforestapp@gmail.com"},"_npmVersion":"10.9.1","description":"A11 MCP server — dev-time tools for coding agents building on A11","directories":{},"resolutions":{"zod":"^3.25.76"},"_nodeVersion":"23.3.0","dependencies":{"zod":"^3.25.76","@a11code/sdk":"^0.1.6","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","next":"14","tsup":"^8.0.0","react":"^18.2.0","fastify":"^5.8.5","typescript":"^5.4.0","@types/node":"^20.0.0","@types/react":"^18.2.0","@types/express":"^5.0.6","@tanstack/react-router":"^1.170.15"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.23.0_1786055688254_0.5527560972454155","host":"s3://npm-registry-packages-npm-production"}},"0.24.0":{"name":"@a11code/mcp","version":"0.24.0","license":"SEE LICENSE IN LICENSE","_id":"@a11code/mcp@0.24.0","maintainers":[{"name":"a11tech","email":"magicforestapp@gmail.com"}],"bin":{"a11-mcp":"dist/server.js"},"dist":{"shasum":"90f2d372c7d536d1afa4a7fe68135c859e642aa8","tarball":"https://registry.npmjs.org/@a11code/mcp/-/mcp-0.24.0.tgz","fileCount":5,"integrity":"sha512-bEJu0Ir856h1VfFDJlv0EEprRJjqLEnZIr3rR4m/48PIC4x2JgDmEqwNefxuELi/RsoUgHhxDJV3R0ueu1BmJw==","signatures":[{"sig":"MEYCIQCfs1yRb441G7Xxihbb58VnBAXlRPsxgCoQpe0F4SK9aAIhAJQw0aK23hO2AZaEoUlSr/L4Af2C1b/G9Mw1bTNw+Tlf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1075551},"main":"dist/server.js","types":"dist/server.d.ts","engines":{"node":">=20"},"gitHead":"35546e1affcecfb6a7f5eb7fbf9736f4e672616e","scripts":{"dev":"tsup src/server.ts --format cjs --watch --target node20","test":"yarn build && tsx tests/runAll.ts","build":"tsup src/server.ts --format cjs --dts --clean --target node20","test:fast":"tsx tests/runAll.ts","typecheck":"tsc --noEmit","prepublishOnly":"yarn typecheck && yarn test && yarn build"},"_npmUser":{"name":"a11tech","email":"magicforestapp@gmail.com"},"_npmVersion":"10.9.1","description":"A11 MCP server — dev-time tools for coding agents building on A11","directories":{},"resolutions":{"zod":"^3.25.76"},"_nodeVersion":"23.3.0","dependencies":{"zod":"^3.25.76","@a11code/sdk":"^0.2.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","next":"14","tsup":"^8.0.0","react":"^18.2.0","fastify":"^5.8.5","typescript":"^5.4.0","@types/node":"^20.0.0","@types/react":"^18.2.0","@types/express":"^5.0.6","@tanstack/react-router":"^1.170.15"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.24.0_1786132216092_0.7660581368156751","host":"s3://npm-registry-packages-npm-production"}},"0.24.1":{"name":"@a11code/mcp","version":"0.24.1","description":"A11 MCP server — dev-time tools for coding agents building on A11","license":"SEE LICENSE IN LICENSE","main":"dist/server.js","types":"dist/server.d.ts","bin":{"a11-mcp":"dist/server.js"},"scripts":{"build":"tsup src/server.ts --format cjs --dts --clean --target node20","dev":"tsup src/server.ts --format cjs --watch --target node20","test":"yarn build && tsx tests/runAll.ts","test:fast":"tsx tests/runAll.ts","typecheck":"tsc --noEmit","prepublishOnly":"yarn typecheck && yarn test && yarn build"},"engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","@a11code/sdk":"^0.2.0","zod":"^3.25.76"},"resolutions":{"zod":"^3.25.76"},"devDependencies":{"@tanstack/react-router":"^1.170.15","@types/express":"^5.0.6","@types/node":"^20.0.0","@types/react":"^18.2.0","esbuild":"^0.27.7","fastify":"^5.8.5","next":"14","react":"^18.2.0","tsup":"^8.0.0","tsx":"^4.21.0","typescript":"^5.4.0"},"publishConfig":{"access":"public"},"_id":"@a11code/mcp@0.24.1","gitHead":"2abd39280236e423b9c99ad9ce5f201702238fee","_nodeVersion":"23.3.0","_npmVersion":"10.9.1","dist":{"integrity":"sha512-x4k+TsoiJEQ1AEBAIy6zUCksYvIYycAJmxjxwjnN22S0JXeI65eaBMHkZZHrr3+UvBt6XGLDPV+77EsXvtgphg==","shasum":"71010adc05f3873886bb68b7e7e7127a31cceea0","tarball":"https://registry.npmjs.org/@a11code/mcp/-/mcp-0.24.1.tgz","fileCount":5,"unpackedSize":1106403,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDfFvyxN0AhGi1kQCvqpGQ8uSV53MpYkR6pvMr6hW9/XgIhAKq7OoQ/c/NniaFfEgdmAJNfIoZpaSOLDcXbA81V27XU"}]},"_npmUser":{"name":"a11tech","email":"magicforestapp@gmail.com"},"directories":{},"maintainers":[{"name":"a11tech","email":"magicforestapp@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.24.1_1787069742285_0.41127370647542816"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-24T21:51:08.700Z","modified":"2026-08-18T16:15:42.677Z","0.21.0":"2026-07-24T21:51:09.034Z","0.22.0":"2026-08-05T16:20:39.989Z","0.23.0":"2026-08-06T22:34:48.461Z","0.24.0":"2026-08-07T19:50:16.244Z","0.24.1":"2026-08-18T16:15:42.448Z"},"license":"SEE LICENSE IN LICENSE","description":"A11 MCP server — dev-time tools for coding agents building on A11","maintainers":[{"name":"a11tech","email":"magicforestapp@gmail.com"}],"readme":"# @a11code/mcp\n\nDev-time MCP server for coding agents building on A11. Exposes a small set of typed, opinionated tools that hide the multi-step orchestrations (image-upload dance, collection-shaped record CRUD, loading-state-correct scaffolds) that agents otherwise get wrong when synthesising from prose.\n\n**Strictly a dev-time aide.** Runs locally on one developer's machine alongside their coding agent. Never installed in production; never on a hot path.\n\n## Install / run\n\nRequires Node ≥ 20.\n\n```bash\nnpx -y @a11code/mcp\n```\n\nReads `A11_API_KEY` from the environment. The `a11 init` CLI registers this server automatically into `.mcp.json` / `.cursor/mcp.json` / `.windsurf/mcp.json` for the project.\n\n## Tools (v1)\n\n### `define_collection`\nWrites a project-local schema file `.a11/collections/<name>.json`. No backend write — A11 records are schemaless on the API side; the schema is a scaffold-time artifact that travels with the repo.\n\n### `scaffold_list_page`\nReads a collection schema and emits three React/TSX files: a list page with skeleton-card loading state, a card component, and a create form that uses `records.create` + (optional) `storage.uploadTo`. Templates are seeded from the canonical voice-memo example and the `frontend-ui` loading-pattern matrix, and style exclusively through the generated `src/templates/uiTokens.ts` (compiled from the A11 UI Constitution §4 — raw colour literals are banned by `tests/uiTokenDiscipline.test.ts`).\n\n### `upload_and_attach`\nThin wrapper around `@a11code/sdk`'s `storage.uploadTo(recordId, fieldName, file)`. Lets the agent verify the upload dance against a real API key during development without writing throwaway code.\n\n## What this is **not**\n\n- A production runtime component. Customer apps in production call `api.a11.tech` directly via `@a11code/sdk`. The MCP server is never on that path.\n- A replacement for the cookbook. The cookbook still ships and is the fallback for tasks not covered by tools.\n- Language-agnostic for scaffolds. v1 emits TS/React only; Go/PHP scaffold template families land post-beta. The other two tools work for any customer language.\n","readmeFilename":"README.md"}