@wix/mcp 1.0.4 → 1.0.6

package/build/index.d.ts

@@ -1,6 +1,30 @@
-export { WixMcpServer } from './wix-mcp-server.js';
-export { addDocsTools, DocsTool, VALID_DOCS_TOOLS } from './docs/docs.js';
-export { addApiCallTool } from './api-call/index.js';
-export { handleWixAPIResponse } from './tool-utils.js';
-export { addDocsResources } from './resources/docs.js';
-export { addSupportTool } from './support/index.js';
+import { ZodRawShape, z, ZodTypeAny } from 'zod';
+import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { PanoramaClientForComponent } from '@wix/panorama-client-node';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+type WixRequestHandlerExtra = RequestHandlerExtra & {
+    panorama: PanoramaClientForComponent;
+};
+type WixToolCallback<Args extends undefined | ZodRawShape = undefined> = Args extends ZodRawShape ? (args: z.objectOutputType<Args, ZodTypeAny>, extra: WixRequestHandlerExtra) => CallToolResult | Promise<CallToolResult> : (extra: WixRequestHandlerExtra) => CallToolResult | Promise<CallToolResult>;
+declare class WixMcpServer extends McpServer {
+    tool(name: string, cb: WixToolCallback): void;
+    tool(name: string, description: string, cb: WixToolCallback): void;
+    tool<Args extends ZodRawShape>(name: string, paramsSchema: Args, cb: WixToolCallback<Args>): void;
+    tool<Args extends ZodRawShape>(name: string, description: string, paramsSchema: Args, cb: WixToolCallback<Args>): void;
+}
+
+declare const VALID_DOCS_TOOLS: readonly ["WDS", "REST", "SDK", "BUILD_APPS", "WIX_HEADLESS", "BUSINESS_SOLUTIONS"];
+type DocsTool = (typeof VALID_DOCS_TOOLS)[number];
+declare const addDocsTools: (server: WixMcpServer, allowedTools?: DocsTool[]) => void;
+
+declare function addApiCallTool(server: WixMcpServer, getSiteAccessToken: (siteId: string) => Promise<string>, getAccountAccessToken: () => Promise<string>): void;
+
+declare const handleWixAPIResponse: <T = any>(response: Response) => Promise<T>;
+
+declare const addDocsResources: (server: McpServer, portals: string[]) => Promise<void>;
+
+declare function addSupportTool(server: WixMcpServer): void;
+
+export { type DocsTool, VALID_DOCS_TOOLS, WixMcpServer, addApiCallTool, addDocsResources, addDocsTools, addSupportTool, handleWixAPIResponse };

package/build/index.js

