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
- Claude Code
- Codex
- Cursor
- VS Code (Copilot)
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
Add the Wonder marketplace:
codex plugin marketplace add nethype-co/wonder-ai-toolkit
Then install the plugin:
- CLI: start
codex, type/plugins, open the Nethype (Wonder theme) marketplace and install Wonder Theme. Start a new session. - Codex app: open the Plugins directory, choose Nethype (Wonder theme) and install Wonder Theme.
- Open Customize in the sidebar (or Settings → Plugins).
- Add a plugin from a GitHub repository and paste:
https://github.com/nethype-co/wonder-ai-toolkit
- Choose whether to install it for this project or for all projects.
On Cursor Enterprise, importing plugins may be turned off by your admin. In that case, add the MCP server on its own instead.
- Turn on agent plugins: open Settings and enable
chat.plugins.enabled. - Open the Command Palette (Cmd/Ctrl+Shift+P) and run Chat: Install Plugin from Source.
- Paste the repository URL:
https://github.com/nethype-co/wonder-ai-toolkit
Plugins installed from a Git repository can be uninstalled but not disabled.
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.
- Claude (web & desktop)
- ChatGPT
- Claude Code (server only)
- Codex (server only)
- Cursor (server only)
- VS Code (server only)
- Gemini CLI
- Windsurf / Devin Desktop
- Other
Pro and Max plans
- Open Customize → Connectors.
- Click + Add → Add custom connector.
- Name:
Wonder Theme, URL:https://mcp.wonder-theme.com/mcp. - Under Authentication, choose No sign in, then click Add.
- 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.
- Go to Plugins (chatgpt.com/plugins) and click + → Add custom MCP server.
- Name:
Wonder Theme. Connection URL:https://mcp.wonder-theme.com/mcp. - Authentication: No authentication. Confirm the notice and click Create as a plugin.
- Install the plugin. In a new chat, type
@and choose Wonder Theme.
Custom MCP servers are available on the web (not in the mobile apps), on Pro, Business and Enterprise/Edu plans. In a Business or Enterprise workspace, an admin may need to add the server for you. All Wonder tools are read-only, so ChatGPT doesn't ask for confirmation when it uses them.
claude mcp add --transport http --scope user wonder https://mcp.wonder-theme.com/mcp
--scope user makes it available in all your projects. To share it with your team through the repository instead, use --scope project (it's saved to .mcp.json):
{
"mcpServers": {
"wonder": {
"type": "http",
"url": "https://mcp.wonder-theme.com/mcp"
}
}
}
codex mcp add wonder --url https://mcp.wonder-theme.com/mcp
Or add it to ~/.codex/config.toml (shared by the Codex CLI, IDE extension and app):
[mcp_servers.wonder]
url = "https://mcp.wonder-theme.com/mcp"
Add to Cursor (opens Cursor), or add it to ~/.cursor/mcp.json for all projects (.cursor/mcp.json for one project):
{
"mcpServers": {
"wonder": {
"url": "https://mcp.wonder-theme.com/mcp"
}
}
}
Command Palette → MCP: Add Server → HTTP → paste https://mcp.wonder-theme.com/mcp → name it wonder.
Or add it to ~/.copilot/mcp-config.json:
{
"mcpServers": {
"wonder": {
"type": "http",
"url": "https://mcp.wonder-theme.com/mcp",
"tools": ["*"]
}
}
}
gemini mcp add --transport http --scope user wonder https://mcp.wonder-theme.com/mcp
Or add it to ~/.gemini/settings.json. Use httpUrl (not url, which means the older SSE transport):
{
"mcpServers": {
"wonder": {
"httpUrl": "https://mcp.wonder-theme.com/mcp"
}
}
}
Antigravity (CLI and IDE) uses ~/.gemini/config/mcp_config.json with serverUrl instead:
{
"mcpServers": {
"wonder": {
"serverUrl": "https://mcp.wonder-theme.com/mcp"
}
}
}
Open the MCP panel (Customize → MCPs) and open the raw config file (mcp_config.json). Add:
{
"mcpServers": {
"wonder": {
"serverUrl": "https://mcp.wonder-theme.com/mcp"
}
}
}
Save, then refresh the MCP panel.
Zed: Settings → AI → MCP Servers → Add Server → Add Remote Server, or in settings.json:
{
"context_servers": {
"wonder": {
"url": "https://mcp.wonder-theme.com/mcp"
}
}
}
JetBrains AI Assistant: Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add → HTTP, then paste:
{
"mcpServers": {
"wonder": {
"url": "https://mcp.wonder-theme.com/mcp"
}
}
}
Any other client: add a remote MCP server with the URL https://mcp.wonder-theme.com/mcp, transport Streamable HTTP (sometimes just "HTTP"), and no authentication.
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. Openinghttps://mcp.wonder-theme.com/mcpin 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
/mcpto see the connection status. A server in.mcp.jsonstays 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.