Skip to main content

Install the Wonder AI Toolkit & MCP Server

Connect your AI assistant to Wonder in a couple of minutes. Everything is free, and you don't need an account or an API key.

Server address (Streamable HTTP, no authentication):

https://mcp.wonder-theme.com/mcp
  • Using a coding agent (Claude Code, Codex, Cursor, VS Code)? Install the Wonder AI Toolkit plugin. It adds the server plus five ready-made workflows, including the theme update workflow.
  • Using an AI chat (Claude, ChatGPT) or another tool? Add the MCP server on its own.

Not sure what the difference is? See the overview.


Coding agents: install the Wonder AI Toolkit​

In your terminal:

claude plugin marketplace add nethype-co/wonder-ai-toolkit
claude plugin install wonder-theme@nethype

Or inside a Claude Code session:

/plugin marketplace add nethype-co/wonder-ai-toolkit
/plugin install wonder-theme@nethype

Restart Claude Code, then run /mcp: wonder should be listed as connected.

Plugins from this marketplace don't update automatically. To get the latest version:

claude plugin update wonder-theme@nethype
AGENTS.md for other coding agents

If your agent reads AGENTS.md files but doesn't support plugins, add the MCP server and copy AGENTS.md into your working folder. Don't push it to the theme: Shopify rejects unknown files at the theme root.


AI chats and other tools: add the MCP server​

If you use both the Wonder AI Toolkit plugin and the Wonder Theme connector, you'll see one set of Wonder tools, not two. That's expected.

Pro and Max plans

  1. Open Customize → Connectors.
  2. Click + Add → Add custom connector.
  3. Name: Wonder Theme, URL: https://mcp.wonder-theme.com/mcp.
  4. Under Authentication, choose No sign in, then click Add.
  5. In a chat, open the + menu → Connectors and make sure Wonder Theme is on.

Team and Enterprise plans: an owner adds the connector once under Organization settings → Connectors → Add → Custom → Web. Members then click Connect in Customize → Connectors.

On the Free plan you can add one custom connector. The same connectors work in Claude Desktop.


Check that it works​

Ask your assistant:

Which Wonder tools do you have? What is the latest Wonder version?

It should list nine tools (search_docs, get_known_issues, get_changelog, list_sections, get_section_schema, get_component_api, get_section_blueprint, validate_section, plan_update) and name the current Wonder release. Then try one of the prompts that work well.

Troubleshooting​

The assistant doesn't see any Wonder tools

  • Restart the app or start a new session after installing. Most clients load MCP servers at startup.
  • Check the URL ends in /mcp. Opening https://mcp.wonder-theme.com/mcp in a browser only shows a short info page: that's expected, because the server talks to AI clients.
  • In Claude and ChatGPT, make sure the connector or plugin is turned on for the current chat.
  • In Claude Code, run /mcp to see the connection status. A server in .mcp.json stays at Pending approval until you trust the folder.

The client asks you to sign in Choose No sign in / No authentication when adding the server. The Wonder server doesn't use accounts.

Your company blocks custom servers Team and Enterprise plans often restrict custom MCP servers. Ask your admin to add https://mcp.wonder-theme.com/mcp, or to allow it.

"Too many requests" The server allows a generous number of requests per minute. Wait a minute and try again.

Still stuck? Contact Wonder support and tell us which assistant you use.


Privacy​

The Wonder tools never access your Shopify store. Code you ask the server to check is not stored. See Privacy & data for details.