@@ -1,6 +1,193 @@
-export { WixMcpServer } from './wix-mcp-server.js';
-export { addDocsTools, VALID_DOCS_TOOLS } from './docs/docs.js';
-export { addApiCallTool } from './api-call/index.js';
-export { handleWixAPIResponse } from './tool-utils.js';
-export { addDocsResources } from './resources/docs.js';
-export { addSupportTool } from './support/index.js';
+import {
+  VALID_DOCS_TOOLS,
+  WixMcpServer,
+  addDocsResources,
+  addDocsTools,
+  handleWixAPIResponse,
+  logger
+} from "./chunk-YRLMZUQM.js";
+
+// src/api-call/index.ts
+import { z } from "zod";
+function addApiCallTool(server, getSiteAccessToken, getAccountAccessToken) {
+  server.tool(
+    "CallWixSiteAPI",
+    [
+      "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,",
+      `You should ALWAYS check the rest docs - "SearchWixRESTDocumentation" for the specific API you want to call, don't just call it without knowing what it does, CHECK THE DOCS`,
+      "Error Handling:",
+      'If the error is related to missing installed app or "WDE0110: Wix Code not enabled", you should install the missing app by using ReadFullDocsArticle tool to fetch the article - https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_wix.devcenter.apps.installer.v1.AppsInstallerService.InstallApp',
+      "**Note:** there is no need to check if an app is installed/ Wix Code enabled in advance, just call the API and handle the error if it occurs, the API error message will state it clearly.",
+      "For any other error, use your default error handling mechanism"
+    ].join("\n"),
+    {
+      siteId: z.string().describe("The id of the site selected using site selection tool"),
+      url: z.string().describe(
+        "The url of the api to call - ALWAYS get the information from the Wix REST docs or from the conversation context, the URL MUST BE ABSOLUTE URL"
+      ),
+      method: z.string().describe(
+        "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)"
+      ),
+      body: z.string().optional().describe(
+        "A string representing of a valid JSON object to describe the body of the request"
+      )
+    },
+    async ({ url, body, method, siteId }) => {
+      logger.log(
+        `Calling Wix Site API: ${siteId} ${url}, body: ${JSON.stringify(body)}`
+      );
+      const authorization = await getSiteAccessToken(siteId);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: authorization,
+            ...body ? { "Content-Type": "application/json" } : {}
+          },
+          body: method === "GET" ? void 0 : body
+        });
+        const responseData = await handleWixAPIResponse(response);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Wix Site API call successful: ${JSON.stringify(responseData)}`
+            }
+          ]
+        };
+      } catch (error) {
+        logger.error(`Failed to call Wix Site API: ${error}`);
+        throw new Error(`Failed to call Wix Site API: ${error}`);
+      }
+    }
+  );
+  server.tool(
+    "ListWixSites",
+    "List Wix sites for the current user",
+    async () => {
+      const sitesRes = await fetch(
+        "https://www.wixapis.com/site-list/v2/sites/query",
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json, text/plain, */*",
+            Authorization: await getAccountAccessToken()
+          },
+          body: JSON.stringify({
+            query: {
+              cursorPaging: { limit: 50 }
+            }
+          })
+        }
+      );
+      const result = await sitesRes.json().then(
+        ({ sites }) => sites?.map(({ id, displayName }) => ({
+          id,
+          name: displayName
+        })) ?? []
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result)
+          },
+          {
+            type: "text",
+            text: "if there is more than one site returned, the user should pick one from a list, list the sites (only name) for the user and ask them to pick one"
+          }
+        ]
+      };
+    }
+  );
+  server.tool(
+    "ManageWixSite",
+    `Use account level API in order to create a site, update a site and publish site.
+    ALWAYS use "SearchWixRESTDocumentation" to search for the API you should invoke, NEVER GUESS THE SITE API URL
+    You should ALWAYS check the rest docs - "SearchWixRESTDocumentation" for the specific API you want to call, don't just call it without knowing what it does, CHECK THE DOCS`,
+    {
+      url: z.string().describe(
+        "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: z.string().describe(
+        "The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)"
+      ),
+      body: z.string().optional().describe(
+        "A string representing of a valid JSON object to describe the body of the request"
+      )
+    },
+    async ({ url, body, method }) => {
+      logger.log(
+        `Calling Wix Account level API: ${url}, body: ${JSON.stringify(body)}`
+      );
+      const authorization = await getAccountAccessToken();
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: authorization,
+            ...body ? { "Content-Type": "application/json" } : {}
+          },
+          body: method === "GET" ? void 0 : body
+        });
+        const responseData = await handleWixAPIResponse(response);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Wix Account API call successful: ${JSON.stringify(responseData)}`
+            }
+          ]
+        };
+      } catch (error) {
+        logger.error(`Failed to call Wix Account API: ${error}`);
+        throw new Error(`Failed to call Wix Account API: ${error}`);
+      }
+    }
+  );
+}
+
+// src/support/index.ts
+import { z as z2 } from "zod";
+function addSupportTool(server) {
+  server.tool(
+    "SupportAndFeedback",
+    [
+      "If the user would like to provide Wix with some feedback (good or bad), about the tools in Wix MCP,",
+      "for example they used the tools provided, and they reflected satisfaction or dissatisfaction with the tools.",
+      "Also, if you encounter too many errors tyring to call the Wix API, you can also suggest the user to provide feedback to Wix using this tool.",
+      "**IMPORTANT NOTE**",
+      "This tool is not sending the message, but formats it in order to another tool to actually send it"
+    ].join("\n"),
+    {
+      requestId: z2.string().optional().describe(
+        "request id if returned from the server in a failed API call to Wix"
+      ),
+      message: z2.string().describe("The message to send to Wix")
+    },
+    async ({ requestId, message }) => {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `${message} ${requestId ? `request id: ${requestId}` : ""}`
+          },
+          {
+            type: "text",
+            text: "You should present the user with the formatted message above and ask if they would like to send it to Wix.If the user confirms, you can get the details about send feedback API from the article `https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_send_mcp_feedback_to_wix_from_user`.You can use the `ReadFullDocsArticle` tool to fetch the article and get the details about the API call.Once you have the details, you can use the `ManageWixSite` (if site id is in context) or `CallWixSiteAPI` (if site id is not in context) tool to call the API and send the feedback to Wix."
+          }
+        ]
+      };
+    }
+  );
+}
+export {
+  VALID_DOCS_TOOLS,
+  WixMcpServer,
+  addApiCallTool,
+  addDocsResources,
+  addDocsTools,
+  addSupportTool,
+  handleWixAPIResponse
+};

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@wix/mcp",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "A Model Context Protocol server for Wix AI tools",
   "type": "module",
   "bin": "./bin.js",
   "files": [
-    "build"
+    "build",
+    "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc --noEmit && tsup-node",
     "test": "vitest run",
     "test:watch": "vitest",
     "start": "npm run build && node ./build/bin.js",
@@ -35,11 +36,13 @@
     "@types/express": "^5.0.1",
     "@types/minimist": "^1.2.5",
     "@types/node": "^20.17.31",
+    "@wix/panorama-client-node": "^3.228.0",
     "eslint": "^9.25.1",
     "eslint-config-prettier": "^10.1.2",
     "eslint-plugin-prettier": "^5.2.6",
     "globals": "^16.0.0",
     "prettier": "^3.5.3",
+    "tsup": "^8.4.0",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.31.0",
     "vitest": "^3.1.2"
@@ -62,5 +65,5 @@
       ]
     }
   },
-  "falconPackageHash": "4fdd1bedb002c7deddf1dd04c2810b00c9864cbed6168260ad3a32d0"
+  "falconPackageHash": "6bff51606aed52121711cca3ff10da3c1ba3bef77a9bc77809146d16"
 }

package/build/api-call/index.d.ts

@@ -1,2 +0,0 @@
-import { WixMcpServer } from '../wix-mcp-server.js';
-export declare function addApiCallTool(server: WixMcpServer, getSiteAccessToken: (siteId: string) => Promise<string>, getAccountAccessToken: () => Promise<string>): void;

package/build/api-call/index.js

@@ -1,124 +0,0 @@
-import { z } from 'zod';
-import { logger } from '../logger.js';
-import { handleWixAPIResponse } from '../tool-utils.js';
-export function addApiCallTool(server, getSiteAccessToken, getAccountAccessToken) {
-    server.tool('CallWixSiteAPI', [
-        '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,',
-        `You should ALWAYS check the rest docs - "SearchWixRESTDocumentation" for the specific API you want to call, don't just call it without knowing what it does, CHECK THE DOCS`,
-        'Error Handling:',
-        'If the error is related to missing installed app or "WDE0110: Wix Code not enabled", you should install the missing app by using ReadFullDocsArticle tool to fetch the article - https://dev.wix.com/docs/kb-only/MCP_REST_RECIPES_KB_ID/TRAIN_wix.devcenter.apps.installer.v1.AppsInstallerService.InstallApp',
-        '**Note:** there is no need to check if an app is installed/ Wix Code enabled in advance, just call the API and handle the error if it occurs, the API error message will state it clearly.',
-        'For any other error, use your default error handling mechanism'
-    ].join('\n'), {
-        siteId: z
-            .string()
-            .describe('The id of the site selected using site selection tool'),
-        url: z
-            .string()
-            .describe('The url of the api to call - ALWAYS get the information from the Wix REST docs or from the conversation context, the URL MUST BE ABSOLUTE URL'),
-        method: z
-            .string()
-            .describe('The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)'),
-        body: z
-            .string()
-            .optional()
-            .describe('A string representing of a valid JSON object to describe the body of the request')
-    }, async ({ url, body, method, siteId }) => {
-        logger.log(`Calling Wix Site API: ${siteId} ${url}, body: ${JSON.stringify(body)}`);
-        const authorization = await getSiteAccessToken(siteId);
-        try {
-            const response = await fetch(url, {
-                method,
-                headers: {
-                    Authorization: authorization,
-                    ...(body ? { 'Content-Type': 'application/json' } : {})
-                },
-                body: method === 'GET' ? undefined : body
-            });
-            const responseData = await handleWixAPIResponse(response);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Wix Site API call successful: ${JSON.stringify(responseData)}`
-                    }
-                ]
-            };
-        }
-        catch (error) {
-            logger.error(`Failed to call Wix Site API: ${error}`);
-            throw new Error(`Failed to call Wix Site API: ${error}`);
-        }
-    });
-    server.tool('ListWixSites', 'List Wix sites for the current user', async () => {
-        const sitesRes = await fetch('https://www.wixapis.com/site-list/v2/sites/query', {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                Accept: 'application/json, text/plain, */*',
-                Authorization: await getAccountAccessToken()
-            },
-            body: JSON.stringify({
-                query: {
-                    cursorPaging: { limit: 50 }
-                }
-            })
-        });
-        const result = await sitesRes.json().then(({ sites }) => sites?.map(({ id, displayName }) => ({
-            id,
-            name: displayName
-        })) ?? []);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify(result)
-                },
-                {
-                    type: 'text',
-                    text: 'if there is more than one site returned, the user should pick one from a list, list the sites (only name) for the user and ask them to pick one'
-                }
-            ]
-        };
-    });
-    server.tool('ManageWixSite', `Use account level API in order to create a site, update a site and publish site.
-    ALWAYS use "SearchWixRESTDocumentation" to search for the API you should invoke, NEVER GUESS THE SITE API URL
-    You should ALWAYS check the rest docs - "SearchWixRESTDocumentation" for the specific API you want to call, don't just call it without knowing what it does, CHECK THE DOCS`, {
-        url: z
-            .string()
-            .describe('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: z
-            .string()
-            .describe('The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)'),
-        body: z
-            .string()
-            .optional()
-            .describe('A string representing of a valid JSON object to describe the body of the request')
-    }, async ({ url, body, method }) => {
-        logger.log(`Calling Wix Account level API: ${url}, body: ${JSON.stringify(body)}`);
-        const authorization = await getAccountAccessToken();
-        try {
-            const response = await fetch(url, {
-                method,
-                headers: {
-                    Authorization: authorization,
-                    ...(body ? { 'Content-Type': 'application/json' } : {})
-                },
-                body: method === 'GET' ? undefined : body
-            });
-            const responseData = await handleWixAPIResponse(response);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Wix Account API call successful: ${JSON.stringify(responseData)}`
-                    }
-                ]
-            };
-        }
-        catch (error) {
-            logger.error(`Failed to call Wix Account API: ${error}`);
-            throw new Error(`Failed to call Wix Account API: ${error}`);
-        }
-    });
-}

package/build/cli-tools/cli.d.ts

@@ -1,4 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare const VALID_CLI_TOOLS: readonly ["WIX_API", "CLI_COMMAND", "CLI_COMMAND_INTERACTIVE_MODE"];
-export type CLITool = (typeof VALID_CLI_TOOLS)[number];
-export declare function addCliTools(server: McpServer, allowedTools?: CLITool[], isWixOne?: boolean): void;