addai-widgetstudio

MCP server for +Ai Widget Studio — manage widgets v2 from Claude Code.

What it does

This is an MCP (Model Context Protocol) server that lets Claude Code create, edit, publish, and manage +Ai Widget Studio widgets directly from your terminal. It talks to the hosted widgets-v2-api edge function — your workspace API key controls which widgets you can see and modify.

Install + setup

npx addai-widgetstudio setup

The setup script prompts for your API key and writes the right entry into ~/.claude.json (and Claude Desktop's config on macOS/Windows). Then restart Claude Code (or run /mcp to reconnect).

Get an API key

Sign in to the +Ai Widget Studio app and visit:

https://<your-domain>/<workspace-slug>/widgets/api-keys

Generate one key per workspace. The key looks like wid_live_….

Manual install

If you'd rather edit ~/.claude.json yourself, add this under "mcpServers":

"addai-widgetstudio": {
  "command": "npx",
  "args": ["-y", "addai-widgetstudio"],
  "env": {
    "ADDAI_WIDGETS_V2_API_KEY": "wid_live_..."
  }
}

Restart Claude Code afterwards.

Available tools

Once connected, the MCP exposes:

• list_widgets, get_widget, create_widget
• update_view, update_actions, update_manifest
• set_visibility, grant_workspace, revoke_workspace, list_grants
• publish, get_runtime
• test_action, get_instance_state

Agent guidance prompts (workflow, manifest shape, action handler API) are loaded automatically when the server starts.

Source / contribute

Source lives at just-AddAi/addai-widgetstudio — see the mcp/ directory.