Wix MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'wixmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Wix MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'wixmcp_createwixbusinessguide',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "wixmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Wix MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="wixmcp_createwixbusinessguide",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Wixsitebuilder records — Create or build a new Wix site using AI, returning a job ID to track the creation progress
• Wixreadme records — Read the Wix MCP README for guidance on how to use the available Wix tools effectively
• Uploadimagetowixsite records — Upload one or more images to a Wix site’s Media Manager and return the file URL and media ID
• Supportandfeedback records — Submit feedback or a support request about the Wix MCP tools to the Wix team
• Searchwixwdsdocumentation records — Search the Wix Design System documentation for UI components and design guidelines
• Searchwixsdkdocumentation records — Search the Wix JavaScript SDK documentation for client-side and server-side SDK usage

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

wixmcp_browsewixrestdocsmenu # Browse the Wix REST API documentation menu hierarchy to explore available API categories and endpoints. 2 params ▾

Browse the Wix REST API documentation menu hierarchy to explore available API categories and endpoints.

Name Type Required Description

reason string required One sentence describing the original user request and why you are browsing this part of the docs menu.

menuUrl string optional URL of the menu to browse. Empty/omitted returns the root menu. Copy the URL from links in previous responses of this tool. Example: "https://dev.wix.com/docs/api-reference/ecommerce" or "https://dev.wix.com/docs/api-reference/ecommerce/catalog"

wixmcp_callwixsiteapi # Call any Wix REST API endpoint on a specific site to create, read, update, or delete site data. 6 params ▾

Call any Wix REST API endpoint on a specific site to create, read, update, or delete site data.

Name Type Required Description

method string required The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)

reason string required One sentence explaining the original user request and why you are calling this API to complete it.

siteId string required The id of the site selected using site selection tool

sourceDocUrl string required The URL of the documentation or recipe where you found this API endpoint. MAKE SURE THE ENDPOINT URL IS REALLY THERE AND YOUR ARE NOT GUESSING IT !!! Must be a valid URL like: - https://dev.wix.com/docs/api-reference/... (REST API reference docs) Use "user-provided" if the user gave you the endpoint directly. Use "other" ONLY IF YOU HAVE A VERY GOOD REASON TO DO SO

url string required The url of the api to call - ALWAYS get the API url from the Wix REST docs or from the conversation context, the URL MUST BE ABSOLUTE URL NEVER guess the API url, ALWAYS get it from the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "BrowseWixRESTDocsMenu" tool or from the "ReadFullDocsArticle" tool Allowed API urls are: wix.com, dev.wix.com, manage.wix.com, editor.wix.com, wixapis.com Docs urls like https://dev.wix.com/docs/... are not API urls, if you want to read the docs, use the "ReadFullDocsArticle" tool

body string optional The request body as a JSON object or array with all the required fields and values, including nested objects. Pass the actual value (object or array), NOT a JSON string. YOU MUST NEVER MAKE UP A BODY - the body should be based on the conversation context, i.e from the user prompt OR got into the conversation context by the "ReadFullDocsArticle" tool OR by the "SearchWixAPISpec" tool OR by the "ReadFullDocsMethodSchema" tool - i.e based on the API docs, a relevant recipe you read (preferably), a code example you found in the docs, a schema you read etc.. YOU MUST NEVER ASSUME YOU KNOW WHAT THE BODY SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT. Prefer reading relevant recipes if you have them in context for understand the body schema for API calls.

wixmcp_claimanonymoussite # Transfer an anonymously created Wix site to the authenticated user's account using a job ID. 2 params ▾

Transfer an anonymously created Wix site to the authenticated user's account using a job ID.

Name Type Required Description

jobId string required The job ID from site creation - required to authenticate the claim

siteId string required The metasite ID of the anonymous site to claim

wixmcp_createwixbusinessguide # Generate a guided plan for creating a new Wix site from a template, with the Wix Editor, or as a headless site. 1 param ▾

Generate a guided plan for creating a new Wix site from a template, with the Wix Editor, or as a headless site.

Name Type Required Description

userPrompt string optional The user prompt that triggered this tool

wixmcp_executewixapi # Execute JavaScript code against the Wix REST API in a sandboxed environment to query or mutate site data. 5 params ▾

Execute JavaScript code against the Wix REST API in a sandboxed environment to query or mutate site data.

Name Type Required Description

code string required JavaScript async function expression to execute against the Wix REST API. The value must be the function itself, for example `async function() { ... }` or `async () => { ... }`, not a script body and not an invoked function. Return the final answer from inside the function. Do not write top-level `const`, top-level `await`, or top-level `return` outside the function body. Use `wix.request({ method, url, body })` for Wix API calls. Scope defaults to `site` when the ExecuteWixAPI `siteId` parameter is passed, otherwise `account`; set `scope` explicitly when needed. Full Wix API URLs and paths starting with `/` are supported. Do not pass `siteId` inside `wix.request()`; one ExecuteWixAPI call can target only the tool-level `siteId`.

