About the Wix 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.
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. Watch our video to see a demo of how to set up the MCP:
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:
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.
If working with Cursor, you no longer need to configure the MCP manually. Click below to install the Wix MCP, then click Needs login to complete the authentication process and enable the server.
To add the Wix MCP to other common AI tools, see the instructions below:
- Instructions for Claude Desktop
- Instructions for Claude Web
- Instructions for Windsurf
- Instructions for VS Code
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
Share your feedback
Want to share feedback about your MCP experience? Tell your AI client to submit feedback to Wix. The client will prompt you for your message and send it directly to us. We review all feedback as part of our ongoing effort to improve.
If you’re getting errors when running the MCP server, try the following:
-
Check the IDE logs.
-
Check if the error is related to your package manager. Make sure you have the latest node version as the default on the path.
-
Check that you entered the npx arguments correctly in the configuration. Make sure you included
-yand the correct npm registry. -
Include the full path to Node.
-
Restart the IDE.
-
Run the MCP server directly on the command line:
Copy -
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) orC:\Users\<username>\.mcp-auth(on Windows). -
If the server still isn’t working, check the MCP debugging guide for more help.