{"_id":"@addai/widgets-mcp","name":"@addai/widgets-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@addai/widgets-mcp","version":"0.1.0","description":"MCP server for +AI Widgets - create, edit, and manage embeddable widgets via AI assistants","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"widgets-mcp":"dist/index.js","widgets-mcp-install":"dist/bin/install.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","test":"tsc && node --test 'dist/test/**/*.test.js'"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.23.0"},"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"engines":{"node":">=18"},"keywords":["mcp","ai-widgets","addai","claude","model-context-protocol","shadcn","embeddable-widgets"],"license":"MIT","_id":"@addai/widgets-mcp@0.1.0","gitHead":"0f723340a2d2f55dee9821f2daf92896886769b5","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-vrOVpYJOY04f0zlgP7m8YV+c4YbEzRg4Zd+ChYIuu0zXbQdJLjeg+vg4vfDtn9HcCHPdA+3LtgJUiPPr0iciNA==","shasum":"70715548c2cb2840093e57d14a417182e0a6877d","tarball":"https://registry.npmjs.org/@addai/widgets-mcp/-/widgets-mcp-0.1.0.tgz","fileCount":29,"unpackedSize":79387,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCxqXU0IKY0J3R5WfiyXgei0UtjwuBdtvQUMPJU7bW9oAIhALuw1jmwS3UN6T/9R3aXjEJNQ4fqXjhg78EmJ3hzFi9v"}]},"_npmUser":{"name":"addai","email":"npm@add.ai"},"directories":{},"maintainers":[{"name":"addai","email":"npm@add.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/widgets-mcp_0.1.0_1776947795543_0.2864570487851297"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-23T12:36:35.350Z","0.1.0":"2026-04-23T12:36:35.729Z","modified":"2026-04-23T12:36:35.941Z"},"maintainers":[{"name":"addai","email":"npm@add.ai"}],"description":"MCP server for +AI Widgets - create, edit, and manage embeddable widgets via AI assistants","keywords":["mcp","ai-widgets","addai","claude","model-context-protocol","shadcn","embeddable-widgets"],"license":"MIT","readme":"# @addai/widgets-mcp\n\nMCP (Model Context Protocol) server for **+AI Widgets**. Gives AI assistants full control over embeddable widgets — create, edit, style, add actions, generate with AI, and get embed code from Claude or any MCP-compatible client.\n\n## Quick Install\n\n```bash\nnpx @addai/widgets-mcp install\n```\n\nThis will:\n1. Ask for your API key\n2. Validate the key\n3. Add the MCP server to your Claude configuration\n4. Install the building-widgets skill\n\n## Manual Setup\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"addai-widgets\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@addai/widgets-mcp@latest\"],\n      \"env\": {\n        \"ADDAI_API_KEY\": \"your-api-key-here\",\n        \"ADDAI_SUPABASE_URL\": \"https://syhzpqqvrplaqdipcymw.supabase.co\"\n      }\n    }\n  }\n}\n```\n\nFor Claude Code, add to `~/.claude/settings.local.json` with `\"type\": \"stdio\"`.\n\n## Tools (24)\n\n### Widget Management\n| Tool | Description |\n|------|-------------|\n| `list_widgets` | List all widgets in the workspace |\n| `get_widget` | Get widget with view, state, schema, and actions |\n| `create_widget` | Create a new widget |\n| `update_widget` | Update widget properties |\n| `delete_widget` | Delete a widget |\n| `duplicate_widget` | Clone a widget |\n\n### View / State / Schema\n| Tool | Description |\n|------|-------------|\n| `update_widget_view` | Update the JSX view template |\n| `update_widget_state` | Update the default state JSON |\n| `update_widget_schema` | Update the Zod schema |\n| `generate_widget` | AI-generate view + state + schema from description |\n\n### Actions\n| Tool | Description |\n|------|-------------|\n| `list_widget_actions` | List widget actions |\n| `create_widget_action` | Create HTTP or host action |\n| `update_widget_action` | Update action config |\n| `delete_widget_action` | Delete an action |\n| `test_widget_action` | Test an action with state |\n| `execute_widget_action` | Execute a saved action |\n\n### Secrets\n| Tool | Description |\n|------|-------------|\n| `list_widget_secrets` | List secrets (values masked) |\n| `create_widget_secret` | Add a secret for action templates |\n| `update_widget_secret` | Update a secret |\n| `delete_widget_secret` | Delete a secret |\n\n### Embed\n| Tool | Description |\n|------|-------------|\n| `get_embed_url` | Get embed URLs (edge function + React) |\n| `get_embed_code` | Get ready-to-use iframe + JS embed code |\n\n### Reference\n| Tool | Description |\n|------|-------------|\n| `list_components` | List all ShadCN components by category |\n| `get_component_info` | Get detailed component props + examples |\n\n## building-widgets Skill\n\nThis package ships a Claude skill for guided widget authoring. The installer copies it to `~/.claude/skills/building-widgets/`. Invoke `Skill(\"building-widgets\")` to load the workflow, recipes, and anti-patterns.\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `ADDAI_API_KEY` | Yes | — | Your Widgets API key |\n| `ADDAI_SUPABASE_URL` | No | Production URL | Supabase project URL |\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-197454173c3c82ef062a22dda0470127"}