hasMutations boolean required Whether this code creates, updates, deletes, publishes, installs, imports, uploads, or otherwise mutates Wix data or site/account state. Set this to true for create/update/delete/bulk create/import/upload calls even if the reason is inspection, verification, or response-shape discovery. Read-only GET/query/list/search calls can use false.

reason string required One sentence explaining the original user request and why you are executing code to complete it.

sourceDocUrls array required The URLs of the documentation, recipes, API articles, or schema sources where you confirmed the Wix REST endpoints, HTTP methods, request body shapes, auth contexts, and required fields used by this code. Include every docs/schema source needed for the endpoints and request shapes used in the code. MAKE SURE THE ENDPOINT URLS AND REQUEST SHAPES ARE REALLY THERE AND YOU ARE NOT GUESSING THEM !!! Each value must be a valid URL like: - https://dev.wix.com/docs/api-reference/... (REST API reference docs) Use ["user-provided"] if the user gave you all endpoint and request details directly. Use ["other"] ONLY IF YOU HAVE A VERY GOOD REASON TO DO SO

siteId string optional Wix site ID for site-level API calls. Required when using `wix.request({ scope: "site", ... })`. One ExecuteWixAPI call can target only this siteId; per-request siteId inside `wix.request()` is not supported. Find site IDs using ListWixSites or an account-level `wix.request()` call to query the Sites API.

wixmcp_getsuggesteddomains # Suggest available domain names based on a search query or an existing Wix site's name. 4 params ▾

Suggest available domain names based on a search query or an existing Wix site's name.

Name Type Required Description

limit number optional Number of suggestions to return (default: 10, max: 20)

query string optional Free-text keywords, business idea, or brand concept to base suggestions on. Use the user's own words.

siteId string optional Site ID to auto-suggest a domain based on the site name. Used when suggesting domains after site creation.

tlds array optional Filter by specific TLDs (e.g. ["com", "net"]). Do not include the dot.

wixmcp_listwixsites # List all Wix sites belonging to the authenticated account, with optional name filtering. 1 param ▾

List all Wix sites belonging to the authenticated account, with optional name filtering.

Name Type Required Description

nameSearch string optional optional filer by name, if not provided all sites will be returned

wixmcp_managewixsite # Call account-level Wix APIs to create, update, or publish a site. 3 params ▾

Call account-level Wix APIs to create, update, or publish a site.

Name Type Required Description

method string required The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)

url string required The url of the api to call - ALWAYS get the information from the Wix REST docs DONT GUESS IT, the URL MUST BE ABSOLUTE URL

body string optional The request body as a JSON object or array with all the required fields and values, including nested objects. Pass the actual value (object or array), NOT a JSON string. YOU MUST NEVER MAKE UP A BODY - this should be based on the conversation context, i.e from the user prompt or from the "WixREADME" tool or from the "SearchWixRESTDocumentation" tool or from the "BrowseWixRESTDocsMenu" tool or from the "ReadFullDocsArticle" tool or from the "SearchWixAPISpec" tool or from the "ReadFullDocsMethodSchema" tool - i.e based on the API docs. YOU MUST NEVER ASSUME YOU KNOW WHAT THE SCHEMA IS WITHOUT CONCRETE EXAMPLES OR SCHEMA DEFINITIONS FROM THE CONVERSATION CONTEXT.

wixmcp_pullsitecreationjob # Poll the status of a site creation or editing job until it completes. 1 param ▾

Poll the status of a site creation or editing job until it completes.

Name Type Required Description

jobId string required The job ID to pull

wixmcp_readfulldocsarticle # Fetch the full content and code examples for a specific Wix documentation article. 1 param ▾

Fetch the full content and code examples for a specific Wix documentation article.

Name Type Required Description

articleUrl string required The URL of the docs article or method article to fetch. Should be something like https://dev.wix.com/docs/.../... For REST docs, use the URL as-is. For SDK docs, the URL SHOULD include the query param ?apiView=SDK (e.g. https://dev.wix.com/docs/...?apiView=SDK).

wixmcp_readfulldocsmethodschema # Fetch the complete request and response schema for a specific Wix API method. 2 params ▾

Fetch the complete request and response schema for a specific Wix API method.

Name Type Required Description

articleUrl string required The URL of the documentation to fetch. Should be something like https://dev.wix.com/docs/.../... For REST docs, use the URL as-is. For SDK docs, the URL SHOULD include the query param ?apiView=SDK (e.g. https://dev.wix.com/docs/...?apiView=SDK).

reason string required One sentence describing the original user request, the task you are trying to accomplish, and why you need the full schema (e.g., no relevant code example found in docs or recipes).

