@wix/mcp 1.0.3 → 1.0.5

package/README.md

@@ -140,3 +140,37 @@ https://docs.cursor.com/context/model-context-protocol
 - make sure build files have permissions for cursor to access
 - log should be written to `~/wix-mcp-log.txt`
 - add .env file with `WIX_COOKIE=` to avoid rate limits on SDK tool use
+
+## NVM possible fix:
+```
+  "wix-mcp-remote-prod": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@wix/mcp-remote",
+        "https://mcp.wix.com/sse"
+      ],
+      "env": {
+        "PATH": "<path-to-your-nvm-node-version>/bin"
+      }
+    }
+```
+
+## fnm possible fix:
+
+```
+{
+  "mcpServers": {
+    "wix-mcp-remote-prod": {
+      "command": "sh",
+      "args": [
+        "-c",
+        "eval $(fnm env) && npx -y @wix/mcp-remote https://mcp.wix.com/sse"
+      ]
+    }
+  }
+}
+```
+
+
+

package/build/api-call/index.js

@@ -6,8 +6,7 @@ export function addApiCallTool(server, getSiteAccessToken, getAccountAccessToken
         '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, 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,',
-        'If the error is related to error code "WDE0110: Wix Code not enabled." you should ask the user to do it in the editor',
+        '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'), {

package/build/cli-tools/cli.js

@@ -77,6 +77,7 @@ export function addCliTools(server, allowedTools = [
                     method,
                     headers: {
                         Authorization: authorization,
+                        'wix-site-id': siteIdToUse,
                         ...(body ? { 'Content-Type': 'application/json' } : {})
                     },
                     body

package/build/cli-tools/utils.js

@@ -1,9 +1,22 @@
-import { readFileSync } from 'fs';
+import { existsSync, readFileSync } from 'fs';
 import { homedir } from 'os';
 import path from 'path';
 export function getCliAuthTokenForSiteId(siteIdOrAccountsFileName) {
-    const authData = JSON.parse(readFileSync(path.join(homedir(), `.wix/auth/${siteIdOrAccountsFileName}.json`), 'utf8'));
-    return authData.accessToken;
+    // check if the api-key.json file exists:
+    const apiKeyFileName = path.join(homedir(), `.wix/auth/api-key.json`);
+    const apiKeyFileExists = existsSync(apiKeyFileName);
+    if (apiKeyFileExists) {
+        const apiKeyData = JSON.parse(readFileSync(apiKeyFileName, 'utf8'));
+        return (apiKeyData.token || apiKeyData.accessToken);
+    }
+    const siteTokenFileName = path.join(homedir(), `.wix/auth/${siteIdOrAccountsFileName}.json`);
+    // check if the site token file exists:
+    const siteTokenFileExists = existsSync(siteTokenFileName);
+    if (siteTokenFileExists) {
+        const authData = JSON.parse(readFileSync(siteTokenFileName, 'utf8'));
+        return (authData.accessToken || authData.token);
+    }
+    throw new Error('No site token or api key found. You need to authenticate with Wix CLI first.');
 }
 // f"first get the site id - its in the `{backoffice_app_dir}/.wix/app.config.json` file, it has a json object with a siteId field",
 export function getSiteIdFromCliAppConfig(appPath) {

package/build/docs/docs.js

@@ -36,7 +36,7 @@ export const addDocsTools = (server, allowedTools = [
                 .max(15)
                 .optional()
                 .default(10)
-        }, async ({ searchTerm, maxResults }, { panorama }) => {
+        }, async ({ searchTerm, maxResults }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Wix WDS`);
                 const result = await runSemanticSearchAndFormat({
@@ -56,7 +56,7 @@ export const addDocsTools = (server, allowedTools = [
                 };
             }
             catch (error) {
-                panorama.errorMonitor().reportError(error);
+                // panorama.errorMonitor().reportError(error);
                 captureException(error, {
                     tags: {
                         componentId: 'SearchWixWDSDocumentation',
@@ -89,7 +89,7 @@ export const addDocsTools = (server, allowedTools = [
                 .max(15)
                 .optional()
                 .default(10)
-        }, async ({ searchTerm, maxResults }, { panorama }) => {
+        }, async ({ searchTerm, maxResults }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Wix REST API`);
                 const result = await runSemanticSearchAndFormat({
@@ -114,7 +114,7 @@ export const addDocsTools = (server, allowedTools = [
                 };
             }
             catch (error) {
-                panorama.errorMonitor().reportError(error);
+                // panorama.errorMonitor().reportError(error);
                 captureException(error, {
                     tags: {
                         componentId: 'SearchWixRESTDocumentation',
@@ -150,7 +150,7 @@ export const addDocsTools = (server, allowedTools = [
                 .max(15)
                 .optional()
                 .default(5)
-        }, async ({ searchTerm, maxResults }, { panorama }) => {
+        }, async ({ searchTerm, maxResults }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Wix Sample Flows`);
                 const result = await runSemanticSearchAndFormat({
@@ -175,7 +175,7 @@ export const addDocsTools = (server, allowedTools = [
                 };
             }
             catch (error) {
-                panorama.errorMonitor().reportError(error);
+                // panorama.errorMonitor().reportError(error);
                 captureException(error, {
                     tags: {
                         componentId: 'SearchWixSampleFlowsDocumentation',
@@ -208,12 +208,12 @@ export const addDocsTools = (server, allowedTools = [
                 .max(15)
                 .optional()
                 .default(5)
-        }, async ({ searchTerm, maxResults }, { panorama }) => {
+        }, async ({ searchTerm, maxResults }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Wix SDK`);
-                panorama
-                    .transaction('SearchWixSDKDocumentation')
-                    .start({ maxResults });
+                // panorama
+                //   .transaction('SearchWixSDKDocumentation')
+                //   .start({ maxResults });
                 const result = await runSemanticSearchAndFormat({
                     toolName: 'SDK',
                     toolParams: {
@@ -222,9 +222,9 @@ export const addDocsTools = (server, allowedTools = [
                     maxResults: Math.max(1, Math.min(maxResults ?? 5, 15)),
                     linesInEachResult: 15
                 });
-                panorama
-                    .transaction('SearchWixSDKDocumentation')
-                    .finish({ maxResults });
+                // panorama
+                //   .transaction('SearchWixSDKDocumentation')
+                //   .finish({ maxResults });
                 return {
                     content: [
                         {
@@ -239,7 +239,7 @@ export const addDocsTools = (server, allowedTools = [
                 };
             }
             catch (error) {
-                panorama.errorMonitor().reportError(error);
+                // panorama.errorMonitor().reportError(error);
                 captureException(error, {
                     tags: {
                         componentId: 'SearchWixSDKDocumentation',
@@ -272,7 +272,7 @@ export const addDocsTools = (server, allowedTools = [
                 .max(15)
                 .optional()
                 .default(5)
-        }, async ({ searchTerm, maxResults }, { panorama }) => {
+        }, async ({ searchTerm, maxResults }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Build Apps`);
                 const result = await runSemanticSearchAndFormat({
@@ -292,7 +292,7 @@ export const addDocsTools = (server, allowedTools = [
                 };
             }
             catch (error) {
-                panorama.errorMonitor().reportError(error);
+                // panorama.errorMonitor().reportError(error);
                 captureException(error, {
                     tags: {
                         componentId: 'SearchBuildAppsDocumentation',
@@ -324,7 +324,7 @@ export const addDocsTools = (server, allowedTools = [
                 .max(15)
                 .optional()
                 .default(5)
-        }, async ({ searchTerm, maxResults }, { panorama }) => {
+        }, async ({ searchTerm, maxResults }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Headless`);
                 const result = await runSemanticSearchAndFormat({
@@ -344,7 +344,7 @@ export const addDocsTools = (server, allowedTools = [
                 };
             }
             catch (error) {
-                panorama.errorMonitor().reportError(error);
+                // panorama.errorMonitor().reportError(error);
                 captureException(error, {
                     tags: {
                         componentId: 'SearchWixHeadlessDocumentation',

package/build/support/index.js

@@ -4,16 +4,14 @@ export function addSupportTool(server) {
         '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.',
-        'You should let the user know that they can provide feedback to Wix using [Devs on Wix Discord community](https://discord.gg/GhdmDN926z). and suggest them to format the message using this tool',
-        '**IMPORTANT NOTES**',
-        '1. This tool is not sending the message formats it for users to use in discord',
-        '2. Mention in the provided message that it is related to Wix MCP and the tools provided'
+        '**IMPORTANT NOTE**',
+        'This tool is not sending the message, but formats it in order to another tool to actually send it'
     ].join('\n'), {
         requestId: z
             .string()
             .optional()
             .describe('request id if returned from the server in a failed API call to Wix'),
-        message: z.string().describe('The message to send to Wix over discord')
+        message: z.string().describe('The message to send to Wix')
     }, async ({ requestId, message }) => {
         return {
             content: [
@@ -23,7 +21,10 @@ export function addSupportTool(server) {
                 },
                 {
                     type: 'text',
-                    text: 'You should present the user with the formatted message above and ask them to send it over discord to Wix - [Devs on Wix Discord community](https://discord.gg/GhdmDN926z), if you have another tool to send it over discord, you can use it to send the message directly'
+                    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.'
                 }
             ]
         };

package/build/wix-mcp-server.d.ts

@@ -1,11 +1,8 @@
 import type { z, ZodRawShape, ZodTypeAny } from 'zod';
 import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import type { PanoramaClientForComponent } from '@wix/panorama-client-node';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-type WixRequestHandlerExtra = RequestHandlerExtra & {
-    panorama: PanoramaClientForComponent;
-};
+type WixRequestHandlerExtra = RequestHandlerExtra & {};
 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>;
 export declare class WixMcpServer extends McpServer {
     tool(name: string, cb: WixToolCallback): void;

package/build/wix-mcp-server.js

@@ -1,6 +1,7 @@
+// import type { PanoramaClientForComponent } from '@wix/panorama-client-node';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { globalConfig, panoramaFactory } from './panorama.js';
-import { captureException, setTags } from '@sentry/node';
+//import { globalConfig, panoramaFactory } from './panorama.js';
+import { captureException } from '@sentry/node';
 export class WixMcpServer extends McpServer {
     tool(...args) {
         const cbIndex = args.findIndex((arg) => typeof arg === 'function');
@@ -8,29 +9,29 @@ export class WixMcpServer extends McpServer {
             const originalCb = args[cbIndex];
             const toolName = args[0];
             const panoramaComponentId = toolName;
-            const panorama = panoramaFactory.client({
-                baseParams: {
-                    componentId: panoramaComponentId
-                }
-            });
-            setTags({
-                panoramaSessionId: globalConfig.getSessionId()
-            });
+            /*const panorama = panoramaFactory.client({
+              baseParams: {
+                componentId: panoramaComponentId
+              }
+            });*/
+            /*setTags({
+              panoramaSessionId: globalConfig.getSessionId()
+            });*/
             const wrappedCb = async (...cbArgs) => {
                 const argsBeforeExtra = cbArgs.slice(0, cbArgs.length - 1);
                 const extra = cbArgs[cbArgs.length - 1];
                 const wrappedExtra = {
-                    ...extra,
-                    panorama: panorama.createClientForComponent()
+                    ...extra
+                    // panorama: panorama.createClientForComponent()
                 };
-                panorama.transaction(toolName).start();
+                //panorama.transaction(toolName).start();
                 try {
                     const cbResult = await originalCb(...argsBeforeExtra, wrappedExtra);
-                    panorama.transaction(toolName).finish();
+                    //panorama.transaction(toolName).finish();
                     return cbResult;
                 }
                 catch (e) {
-                    panorama.errorMonitor().reportError(e);
+                    //panorama.errorMonitor().reportError(e as Error);
                     captureException(e, {
                         tags: {
                             componentId: panoramaComponentId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/mcp",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "A Model Context Protocol server for Wix AI tools",
   "type": "module",
   "bin": "./bin.js",
@@ -23,7 +23,6 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.9.0",
     "@sentry/node": "^9.13.0",
-    "@wix/panorama-client-node": "^3.228.0",
     "execa": "^9.5.2",
     "minimist": "^1.2.8",
     "strip-ansi": "^7.1.0",
@@ -32,17 +31,17 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "@eslint/js": "^9.25.0",
+    "@eslint/js": "^9.25.1",
     "@types/express": "^5.0.1",
     "@types/minimist": "^1.2.5",
-    "@types/node": "^20.17.30",
-    "eslint": "^9.25.0",
+    "@types/node": "^20.17.31",
+    "eslint": "^9.25.1",
     "eslint-config-prettier": "^10.1.2",
     "eslint-plugin-prettier": "^5.2.6",
     "globals": "^16.0.0",
     "prettier": "^3.5.3",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.30.1",
+    "typescript-eslint": "^8.31.0",
     "vitest": "^3.1.2"
   },
   "exports": {
@@ -63,5 +62,5 @@
       ]
     }
   },
-  "falconPackageHash": "b6e838772abadece4f3efd3c6c47cb26389c06c162e4d629e98eca81"
+  "falconPackageHash": "2b9b8f55614d88448109d86ff590f94348739875ce6b9769eeca1339"
 }

package/build/panorama.d.ts

@@ -1,2 +0,0 @@
-export declare const globalConfig: import("@wix/panorama-client-node").GlobalConfig<import("@wix/panorama-common-shared/dist/types/types/data-types.js").EventPayload, {}>;
-export declare const panoramaFactory: import("@wix/panorama-client").PanoramaClientFactory<import("@wix/panorama-common-shared/dist/types/types/data-types.js").EventPayload>;

package/build/panorama.js

@@ -1,23 +0,0 @@
-// import { createRequire } from 'module';
-import { createGlobalConfig, panoramaClientFactory, PanoramaPlatform } from '@wix/panorama-client-node';
-// const require = createRequire(import.meta.url);
-// const packageJson = require('../package.json');
-// TODO: use real package.json
-// I temporarily disabled this because it's not working in the remote server
-const packageJson = {
-    version: '1.0.0'
-};
-export const globalConfig = createGlobalConfig();
-export const panoramaFactory = panoramaClientFactory({
-    baseParams: {
-        platform: PanoramaPlatform.Standalone,
-        fullArtifactId: 'com.wixpress.spartans.wix-mcp',
-        artifactVersion: packageJson.version
-    },
-    data: {
-        packageVersion: packageJson.version,
-        versions: process.versions,
-        platform: process.platform,
-        arch: process.arch
-    }
-}).withGlobalConfig(globalConfig);