How to add Wix MCP to Windsurf

Wix's official hosted MCP: search Wix docs, generate platform code, and call real site APIs from your AI client. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 15★ · http · oauth · official

Windsurf config for Wix MCP

Add remote URL https://mcp.wix.com/mcp to your MCP client (type: http); fallback: npx -y @wix/mcp-remote https://mcp.wix.com/sse

{
  "mcpServers": {
    "wix-mcp": {
      "serverUrl": "https://mcp.wix.com/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Wix MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Wix MCP's tools become available to Cascade.

Before you start

A Wix account (OAuth login in the browser)
An MCP client with remote HTTP support, or Node.js 19.9.0+ for the npx @wix/mcp-remote bridge

What Wix MCP can do in Windsurf

SearchWixWDSDocumentation

Search the Wix Design System documentation.

SearchWixRESTDocumentation

Search the Wix REST API documentation.

SearchWixSDKDocumentation

Search the Wix SDK documentation.

SearchBuildAppsDocumentation

Search the Wix Build Apps documentation.

SearchWixHeadlessDocumentation

Search the Wix Headless documentation.

WixBusinessFlowsDocumentation

Return complete step-by-step instructions for multi-step sample flows.

ReadFullDocsArticle

Fetch the full content of a docs article by URL.

ReadFullDocsMethodSchema

Get the full request and response schema of an API method.

Security

OAuth links the server to your Wix account: CallWixSiteAPI and ManageWixSite perform real actions on your sites — including creating sites — not just doc lookups. Cached credentials live in ~/.mcp-auth when using the mcp-remote proxy; delete that folder to reset auth, especially after switching Wix accounts.

Wix MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Wix MCP config there under the "mcpServers" key and restart the client.

Is Wix MCP safe to use with Windsurf?

Is the Wix MCP free to use?

Yes — the hosted server costs nothing beyond your existing Wix account and plans. Documentation search works as soon as OAuth completes; site API calls are limited by what your account and sites allow.

Can it modify my live Wix site?

Yes. CallWixSiteAPI performs real actions and queries on a selected site, and ManageWixSite can do site-level operations like creating a site. Review agent plans before letting them run write operations against production.

Do I need to install anything locally?

Usually no — clients with native remote MCP support only need the https://mcp.wix.com/mcp URL. Clients that lack it can bridge with npx -y @wix/mcp-remote https://mcp.wix.com/sse, which requires Node.js 19.9.0 or higher.

View repo Full Wix MCP page