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.

NameTypeRequiredDescription

reasonstringrequiredOne sentence describing the original user request and why you are browsing this part of the docs menu.

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

NameTypeRequiredDescription

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

reasonstringrequiredOne sentence explaining the original user request and why you are calling this API to complete it.

siteIdstringrequiredThe id of the site selected using site selection tool

sourceDocUrlstringrequiredThe 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

urlstringrequiredThe 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

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

NameTypeRequiredDescription

jobIdstringrequiredThe job ID from site creation - required to authenticate the claim

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

NameTypeRequiredDescription

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

NameTypeRequiredDescription

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

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

reasonstringrequiredOne sentence explaining the original user request and why you are executing code to complete it.

sourceDocUrlsarrayrequiredThe 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

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

NameTypeRequiredDescription

limitnumberoptionalNumber of suggestions to return (default: 10, max: 20)

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

siteIdstringoptionalSite ID to auto-suggest a domain based on the site name. Used when suggesting domains after site creation.

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

NameTypeRequiredDescription

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

NameTypeRequiredDescription

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

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

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

NameTypeRequiredDescription

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

NameTypeRequiredDescription

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

NameTypeRequiredDescription

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

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

NameTypeRequiredDescription

searchTermstringrequiredThe search term to search for in the Build Apps Documentation

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

NameTypeRequiredDescription

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

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

NameTypeRequiredDescription

reasonstringrequiredOne sentence describing the original user request and the task you are trying to accomplish with this search.

searchTermstringrequiredThe search term to search for in the Wix CLI Documentation

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

NameTypeRequiredDescription

searchTermstringrequiredThe search term to search for in the Headless Documentation

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

NameTypeRequiredDescription

reasonstringrequiredOne sentence describing the original user request and the task you are trying to accomplish with this search.

searchTermstringrequiredThe search term to search for in the Wix REST API Documentation

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

NameTypeRequiredDescription

searchTermstringrequiredThe search term to search for in the Wix SDK Documentation

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

NameTypeRequiredDescription

searchTermstringrequiredThe search term to search for in the Wix Design System Documentation

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

NameTypeRequiredDescription

messagestringrequiredThe message to send to Wix

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

NameTypeRequiredDescription

siteIdstringrequiredThe ID of the Wix site to upload to

displayNamestringoptionalOptional display name for the file in Media Manager. If not provided, uses the original filename.

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

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

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

NameTypeRequiredDescription

sitePromptstringrequiredThe prompt to build the site. If not provided, the user will be asked to provide a prompt.

jobIdstringoptionalThe job ID of the site build. If not provided, a new job will be created.

suggestedSiteNamestringoptionalSuggested site name to use for the site based on the site prompt.