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.

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. 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

Wix provides multiple ways to configure the Wix MCP server. In most cases, you need to manually add one of the following JSON objects to your MCP server configuration file:

For tools that support remote MCP:

Copy

The supported values for the type field are "sse" and "http". The type you select depends on your agent. Agents that support remote MCP include Claude, Cursor, Copilot, and Windsurf.

For tools that don't support remote MCP:

Copy

You can also authenticate to the MCP using an API key and your Wix account ID. This is useful for tools like n8n or A2A.

To authenticate with an API key, use one of the following configurations:

For tools that support remote MCP:

Copy

The supported values for the type field are "sse" and "http". The type you select depends on your agent. Use this configuration to set up the MCP in n8n, or in Cursor if you want to authenticate with an API key.

For tools that don't support remote MCP:

Copy

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 the instructions for adding MCP servers to common AI tools:

Cursor

If you're working with Cursor and not using an API key to authenticate, you no longer need to configure the MCP manually. Click below to install the Wix MCP.

Install MCP Server

You can also add the Wix MCP from the Cursor MCP library.

Available tools

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

ToolDescription
SearchWixWDSDocumentationSearch the Wix Design System documentation.
SearchWixRESTDocumentationSearch the Wix REST documentation.
SearchWixSDKDocumentationSearch the Wix SDK documentation.
SearchBuildAppsDocumentationSearch the Wix Build Apps documentation.
SearchWixHeadlessDocumentationSearch the Wix Headless documentation.
WixBusinessFlowsDocumentationInclude complete step-by-step instructions for multi-step sample flows.
ReadFullDocsArticleFetch the full content of an article by article URL.
ReadFullDocsMethodSchemaGet the full request and response schema of an API method.
ListWixSitesQuery the sites for a Wix account.
CallWixSiteAPIPerform an action or query for a given account and selected site.
ManageWixSitePerform a site-level action, such as creating a site.
SupportAndFeedbackPrompt 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:

  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. Locate the MCP server in your IDE settings and log out, then log back in to reconnect to the server.

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

    Copy

  8. 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).

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

Did this help?