@wix/mcp 1.0.28 → 1.0.30

package/README.md

@@ -70,6 +70,7 @@ Set logging output:
 - `WIX_HEADLESS`: Wix Headless Documentation (`SearchWixHeadlessDocumentation`)
 - `VELO`: Velo Documentation (`SearchWixVeloDocumentation`)
 - `BUSINESS_SOLUTIONS`: Business solutions recipes (`WixBusinessFlowsDocumentation`)
+- `CLI`: Wix CLI Documentation (`SearchWixCLIDocumentation`)
 
 **Experimental Tools:**
 

package/build/bin-standalone.js

@@ -10329,6 +10329,8 @@ var runSemanticSearch = async (toolName, toolParams, maxResults = 20, rerank = f
     kbNames.push("HEADLESS_KB_ID");
   } else if (toolName === "VELO") {
     kbNames.push("VELO_DOCS_KB_ID", "VELO_METHODS_KB_ID");
+  } else if (toolName === "CLI") {
+    kbNames.push("CLI_KB_ID");
   }
   logger.log(
     `[SemanticSearch] Tool: ${toolName}, KBs: [${kbNames.join(", ")}], Query: "${toolParams.searchTerm}"`
@@ -10772,7 +10774,8 @@ var defaultToolDescriptions = {
     ${SYSTEM_REMINDER}
   `,
   CallWixSiteAPI: dedent_default`
-    Call Wix apis on a business or site. Use this to create, read, update, and delete data and other Wix entities in your Wix site,
+    Call Wix apis on a business or site. Use this to create, read, update, and delete data and other Wix entities in your Wix site.
+    For POST/PATCH/PUT requests, pass the request body as a JSON object in the "body" parameter with all the required fields and values as described in the API schema, code examples, or docs you retrieved (e.g. body: {"name": "value", "nested": {"key": "value"}}).
     The API endpoint url param MUST ALWAYS be taken from the conversation context.
     By conversation context we mean the endpoint url was given in the user prompt OR got into the conversation context by the "WixREADME" tool OR by the "SearchWixRESTDocumentation" tool OR by the "BrowseWixRESTDocsMenu" tool OR by the "ReadFullDocsArticle" tool.
     Error Handling:
@@ -10789,6 +10792,7 @@ var defaultToolDescriptions = {
   `,
   ManageWixSite: dedent_default`
     Use account level API in order to create a site, update a site and publish site.
+    For POST/PATCH/PUT requests, pass the request body as a JSON object in the "body" parameter with all the required fields and values as described in the API schema, code examples, or docs you retrieved (e.g. body: {"name": "value", "nested": {"key": "value"}}).
     The API endpoint url param MUST ALWAYS be taken from the conversation context.
     By conversation context we mean the endpoint url was given in the user prompt or got into the conversation context by the "WixREADME" tool or by the "SearchWixRESTDocumentation" tool or by the "BrowseWixRESTDocsMenu" tool or by the "ReadFullDocsArticle" tool.
     ${SYSTEM_REMINDER}
@@ -10866,6 +10870,148 @@ var defaultToolDescriptions = {
   `,
   VeloREADME: dedent_default`
     This tool is set for providing Velo context in order to be used by the agent for executing Velo-related tasks.
+  `,
+  SearchWixCLIDocumentation: dedent_default`
+    Searches the Wix CLI documentation for website development and CLI commands.
+    Use this tool when you need information about Wix CLI commands, local development workflows, or CLI-based website development.
+    Specify what you need information about (e.g., 'wix dev command', 'local development setup', 'CLI authentication', 'wix deploy').
+    If you can't find what you need, try to rephrase your search term or use bigger maxResults value.
+    ${SYSTEM_REMINDER}
+  `,
+  SearchWixAPISpec: dedent_default`
+    Search the Wix REST API documentation by writing JavaScript code that runs in a sandboxed environment.
+    Your code has access to two globals:
+
+    **lightIndex** — Array of all Wix REST API resources (~330):
+    \`\`\`typescript
+    interface LightResource {
+      name: string;           // e.g. "Products V3", "Contact V4"
+      resourceId: string;
+      menuPath: string[];     // e.g. ["business-solutions", "stores", "catalog-v3", "products-v3"]
+      methods: Array<{
+        operationId: string;  // e.g. "wix.stores.catalog.v3.CatalogApi.CreateProduct"
+        summary: string;      // e.g. "Create Product"
+        httpMethod: string;   // "get" | "post" | "patch" | "delete"
+        path: string;         // e.g. "/v3/products"
+        description: string;  // truncated to 200 chars
+      }>;
+    }
+    \`\`\`
+
+    **getResourceSchema(resourceId)** — Async function returning the full schema for a resource:
+    \`\`\`typescript
+    interface FullSchema {
+      title: string;
+      description: string;
+      fqdn: string;
+      methods: Array<{
+        summary: string;
+        description: string;
+        operationId: string;
+        httpMethod: string;
+        path: string;
+        servers: Array<{ url: string }>;           // Base URLs (e.g. "https://www.wixapis.com/...")
+        requestBody: object | null;
+        responses: object;
+        parameters: Array<object>;
+        permissions: string[];
+        legacyExamples: Array<{                    // Curl examples
+          content: { title: string; request: string; response: string };
+        }>;
+        sdkData: {                                 // JS SDK examples
+          packageName: string;
+          namespace: string;
+          methodExamples: Array<{ title: string; content: string }>;
+        };
+      }>;
+      components: { schemas: object };
+    }
+    \`\`\`
+
+    Your code MUST be an \`async function()\` expression that returns a value.
+
+    Top-level verticals: business-solutions (stores, e-commerce, bookings, events, restaurants, pricing-plans, coupons), crm (contacts, members, loyalty-program, forms, community), business-management (payments, invoices, automations), assets (media, files), app-management (oauth, billing), account-level, site.
+
+    Examples:
+
+    Find APIs by keyword:
+    \`\`\`javascript
+    async function() {
+      return lightIndex.filter(r => r.methods.some(m => m.summary.toLowerCase().includes("query products")))
+        .map(r => ({ name: r.name, methods: r.methods.map(m => m.summary + " (" + m.httpMethod.toUpperCase() + " " + m.path + ")") }));
+    }
+    \`\`\`
+
+    Get full schema with base URL, curl examples, and permissions:
+    \`\`\`javascript
+    async function() {
+      const resource = lightIndex.find(r => r.name === "Contact V4");
+      const schema = await getResourceSchema(resource.resourceId);
+      const method = schema.methods.find(m => m.summary === "Query Contacts");
+      return {
+        baseUrl: method.servers?.find(s => s.url.includes("wixapis.com"))?.url,
+        path: method.path,
+        httpMethod: method.httpMethod,
+        permissions: method.permissions,
+        requestBody: method.requestBody,
+        curlExample: method.legacyExamples?.[0]?.content,
+        sdkExample: method.sdkData?.methodExamples?.[0]?.content
+      };
+    }
+    \`\`\`
+
+    Browse a vertical:
+    \`\`\`javascript
+    async function() {
+      return lightIndex.filter(r => r.menuPath[0] === "crm")
+        .map(r => ({ name: r.name, path: r.menuPath.join(" > "), methods: r.methods.length }));
+    }
+    \`\`\`
+  `,
+  ExecuteWixAPI: dedent_default`
+    Execute JavaScript code against the Wix REST API. First use the 'SearchWixAPISpec' tool to find the right endpoints, base URLs, and request/response schemas. Then write code using the wix.request() function. Auth is handled automatically — do not set Authorization headers.
+
+    Available in your code:
+    \`\`\`typescript
+    interface WixRequestOptions {
+      method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+      url: string;           // Full URL from schema servers field, e.g. "https://www.wixapis.com/contacts/v4/contacts"
+      body?: unknown;
+      headers?: Record<string, string>;  // Do NOT set Authorization — it is injected automatically
+    }
+
+    interface WixResponse<T = unknown> {
+      status: number;
+      data: T;
+    }
+
+    declare const wix: {
+      request<T = unknown>(options: WixRequestOptions): Promise<WixResponse<T>>;
+    };
+
+    declare const siteId: string | undefined;
+    \`\`\`
+
+    Your code MUST be an \`async function()\` expression that returns the result.
+
+    Example — query products then update one:
+    \`\`\`javascript
+    async function() {
+      const list = await wix.request({
+        method: "POST",
+        url: "https://www.wixapis.com/stores/v1/products/query",
+        body: { query: { paging: { limit: 5 } } }
+      });
+      const product = list.data.products[0];
+      if (!product) return { error: "No products found" };
+      const updated = await wix.request({
+        method: "PATCH",
+        url: \`https://www.wixapis.com/stores/v1/products/\${product.id}\`,
+        body: { product: { name: "Updated Name" } }
+      });
+      return updated.data;
+    }
+    \`\`\`
   `
 };
 var defaultReadmeDocs = [
@@ -11159,7 +11305,7 @@ var paramDescriptions = {
       `Docs urls like https://dev.wix.com/docs/... are not API urls, if you want to read the docs, use the "ReadFullDocsArticle" tool`
     ].join("\n"),
     method: "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)",
-    body: 'The request body object. 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 "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.',
+    body: 'The request body as a JSON object with all the required fields and values, including nested objects. Pass the actual object, 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 "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.',
     reason: "One sentence explaining the original user request and why you are calling this API to complete it.",
     sourceDocUrl: [
       "The URL of the documentation or recipe where you found this API endpoint.",
@@ -11177,7 +11323,7 @@ var paramDescriptions = {
   ManageWixSite: {
     url: "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",
     method: "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)",
-    body: 'The request body object. 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 "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.'
+    body: 'The request body as a JSON object with all the required fields and values, including nested objects. Pass the actual object, 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 "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.'
   },
   SearchWixWDSDocumentation: {
     searchTerm: "The search term to search for in the Wix Design System Documentation",
@@ -11208,6 +11354,11 @@ var paramDescriptions = {
     searchTerm: "The search term to search for in the Velo Documentation",
     maxResults: "The maximum number of results to return, default is 5, max is 15"
   },
+  SearchWixCLIDocumentation: {
+    searchTerm: "The search term to search for in the Wix CLI Documentation",
+    maxResults: "The maximum number of results to return, default is 5, max is 15",
+    reason: "One sentence describing the original user request and the task you are trying to accomplish with this search."
+  },
   ReadFullDocsArticle: {
     articleUrl: "The URL of the docs article or method article to fetch. Should be something like https://dev.wix.com/docs/.../.../..."
   },
@@ -11246,7 +11397,8 @@ var VALID_DOCS_TOOLS = [
   "BUILD_APPS",
   "WIX_HEADLESS",
   "VELO",
-  "BUSINESS_SOLUTIONS"
+  "BUSINESS_SOLUTIONS",
+  "CLI"
 ];
 var addDocsTools = (server2, allowedTools = [
   "WDS",
@@ -11254,7 +11406,8 @@ var addDocsTools = (server2, allowedTools = [
   "SDK",
   "BUILD_APPS",
   "WIX_HEADLESS",
-  "BUSINESS_SOLUTIONS"
+  "BUSINESS_SOLUTIONS",
+  "CLI"
 ], options = {}) => {
   const {
     getToKnowWixEnabled = false,
@@ -11663,6 +11816,62 @@ var addDocsTools = (server2, allowedTools = [
       }
     );
   }
+  if (allowedTools.includes("CLI") && !disableTools?.includes("SearchWixCLIDocumentation")) {
+    server2.tool(
+      "SearchWixCLIDocumentation",
+      getDescription(
+        "SearchWixCLIDocumentation",
+        defaultToolDescriptions.SearchWixCLIDocumentation ?? ""
+      ),
+      (() => {
+        const d = desc("SearchWixCLIDocumentation");
+        return {
+          searchTerm: z.string().describe(d.searchTerm),
+          maxResults: z.number().describe(d.maxResults).min(1).max(15).optional().default(10),
+          reason: z.string().describe(d.reason)
+        };
+      })(),
+      { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+      async ({ searchTerm, maxResults, reason }, { panorama }) => {
+        try {
+          logger.log(
+            `[SearchWixCLIDocumentation] searchTerm="${searchTerm}", reason="${reason}"`
+          );
+          const result = await runSemanticSearchAndFormat({
+            toolName: "CLI",
+            toolParams: {
+              searchTerm
+            },
+            maxResults: Math.max(1, Math.min(maxResults ?? 5, 15)),
+            linesInEachResult: 15
+          });
+          return {
+            content: [
+              {
+                type: "text",
+                text: result
+              }
+            ]
+          };
+        } catch (error) {
+          panorama.errorMonitor().reportError(error);
+          captureException(error, {
+            tags: {
+              componentId: "SearchWixCLIDocumentation",
+              toolName: "SearchWixCLIDocumentation"
+            }
+          });
+          logger.error(
+            `Error searching for ${searchTerm} in Wix CLI: ${error}`
+          );
+          return {
+            isError: true,
+            content: [{ type: "text", text: "Error: " + error.message }]
+          };
+        }
+      }
+    );
+  }
   if (!disableTools?.includes("ReadFullDocsArticle")) {
     server2.tool(
       "ReadFullDocsArticle",