Skip to main content
Glama

πŸš€ Webstudio AI Agent & Local MCP Toolkit

A full-fledged autonomous bridge for AI agents (Antigravity, Cursor, Claude Code, Windsurf) that unlocks 100% of Webstudio MCP capabilities locally without any tariff restrictions, API limits, or access errors.

License: MIT Webstudio: Local MCP Node: >=18


🌟 The main problem and the solution

Typical work via Cloud API

Our autonomous bridge (Local MCP + Cloud Push)

❌ Blocked on free tiers (FORBIDDEN)

βœ… 100% free and without limits

❌ Requires paid API keys

βœ… Works offline directly with .webstudio/data.json

❌ Slow (dozens of network HTTP requests)

βœ… Instant generation (<500ms) thanks to Immer transactions

❌ Limited functionality

βœ… Full support for JSX, Radix UI, Animation Groups, Tokens, Collections


Related MCP server: Vibe Coder MCP Server

πŸ—οΈ Architecture (How it works)

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    AI CODING ASSISTANT                    β”‚
β”‚        (Google Antigravity, Cursor, Claude Code)          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                              β”‚
                              β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              LOCAL WEBSTUDIO MCP RUNTIME                  β”‚
β”‚       (70+ Official MCP Tools: insert-fragment, etc.)     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                              β”‚  (Fast Immer Local Mutation)
                              β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚               LOCAL PROJECT SOURCE OF TRUTH               β”‚
β”‚         .webstudio/data.json  &  .webstudio/assets/       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                              β”‚
                              β–Ό  webstudio import --to "<shareLink>"
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  WEBSTUDIO CLOUD BUILDER                  β”‚
β”‚         (ΠœΠΈΡ‚Ρ‚Ρ”Π²Π΅ відобраТСння Ρ€Π΅Π·ΡƒΠ»ΡŒΡ‚Π°Ρ‚Ρƒ Π² Ρ…ΠΌΠ°Ρ€Ρ–)         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

⚑ Installation (2 options to choose from)

# 1. Π’ΡΡ‚Π°Π½ΠΎΠ²Ρ–Ρ‚ΡŒ Webstudio локально Π² ΠΏΡ€ΠΎΠ΅ΠΊΡ‚
npm i webstudio

# 2. Π—Π°ΠΏΡƒΡΡ‚Ρ–Ρ‚ΡŒ ΠΏΠ°Ρ‚Ρ‡Π΅Ρ€
node scripts/setup-local-mcp.mjs --local

# 3. Π—Π°Π²Π°Π½Ρ‚Π°ΠΆΡ‚Π΅ ΠΏΡ€ΠΎΠ΅ΠΊΡ‚ Ρ–Π· Ρ…ΠΌΠ°Ρ€ΠΈ
npx webstudio sync --link "<shareLink>"

# 4. ВикористовуйтС MCP-інструмСнти для Π΄ΠΈΠ·Π°ΠΉΠ½Ρƒ
npx webstudio mcp single-op-call list-pages "{}"

# 5. Π’Ρ–Π΄ΠΏΡ€Π°Π²Ρ‚Π΅ ΠΎΠ½ΠΎΠ²Π»Π΅Π½ΠΈΠΉ Π΄ΠΈΠ·Π°ΠΉΠ½ Ρƒ Ρ…ΠΌΠ°Ρ€Ρƒ
npx webstudio import --to "<shareLink>"

Option B: Globally on the computer (Once for all projects)

# 1. Π’ΡΡ‚Π°Π½ΠΎΠ²Ρ–Ρ‚ΡŒ глобально
npm i -g webstudio

# 2. Π—Π°ΠΏΡƒΡΡ‚Ρ–Ρ‚ΡŒ ΠΏΠ°Ρ‚Ρ‡Π΅Ρ€
node scripts/setup-local-mcp.mjs

# 3. Π—Π°Π²Π°Π½Ρ‚Π°ΠΆΡ‚Π΅ ΠΏΡ€ΠΎΠ΅ΠΊΡ‚ Ρ–Π· Ρ…ΠΌΠ°Ρ€ΠΈ
webstudio sync --link "<shareLink>"

# 4. ВикористовуйтС MCP-інструмСнти для Π΄ΠΈΠ·Π°ΠΉΠ½Ρƒ
webstudio mcp single-op-call list-pages "{}"

# 5. Π’Ρ–Π΄ΠΏΡ€Π°Π²Ρ‚Π΅ ΠΎΠ½ΠΎΠ²Π»Π΅Π½ΠΈΠΉ Π΄ΠΈΠ·Π°ΠΉΠ½ Ρƒ Ρ…ΠΌΠ°Ρ€Ρƒ
webstudio import --to "<shareLink>"

πŸ› οΈ How to use

