Skip to main content
The Wonder MCP server gives your AI coding agent direct read and write access to your Wonder canvas. Connect it to pull designs into code, or push code back into designs. Before you start · Any MCP client · Free plan

What is Wonder MCP?

Wonder’s MCP server plugs into coding agents (Claude, Cursor, and others) so that designs created in Wonder can be read, edited, and updated by your agent, and vice versa.

How it works

Wonder connects to your agent through the Wonder MCP server at https://mcp.wonder.so/mcp. All you need is a Wonder account: your agent can create files for you, so you don’t need one first. On first use you’ll sign in through a standard OAuth flow, and your agent keeps you signed in after that. For clients that can’t sign in through a browser, create a personal access token in Wonder under Settings > Account > Personal access tokens and send it as an Authorization: Bearer header. For Cursor, install Wonder from Cursor’s plugin marketplace. Claude Code and Codex support the Wonder plugin directly.

Works with Wonder closed

Your agent works on your files on Wonder’s servers, so Wonder doesn’t need to be open. It can find, create and edit files, and take screenshots of them, while the app is closed. Open a file in Wonder to watch its changes appear in real time. When a file is open, your agent can also work with the page you’re looking at and what you’ve selected.

Wonder MCP or Wonder Chat?

In the Wonder desktop app you can also chat with an agent right beside your canvas and your code. These chats run Claude Code or Codex on your own accounts, and Wonder connects them to Wonder MCP for you, so there’s nothing to install.
  • Use Wonder MCP to work from the agent or editor you already use, such as Cursor, Claude Code in your terminal, Codex or Claude, including in the browser or with Wonder closed.
  • Use a chat in the desktop app to work with your agent, your designs and your code in one window.

Plans and limits

The Wonder MCP server works on every plan. On the Free plan:
  • The layers your agents create count toward 3,000 AI-generated layers a week, across all your Free workspaces. Creating, duplicating and generating layers counts; reading, renaming and deleting doesn’t. When your agents reach the limit, they tell you when it resets.
  • Your agents can make 10 new prototypes a week, in the same week and across the same Free workspaces. Changing a prototype doesn’t count. At the limit, your agent passes on “Your agents have made 10 prototypes this week on the Free plan.” and tells you when it resets.
  • Generating images and vectors needs Pro.
  • In a workspace on the Free plan, only its owner can edit. Other members can still read its files.
Pro has unlimited AI-generated layers and prototypes, and includes image and vector generation, with a monthly allowance per person. Every plan also limits how fast and how long tool calls run. See Too many tool calls.

Install

Pick your agent below. We currently support Cursor, Claude Code, Claude Desktop, Claude custom connectors, Codex, Antigravity, Lovable, and custom MCP clients.

Cursor

Open Customize
  1. Click Browse Marketplace.
  2. Search for Wonder and open the result.
  3. Click Add.
  4. Click Manage. Wonder should now appear under MCP.
  5. Click Authenticate and complete the browser sign-in.

Claude Code

Plugin (recommended) Open your terminal and run claude to start Claude Code. Add the marketplace:
Install the plugin:
Wonder plugin found in Claude Code

Claude Code showing the Wonder plugin available to install

Reload to activate it:
To check if it worked, run /plugin and confirm that Wonder appears under installed.
Wonder plugin installed in Claude Code

Claude Code showing the Wonder plugin under Installed

Back in Claude Code, type a prompt like:
On first use, Claude will say the Wonder MCP needs authentication and print a URL. Open that link in your browser to authorize, then come back to Claude Code and re-send the same prompt. Open the file in Wonder to watch it draw in real time.
Manual setup
  1. Open the terminal on your computer.
  2. Run the command below (not inside Claude) to register the Wonder MCP server:
Claude terminal command

Run the command in your terminal

  1. Run claude mcp list to confirm the Wonder server appears.
Claude mcp list output

Confirm the Wonder server appears

  1. Open a Claude Code session and run /mcp. You should see Wonder in the list of MCPs. If you don’t, restart your Claude session. Wonder will prompt you to sign in to your account in the browser. Once done, your agent is connected. Tokens refresh automatically, so you should only need to do this once.
Wonder shown in Claude /mcp list

Wonder appears in the /mcp list

New to the terminal?
If you have trouble setting up Claude Code, watch this tutorial or ask any AI agent to walk you through it.

Claude Desktop

Plugin (recommended)
  1. Open your Claude Desktop app and navigate to the Code tab in the top-left corner.
  2. Click on Customize.
  3. Click the plus icon under Personal Plugins > Create Plugin > Add Marketplace.
  4. Enter the Wonder plugin URL in the field: aquila-lab/wonder-plugins.
  5. Click Sync and add the Wonder plugin that appears to Claude.
Add Marketplace dialog in Claude Desktop

Add Marketplace in Claude Desktop

Installed Wonder plugin in Claude Desktop

Wonder plugin installed in Claude Desktop

You should now see Wonder in your MCP list when you start a claude session in your terminal and run /mcp.
Manual setup Claude Desktop requires Node.js to run MCP servers. Verify by running node --version in your terminal. Open Claude Desktop Settings > Developer > Edit Config. This opens your claude_desktop_config.json file. Your file probably looks something like this:
Add the Wonder MCP section so it looks like this:
Save the file. Make sure there’s a comma after the closing } of mcpServers. Fully quit and restart Claude Desktop. A browser window will open asking “MCP CLI Proxy would like access to your account.” Click Allow access. Once the browser confirms “Authorization successful!”, close it and return to Claude. Check the chat input area for the MCP indicator to verify Wonder is connected.

