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": {
"command": "npx",
"args": [
"-y",
"@wix/mcp-remote",
"https://mcp.wix.com/sse"
]
}
}
}
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:
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:
-
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 -y and the correct npm registry.
-
Include the full path to Node.
-
Restart the IDE.
-
Run the MCP server directly on the command line:
npx -y @wix/mcp-remote https://mcp.wix.com/sse
-
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\\.mcp-auth (on Windows).
-
If the server still isn’t working, check the MCP debugging guide for more help.
