{"_id":"@arcana-ui/mcp","_rev":"2-0f8e2c05c26acf8ae3c5a0100cf240d3","name":"@arcana-ui/mcp","dist-tags":{"beta":"0.1.0-beta.1","latest":"0.1.0"},"versions":{"0.1.0-beta.1":{"name":"@arcana-ui/mcp","version":"0.1.0-beta.1","keywords":["arcana","arcana-ui","mcp","model-context-protocol","ai","design-system","claude"],"license":"MIT","_id":"@arcana-ui/mcp@0.1.0-beta.1","maintainers":[{"name":"garrettbear","email":"garrett@201lab.com"}],"homepage":"https://arcana-ui.com","bugs":{"url":"https://github.com/Arcana-UI/arcana/issues"},"bin":{"arcana-mcp":"dist/index.js"},"dist":{"shasum":"186d547829f4a0ba0f8cdad739fdffdc3bb5eabd","tarball":"https://registry.npmjs.org/@arcana-ui/mcp/-/mcp-0.1.0-beta.1.tgz","fileCount":3,"integrity":"sha512-8//+vKVdVhtEtrIl+en12e7IR9YrvEFQBvT3wmnuBx4xZjy6YyqD+OHakr62Zd7FpBx9QsgqR2LrUyQiQmTg9g==","signatures":[{"sig":"MEYCIQDTKE5pjKrVKuXUK0TlyUU6gJ5Xk2kn3BpYXDzZylt0jgIhAI9geOXB1Sp6VF4ltn/OVTkdBjDT9qXSe1gl6XxoZjHH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1162616},"type":"module","engines":{"node":">=18.17.0"},"gitHead":"d96ada0205f299ad99a3f03f03c665e4285a5e79","scripts":{"dev":"tsup --watch","build":"tsup","clean":"rm -rf dist src/data","prebuild":"node scripts/copy-data.mjs","typecheck":"tsc --noEmit","prepublishOnly":"pnpm build"},"_npmUser":{"name":"garrettbear","email":"garrett@201lab.com"},"repository":{"url":"git+https://github.com/Arcana-UI/arcana.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.11.1","description":"MCP server for Arcana UI — gives AI agents (Claude, Cursor, Codex) full access to Arcana components, presets, and token system","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","typescript":"^5.6.3","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0-beta.1_1775710084886_0.8894660141117348","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@arcana-ui/mcp","version":"0.1.0","description":"MCP server for Arcana UI — gives AI agents (Claude, Cursor, Codex) full access to Arcana components, presets, and token system","license":"MIT","type":"module","bin":{"arcana-mcp":"dist/index.js"},"scripts":{"prebuild":"node scripts/copy-data.mjs","build":"tsup","dev":"tsup --watch","clean":"rm -rf dist src/data","typecheck":"tsc --noEmit","prepublishOnly":"pnpm build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.10.0","tsup":"^8.3.5","typescript":"^5.6.3"},"engines":{"node":">=18.17.0"},"repository":{"type":"git","url":"git+https://github.com/Arcana-UI/arcana.git","directory":"packages/mcp"},"homepage":"https://arcana-ui.com","keywords":["arcana","arcana-ui","mcp","model-context-protocol","ai","design-system","claude"],"publishConfig":{"access":"public"},"gitHead":"2119b15a05993da15a6e61ccb496c86df110573f","_id":"@arcana-ui/mcp@0.1.0","bugs":{"url":"https://github.com/Arcana-UI/arcana/issues"},"_nodeVersion":"25.6.1","_npmVersion":"11.11.1","dist":{"integrity":"sha512-PBtdqUyBjrtKjmbZ/2aQgRfPTwMmoGDuXULdFRNkZrGXkk1ez+vuQb1N5i3Am2T7Dftz2z5kFnE4JtF/H8NaCw==","shasum":"9e829ec9de6044b93e4b40aee3979846fbdbb624","tarball":"https://registry.npmjs.org/@arcana-ui/mcp/-/mcp-0.1.0.tgz","fileCount":3,"unpackedSize":1166207,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHZ8Yha8Scd3TF8SYu3bmEMGjbu840/ZS+kPNEnfqhVsAiBvHKiZcSkOqangilROmGeJbArUSMOr/WkZbi1qcVXz0w=="}]},"_npmUser":{"name":"garrettbear","email":"garrett@201lab.com"},"directories":{},"maintainers":[{"name":"garrettbear","email":"garrett@201lab.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.0_1776353548422_0.5890162901784111"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-09T04:48:04.811Z","modified":"2026-04-16T15:32:28.684Z","0.1.0-beta.1":"2026-04-09T04:48:05.011Z","0.1.0":"2026-04-16T15:32:28.560Z"},"bugs":{"url":"https://github.com/Arcana-UI/arcana/issues"},"license":"MIT","homepage":"https://arcana-ui.com","keywords":["arcana","arcana-ui","mcp","model-context-protocol","ai","design-system","claude"],"repository":{"type":"git","url":"git+https://github.com/Arcana-UI/arcana.git","directory":"packages/mcp"},"description":"MCP server for Arcana UI — gives AI agents (Claude, Cursor, Codex) full access to Arcana components, presets, and token system","maintainers":[{"name":"garrettbear","email":"garrett@201lab.com"}],"readme":"# @arcana-ui/mcp\n\nMCP (Model Context Protocol) server for Arcana UI. Gives AI agents — Claude Code, Cursor, Codex, Figma Make — full programmatic access to Arcana component docs, theme presets, and the token system.\n\n## Setup\n\n### Claude Code\n\nAdd to `.claude/settings.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"arcana-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"@arcana-ui/mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"arcana-ui\": {\n      \"command\": \"npx\",\n      \"args\": [\"@arcana-ui/mcp\"]\n    }\n  }\n}\n```\n\n### Global install (optional, faster startup)\n\n```bash\nnpm install -g @arcana-ui/mcp\n```\n\nThen reference `arcana-mcp` instead of `npx @arcana-ui/mcp`.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_components` | List all 105+ components, optionally filtered by category |\n| `get_component` | Full docs for a component: props table, examples, tokens, accessibility |\n| `list_presets` | All 14 theme presets with descriptions and best-use guidance |\n| `get_preset` | Complete JSON configuration for a specific preset |\n| `validate_theme` | Validate a theme JSON: structure, completeness, WCAG contrast |\n| `generate_theme` | AI-generate a theme from a brand description (requires `ANTHROPIC_API_KEY`) |\n| `get_token_impact` | See all components affected by changing a design token |\n\n## Example Usage\n\nOnce connected, Claude can:\n\n```\n\"Build me a SaaS analytics dashboard using Arcana UI with the midnight theme\"\n→ Claude calls list_components, get_component('Navbar'), get_preset('midnight'),\n  generates complete working code\n```\n\n```\n\"What components use --color-bg-surface?\"\n→ Claude calls get_token_impact('--color-bg-surface')\n```\n\n```\n\"Validate my custom theme JSON\"\n→ Claude calls validate_theme({ ...your theme JSON... })\n```\n\n## AI Theme Generation\n\nThe `generate_theme` tool calls the Anthropic API to produce theme JSON from a description:\n\n```\n\"Generate a theme for: fintech dashboard, navy and gold, professional\"\n```\n\nRequires `ANTHROPIC_API_KEY` in your environment. Without it, the tool returns instructions for using the [playground](https://arcana-ui.dev) instead.\n\n## Links\n\n- [Arcana UI docs](https://arcana-ui.dev)\n- [npm: @arcana-ui/core](https://www.npmjs.com/package/@arcana-ui/core)\n- [GitHub](https://github.com/Arcana-UI/arcana)\n","readmeFilename":"README.md"}