1. Use with AI assistants (Antigravity / Cursor / Claude Code)

Just open any Webstudio project in your editor. The AGENTS.md and .agents/skills/webstudio-ai-designer/SKILL.md files automatically explain all commands and generation rules to the AI assistant!

2. MCP command examples:

πŸ“„ Reading pages and elements:

webstudio mcp single-op-call list-pages "{}"
webstudio mcp single-op-call list-instances '{"pagePath":"/services"}'
webstudio mcp single-op-call list-design-tokens "{}"

🎨 Adding sections via JSX (insert-fragment):

Create payload.json:

{
  "parentInstanceId": "<parent-instance-id>",
  "fragment": "<ws.element ws:tag='section' ws:tokens={[token('token-card', css`background: #fff; padding: 32px; border-radius: 16px;`)]} ws:style={css`display: flex; gap: 24px; @media (max-width: 767px) { flex-direction: column; }`}><ws.element ws:tag='h2'>Назва Π‘Π΅ΠΊΡ†Ρ–Ρ—</ws.element></ws.element>"
}

Run:

webstudio mcp single-op-call insert-fragment --input-file payload.json

πŸ“Š Dynamic collections from a JSON resource:

  1. Creating a data variable:

webstudio mcp single-op-call create-variable --input-file pricing_data.json
  1. Connecting a dynamic collection:

webstudio mcp single-op-call insert-collection --input-file collection.json

πŸͺŸ Native Radix UI components (Dialog / Popups):

<radix.Dialog>
  <radix.DialogTrigger>
    <ws.element ws:tag='button'>Π’Ρ–Π΄ΠΊΡ€ΠΈΡ‚ΠΈ Попап</ws.element>
  </radix.DialogTrigger>
  <radix.DialogOverlay ws:style={css`position: fixed; inset: 0; background: rgba(0,0,0,0.5); backdrop-filter: blur(4px); display: flex; align-items: center; justify-content: center;`}>
    <radix.DialogContent ws:style={css`background: #fff; border-radius: 20px; padding: 32px; max-width: 500px;`}>
      <$.Box>
        <radix.DialogTitle>Π—Π°Π³ΠΎΠ»ΠΎΠ²ΠΎΠΊ ΠŸΠΎΠΏΠ°ΠΏΡƒ</radix.DialogTitle>
        <radix.DialogDescription>Опис модального Π²Ρ–ΠΊΠ½Π°</radix.DialogDescription>
      </$.Box>
      <radix.DialogClose>βœ•</radix.DialogClose>
    </radix.DialogContent>
  </radix.DialogOverlay>
</radix.Dialog>

🎬 Native Webstudio Animation Groups (<animation.AnimateChildren>):

{
  "updates": [
    {
      "instanceId": "<animation-instance-id>",
      "name": "action",
      "type": "animationAction",
      "value": {
        "type": "view",
        "animations": [
          {
            "timing": {
              "duration": { "type": "unit", "value": 800, "unit": "ms" },
              "rangeStart": { "type": "unit", "value": 10, "unit": "%" },
              "easing": "ease-out",
              "fill": "backwards"
            },
            "keyframes": [
              { "offset": 0, "styles": { "opacity": "0", "transform": "translateY(40px)" } },
              { "offset": 1, "styles": { "opacity": "1", "transform": "translateY(0px)" } }
            ]
          }
        ]
      }
    }
  ]
}

☁️ Synchronization to Webstudio Cloud

When you finish generating or editing pages, sync the entire project to the cloud with a single command:

webstudio import --to "https://apps.webstudio.is/builder/<projectId>?authToken=<token>"

πŸ“œ License

This project is distributed under the MIT license.

Author: R0STEFAN

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Connects MCP-compatible AI clients and agents to one durable Project Brain plus controlled access to authorized project folders on your own machine. Enables file editing, terminal and Git operations, project intelligence, browser automation, and local MCP server federation, all scoped to explicit workspace grants.
    25 npm
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to research topics, map and analyze codebases across 35+ languages, curate project context, and generate PRDs, user stories, task lists, and fullstack starter projects. It also supports multi-step workflow execution and AI-native task management through a CLI, interactive REPL, or MCP client integration.
    19 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Connects any local code project to any AI client over MCP, letting the assistant read files, edit code, run commands, tests, builds, and dev servers. Automatic checkpoints and one-command undo let users roll back any AI-made change.
    2,078 npm
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Exposes a governed suite of 38 OAuth-gated tools over one MCP endpoint, letting web-based AI chat clients read and edit files, run whitelisted shell commands, search, and use Git, SQLite, browser automation, DevTools, background tasks, ports, clipboard, notifications, and localhost services on the user's own machine. It also allows local IDEs and automation tools to connect directly over localhost for offline, low-latency access.
    MIT