Claude (custom connector)

If you use the Claude desktop app or claude.ai in the browser and don’t want to touch the terminal or config files, add Wonder as a custom connector. This is the simplest way to connect Claude to your canvas. There are two parts. An admin adds Wonder as a connector once, then each person connects their own Wonder account. On a personal Pro or Max plan you’re the admin, so do both.
Add Wonder (admins)
  1. Open Claude (the desktop app or claude.ai).
  2. Go to Settings > Connectors.
  3. Click Add, choose Custom, then Web. In some versions this reads Add custom connector.
The Add menu in Claude Connectors settings showing Add custom connector

Add a custom connector from the Connectors settings

  1. Enter the following details:
    • Name: Wonder
    • Remote MCP server URL: https://mcp.wonder.so/mcp
  2. Claude auto-detects Wonder’s authentication settings. Keep the detected defaults:
    • Authentication: Always required
    • OAuth client: Use Anthropic’s hosted client metadata (Recommended)
Claude custom connector authentication settings with Always required and Use Anthropic's hosted client metadata selected

Keep the detected authentication defaults

  1. Scroll down and click Add to make Wonder available.
Adding the connector doesn’t give Wonder access to every member or file. Each person connects their own Wonder account and only sees files their existing Wonder permissions allow.
Who can do this
On Team and Enterprise, only a Claude organization Owner or Primary Owner can add a custom connector. If you don’t see the option, you likely aren’t an Owner or your organization has restricted custom connectors: send your admin this guide.

Connect your account (everyone)
  1. In Claude, open Customize > Connectors.
  2. Find Wonder in the list (it may have a Custom label) and click Connect.
  3. Sign in to Wonder and approve the connection.
  4. Open the Wonder connector settings. Under Tool permissions, set both groups to Always allow:
    • Read-only tools: Always allow
    • Write/delete tools: Always allow
Wonder connector tool permissions with Read-only tools and Write/delete tools set to Always allow

Set both tool groups to Always allow

Why Always allow
This lets Claude work without asking before every Wonder tool call. Claude can still only reach files your Wonder account permits.
  1. In a Claude conversation, open + > Connectors and enable Wonder if it isn’t already.

Codex

Plugin (recommended)
  1. With the Codex CLI installed, run these commands in your terminal:
Wonder uses a custom marketplace hosted on GitHub, so an official directory listing isn’t required.
  1. Restart Codex and start a new chat. Type @wonder and select the installed Wonder plugin.
Selecting the Wonder plugin in a new Codex chat

Select the installed Wonder plugin

Choose the installed plugin
The Wonder · Computer use entry starts desktop automation. Select the installed Wonder plugin to use its MCP integration.
  1. Send this read-only connection check in Codex:
  1. Complete Wonder sign-in when Codex prompts you, then retry the connection check. Confirm Codex calls a Wonder MCP tool and returns your files before asking it to edit a design.
The plugin’s bundled skill guides Codex to use Wonder MCP for canvas operations and explain connection problems. It asks Codex to use computer use only when you explicitly request it. This guidance applies when the skill loads; Codex controls the app picker and global tool routing.
Manual setup Run the command below in your terminal to register the Wonder MCP server:
You can also configure it manually via config.toml. Run codex mcp list to confirm the Wonder server appears. Restart Codex and start a new chat, then run the read-only connection check above and complete Wonder sign-in if prompted. Manual setup connects the MCP server without the plugin’s bundled skill, so ask explicitly to use Wonder MCP.

Antigravity

In Antigravity, click the ⋯ menu in the Agent panel > MCP Servers, then select Manage MCP Servers > View raw config. This opens your mcp_config.json file. The file is located at:
  • macOS / Linux: ~/.gemini/antigravity/mcp_config.json
  • Windows: C:\Users\<USERNAME>\.gemini\antigravity\mcp_config.json
Add the following configuration. Note that Antigravity uses serverUrl instead of url for remote MCP servers.
Close and reopen Antigravity. Go to MCP Servers and confirm Wonder appears with its tools listed.

Lovable

Custom MCP servers work on every Lovable plan.
  1. In Lovable, open Connectors, click Add custom in the top right, and choose MCP server. If MCP server is greyed out, an admin has turned off custom MCP servers for your workspace.
  2. Enter Wonder as the Server name.
  3. If a Connection menu appears, keep Direct connection.
  4. Paste this URL as the Server URL:
Add custom MCP to Lovable

Add Wonder to Lovable with a custom MCP server

  1. Keep OAuth (default) selected and click Add & authorize.
  2. Sign in to Wonder and approve the connection.
Wonder appears in your list of chat connectors. You can now reference your Wonder designs directly in prompts. Each person in a Lovable workspace connects Wonder with their own account.

Other MCP clients

If your client isn’t listed above, you can set up Wonder manually. The server URL is:
Most MCP clients accept a JSON config like this:
If your client doesn’t support remote URLs natively, use the mcp-remote bridge (requires Node.js):

Try it out

Once Wonder is connected, open a chat in your agent of choice and try one of these prompts to confirm everything is working. If you are in an existing codebase:
If you’re starting fresh:
To test the round-trip:
Your agent will use the Wonder MCP tools to read and write directly to your canvas. Open Wonder to see the result.

If something goes wrong

If Wonder doesn’t show up in your agent, can’t connect, or stops at a limit, see Wonder MCP troubleshooting. It also answers common questions, such as which other MCP clients work with Wonder.