mcp

Wix now provides a Model Context Protocol (MCP) server that allows you to work with Wix tools and services in your chosen AI client. By configuring the Wix MCP server, you enable your client to search the Wix documentation, write code for the Wix platform, and make API calls on Wix sites. This saves you the time and effort of finding and applying the information in the documentation yourself.

For examples on how to use the Wix MCP server, see our sample prompts.

Configure the Wix MCP

This section shows you the basic configuration you need to add to your AI tool to use the Wix MCP server.

Before you begin

• Make sure you have Node.js version 19.9.0 or higher installed.

Required configuration

To add the Wix MCP server to your agent, include the following JSON object in your MCP server configuration:

{
  "mcpServers": {
    "wix-mcp-remote": {
      "type": "http",
      "url": "https://mcp.wix.com/mcp"
    }
  }
}

Depending on your client, you may be able to configure the MCP server through the client settings, or even ask the client itself to add the configuration. See instructions on adding MCP servers for common AI tools:

• Instructions for Claude Desktop
• Instructions for Claude Web
• Instructions for Cursor
• Instructions for Windsurf
• Instructions for VS Code
• Instructions for Gemini CLI

Available tools

The Wix MCP server provides the following tools in the table below. All of these tools are enabled by default.

Tool	Description
SearchWixWDSDocumentation	Search the Wix Design System documentation.
SearchWixRESTDocumentation	Search the Wix REST documentation.
SearchWixSDKDocumentation	Search the Wix SDK documentation.
SearchBuildAppsDocumentation	Search the Wix Build Apps documentation.
SearchWixHeadlessDocumentation	Search the Wix Headless documentation.
WixBusinessFlowsDocumentation	Include complete step-by-step instructions for multi-step sample flows.
ReadFullDocsArticle	Fetch the full content of an article by article URL.
ReadFullDocsMethodSchema	Get the full request and response schema of an API method.
ListWixSites	Query the sites for a Wix account.
CallWixSiteAPI	Perform an action or query for a given account and selected site.
ManageWixSite	Perform a site-level action, such as creating a site.
SupportAndFeedback	Prompt the user for feedback and send it to Wix.

Troubleshooting

If you’re getting errors when running the MCP server, try the following:

1. Check the IDE logs.

2. Check if the error is related to your package manager. Make sure you have the latest node version as the default on the path.

3. Check that you entered the npx arguments correctly in the configuration. Make sure you included -y and the correct npm registry.

4. Include the full path to Node.

5. Restart the IDE.

6. Run the MCP server directly on the command line:

   npx -y @wix/mcp-remote https://mcp.wix.com/sse
   

7. The connection to the server may be lost after a long period of inactivity, or if you switch the Wix account you’re authenticating with. In that case, it may help to delete ~/.mcp-auth (on Mac) or C:\Users\<username>\.mcp-auth (on Windows).

8. If the server still isn’t working, check the MCP debugging guide for more help.