@wix/mcp 1.0.29 → 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}"`
@@ -10868,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 = [
@@ -11210,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/.../.../..."
   },
@@ -11248,7 +11397,8 @@ var VALID_DOCS_TOOLS = [
   "BUILD_APPS",
   "WIX_HEADLESS",
   "VELO",
-  "BUSINESS_SOLUTIONS"
+  "BUSINESS_SOLUTIONS",
+  "CLI"
 ];
 var addDocsTools = (server2, allowedTools = [
   "WDS",
@@ -11256,7 +11406,8 @@ var addDocsTools = (server2, allowedTools = [
   "SDK",
   "BUILD_APPS",
   "WIX_HEADLESS",
-  "BUSINESS_SOLUTIONS"
+  "BUSINESS_SOLUTIONS",
+  "CLI"
 ], options = {}) => {
   const {
     getToKnowWixEnabled = false,
@@ -11665,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",