wixmcp_searchbuildappsdocumentation # Search the Wix documentation for building and publishing Wix apps. 2 params ▾

Search the Wix documentation for building and publishing Wix apps.

Name Type Required Description

searchTerm string required The search term to search for in the Build Apps Documentation

maxResults number optional The maximum number of results to return, default is 10, max is 15

wixmcp_searchwixapispec # Search and inspect the Wix REST API spec by running JavaScript in a sandboxed read-only environment. 2 params ▾

Search and inspect the Wix REST API spec by running JavaScript in a sandboxed read-only environment.

Name Type Required Description

code string required JavaScript async function() expression to search the Wix API index. Has access to `lightIndex` (array of resources) and `getResourceSchema(resourceId)` (returns full schema).

reason string required One sentence describing the original user request and why you are searching or inspecting the Wix API spec.

wixmcp_searchwixclidocumentation # Search the Wix CLI documentation for website development commands and workflows. 3 params ▾

Search the Wix CLI documentation for website development commands and workflows.

Name Type Required Description

reason string required One sentence describing the original user request and the task you are trying to accomplish with this search.

searchTerm string required The search term to search for in the Wix CLI Documentation

maxResults number optional The maximum number of results to return, default is 10, max is 15

wixmcp_searchwixheadlessdocumentation # Search the Wix headless documentation for building custom frontends with Wix backend services. 2 params ▾

Search the Wix headless documentation for building custom frontends with Wix backend services.

Name Type Required Description

searchTerm string required The search term to search for in the Headless Documentation

maxResults number optional The maximum number of results to return, default is 10, max is 15

wixmcp_searchwixrestdocumentation # Search the official Wix REST API documentation to find endpoints, schemas, and usage examples. 3 params ▾

Search the official Wix REST API documentation to find endpoints, schemas, and usage examples.

Name Type Required Description

reason string required One sentence describing the original user request and the task you are trying to accomplish with this search.

searchTerm string required The search term to search for in the Wix REST API Documentation

maxResults number optional The maximum number of results to return, default is 10, max is 15

wixmcp_searchwixsdkdocumentation # Search the Wix JavaScript SDK documentation for client-side and server-side SDK usage. 2 params ▾

Search the Wix JavaScript SDK documentation for client-side and server-side SDK usage.

Name Type Required Description

searchTerm string required The search term to search for in the Wix SDK Documentation

maxResults number optional The maximum number of results to return, default is 10, max is 15

wixmcp_searchwixwdsdocumentation # Search the Wix Design System documentation for UI components and design guidelines. 2 params ▾

Search the Wix Design System documentation for UI components and design guidelines.

Name Type Required Description

searchTerm string required The search term to search for in the Wix Design System Documentation

maxResults number optional The maximum number of results to return, default is 10, max is 15

wixmcp_supportandfeedback # Submit feedback or a support request about the Wix MCP tools to the Wix team. 2 params ▾

Submit feedback or a support request about the Wix MCP tools to the Wix team.

Name Type Required Description

message string required The message to send to Wix

requestId string optional request id if returned from the server in a failed API call to Wix

wixmcp_uploadimagetowixsite # Upload one or more images to a Wix site's Media Manager and return the file URL and media ID. 5 params ▾

Upload one or more images to a Wix site's Media Manager and return the file URL and media ID.

Name Type Required Description

siteId string required The ID of the Wix site to upload to

displayName string optional Optional display name for the file in Media Manager. If not provided, uses the original filename.

image array optional Array of images to upload. Use this when the user provides image file attachments OR image URLs. ALWAYS pass ALL images together in a single call — NEVER call this tool once per image. ChatGPT/OpenAI clients: user-attached files are automatically resolved to download_urls, just include them here. Each item must have download_url and optionally file_id. Do NOT use together with imageBase64.

imageBase64 string optional Base64-encoded image data. Use when the client can read a file and encode it as base64. May include a data URL prefix (e.g. "data:image/jpeg;base64,...") or be raw base64. Do NOT use together with image.

mimeType string optional MIME type of the image (e.g. "image/jpeg", "image/png", "image/webp"). Required when imageBase64 does not include a data URL prefix.

wixmcp_wixreadme # Read the Wix MCP README for guidance on how to use the available Wix tools effectively. 0 params ▾

Read the Wix MCP README for guidance on how to use the available Wix tools effectively.

wixmcp_wixsitebuilder # Create or build a new Wix site using AI, returning a job ID to track the creation progress. 3 params ▾

Create or build a new Wix site using AI, returning a job ID to track the creation progress.

Name Type Required Description

sitePrompt string required The prompt to build the site. If not provided, the user will be asked to provide a prompt.

jobId string optional The job ID of the site build. If not provided, a new job will be created.

suggestedSiteName string optional Suggested site name to use for the site based on the site prompt.