@wix/mcp 1.0.79 → 1.0.80

package/build/cjs/toolkit.cjs

@@ -17658,7 +17658,7 @@ var DISCOVERY_FLOWS = [
   "- METHOD CODE EXAMPLE BASED: BrowseWixRESTDocsMenu() or SearchWixRESTDocumentation() -> find relevant method -> read method article using ReadFullDocsArticle() to get method code examples -> call API using CallWixSiteAPI() based on the method code examples",
   "- FULL SCHEMA BASED: BrowseWixRESTDocsMenu() or SearchWixRESTDocumentation() -> find relevant method -> read method article using ReadFullDocsArticle() -> no method code examples found -> inspect the method schema using SearchWixAPISpec or ReadFullDocsMethodSchema -> call API using CallWixSiteAPI() based on the schema"
 ];
-function buildSystemReminderGuidelines(includeReadme) {
+function buildSystemReminderGuidelines(includeReadme, includeImageUploadGuidance) {
   const exception = includeReadme ? "**Exception:** " : "";
   const lines = [];
   if (includeReadme) {
@@ -17670,9 +17670,13 @@ function buildSystemReminderGuidelines(includeReadme) {
     );
   }
   lines.push(
-    `${exception}If the user asks to list, show, or find their Wix sites, ${includeReadme ? "skip WixREADME and " : ""}call ListWixSites directly.`,
-    `${exception}If the user wants to upload local or attached image files to a Wix site, skip ${includeReadme ? "WixREADME and " : ""}all docs/schema/API flows \u2014 call UploadImageToWixSite directly. Do NOT use ExecuteWixAPI, SearchWixAPISpec, or any Media Manager REST API for image uploads.`
+    `${exception}If the user asks to list, show, or find their Wix sites, ${includeReadme ? "skip WixREADME and " : ""}call ListWixSites directly.`
   );
+  if (includeImageUploadGuidance) {
+    lines.push(
+      `${exception}If the user wants to upload local or attached image files to a Wix site, skip ${includeReadme ? "WixREADME and " : ""}all docs/schema/API flows \u2014 call UploadImageToWixSite directly. Do NOT use ExecuteWixAPI, SearchWixAPISpec, or any Media Manager REST API for image uploads.`
+    );
+  }
   if (includeReadme) {
     lines.push(
       "If the WixREADME tool is not available to you, you should use the other flows as described without using the WixREADME tool until the task is completed."
@@ -17699,9 +17703,15 @@ function buildSystemReminderFlows(includeReadme) {
   lines.push(...DISCOVERY_FLOWS);
   return lines.join("\n");
 }
-var SYSTEM_REMINDER_GUIDELINES = buildSystemReminderGuidelines(true);
-function buildSystemReminder(includeReadme) {
-  const guidelines = buildSystemReminderGuidelines(includeReadme);
+var SYSTEM_REMINDER_GUIDELINES = buildSystemReminderGuidelines(
+  true,
+  true
+);
+function buildSystemReminder(includeReadme, includeImageUploadGuidance = true) {
+  const guidelines = buildSystemReminderGuidelines(
+    includeReadme,
+    includeImageUploadGuidance
+  );
   const flows = buildSystemReminderFlows(includeReadme);
   return dedent_default`
     <agent-mandatory-instructions>
@@ -17912,8 +17922,11 @@ var executeWixApiDescription = dedent_default`
 
   ${EXECUTE_WIX_API_MULTI_SITE_EXAMPLE}
 `;
-function buildToolDescriptions(includeReadme) {
-  const reminder = buildSystemReminder(includeReadme);
+function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true) {
+  const reminder = buildSystemReminder(
+    includeReadme,
+    includeImageUploadGuidance
+  );
   return {
     WixREADME: dedent_default`
     # Tool: WixREADME
@@ -17964,6 +17977,7 @@ function buildToolDescriptions(includeReadme) {
     **Prefer this tool over CallWixSiteAPI for listing sites.** Call this tool directly — it already knows the correct API and handles everything needed. Only fall back to CallWixSiteAPI if the user needs advanced filtering or specific site details beyond what this tool provides.
     ${reminder}
   `,
+    get_profile: "Returns the authenticated user's email address",
     GetSiteContext: dedent_default`
     Fetches deep context for a specific Wix site and returns it as structured markdown.
 
@@ -21607,13 +21621,13 @@ function createWixToolkit(options) {
     clientName,
     hooks,
     conversationId,
-    includeReadmeMentions = false
+    includeReadmeMentions = false,
+    includeImageUploadGuidance = false
   } = options;
   const authStrategy = normalizeAuth(auth);
   const executeWixApiRequested = isExecuteWixApiRequested(api);
-  let descriptionsWithoutReadme;
+  const descriptionsWithoutReadme = buildToolDescriptions(includeReadmeMentions, includeImageUploadGuidance);
   if (!includeReadmeMentions) {
-    descriptionsWithoutReadme = buildToolDescriptions(false);
     delete descriptionsWithoutReadme.WixREADME;
   }
   const sessionId = v4_default();
@@ -21630,13 +21644,16 @@ function createWixToolkit(options) {
       authStrategy,
       dynamicContextEnabled: true,
       // README-free defaults first so consumer overrides still win.
-      toolDescriptions: descriptionsWithoutReadme ? { ...descriptionsWithoutReadme, ...docsOptions.toolDescriptions } : docsOptions.toolDescriptions
+      toolDescriptions: {
+        ...descriptionsWithoutReadme,
+        ...docsOptions.toolDescriptions
+      }
     });
   } else {
     addDocsTools(server, void 0, {
       authStrategy,
       dynamicContextEnabled: true,
-      ...descriptionsWithoutReadme ? { toolDescriptions: descriptionsWithoutReadme } : {}
+      toolDescriptions: descriptionsWithoutReadme
     });
   }
   if (api) {
@@ -21649,7 +21666,7 @@ function createWixToolkit(options) {
       maxResponseSize,
       codeModeBaseUrl = "https://mcp.wix.com"
     } = api;
-    const effectiveToolDescriptions = includeReadmeMentions ? executeWixApiRequested ? { ...executeCodeModeToolDescriptions, ...toolDescriptions } : toolDescriptions : {
+    const effectiveToolDescriptions = {
       ...descriptionsWithoutReadme,
       ...executeWixApiRequested ? executeCodeModeToolDescriptions : {},
       ...toolDescriptions

package/build/dts/account-tools/get-profile-tool.d.ts

@@ -0,0 +1,5 @@
+import { type McpAuthenticationStrategy } from '../auth/index.js';
+import type { WixMcpServer } from '../wix-mcp-server.js';
+import type { ToolHintsConfig } from '../api-call/index.js';
+export declare function addGetProfileTool(server: WixMcpServer, authStrategy: McpAuthenticationStrategy, disableTools?: string[], toolDescriptions?: Record<string, string>, toolHints?: Record<string, ToolHintsConfig>): void;
+//# sourceMappingURL=get-profile-tool.d.ts.map

package/build/dts/account-tools/get-profile-tool.js

@@ -0,0 +1,49 @@
+import { rethrowIfUnauthorized } from '../auth/index.js';
+import { defaultToolDescriptions } from '../config/default-config.js';
+import { createHttpClient } from '@wix/http-client';
+import { getTeamMember } from '@wix/ambassador-identity-account-v1-user/http';
+const WIX_APIS_BASE_URL = 'https://www.wixapis.com';
+const GET_PROFILE_TOOL_NAME = 'get_profile';
+export function addGetProfileTool(server, authStrategy, disableTools = [], toolDescriptions, toolHints) {
+    if (disableTools.includes(GET_PROFILE_TOOL_NAME)) {
+        return;
+    }
+    const cache = {};
+    const hints = toolHints?.[GET_PROFILE_TOOL_NAME];
+    server.tool(GET_PROFILE_TOOL_NAME, toolDescriptions?.[GET_PROFILE_TOOL_NAME] ??
+        defaultToolDescriptions[GET_PROFILE_TOOL_NAME], {}, {
+        readOnlyHint: hints?.readOnlyHint ?? true,
+        destructiveHint: hints?.destructiveHint ?? false,
+        openWorldHint: hints?.openWorldHint ?? false
+    }, async () => {
+        const profilePromise = (cache.profilePromise ??= (async () => {
+            const accountAuthHeaders = await authStrategy.getAccountAuthHeaders();
+            const httpClient = createHttpClient({
+                baseURL: WIX_APIS_BASE_URL,
+                headers: accountAuthHeaders
+            });
+            const response = await httpClient.request(getTeamMember({}));
+            const email = response.data.user?.email;
+            if (!email) {
+                throw new Error('The current Wix user profile has no email address.');
+            }
+            return { email };
+        })());
+        const profile = await profilePromise.catch(async (error) => {
+            cache.profilePromise = undefined;
+            rethrowIfUnauthorized(error);
+            await authStrategy.enforceValidWixToken?.(error);
+            throw error;
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: profile.email
+                }
+            ],
+            structuredContent: profile
+        };
+    });
+}
+//# sourceMappingURL=get-profile-tool.js.map

package/build/dts/config/default-config.d.ts

@@ -21,7 +21,7 @@ export interface ModeDefaultConfig {
     skillsPrOverrideEnabled?: boolean;
 }
 export declare const SYSTEM_REMINDER_GUIDELINES: string;
-export declare function buildSystemReminder(includeReadme: boolean): string;
+export declare function buildSystemReminder(includeReadme: boolean, includeImageUploadGuidance?: boolean): string;
 export declare const SYSTEM_REMINDER: string;
 export declare const SITE_CREATION_COPY: {
     readonly templatePick: {
@@ -40,7 +40,7 @@ export declare const SITE_CREATION_COPY: {
 /** Rewrites non-widget copy into its widget form; a no-op on text that carries no divergence. */
 export declare const toWidget: (text: string) => string;
 export declare const executeWixApiDescription: string;
-export declare function buildToolDescriptions(includeReadme: boolean): Record<string, string>;
+export declare function buildToolDescriptions(includeReadme: boolean, includeImageUploadGuidance?: boolean): Record<string, string>;
 /**
  * Canonical (README-inclusive) tool descriptions used by the live MCP server and
  * all existing importers.

package/build/dts/config/default-config.js

@@ -13,13 +13,16 @@ const DISCOVERY_FLOWS = [
 ];
 // README-only lines and site-creation routing are added only when includeReadme
 // is true (README-free consumers like aria don't do site creation).
-function buildSystemReminderGuidelines(includeReadme) {
+function buildSystemReminderGuidelines(includeReadme, includeImageUploadGuidance) {
     const exception = includeReadme ? '**Exception:** ' : '';
     const lines = [];
     if (includeReadme) {
         lines.push('if the WixREADME tool is available to you, YOU MUST USE IT AT THE BEGINNING OF ANY CONVERSATION and then continue with calling the other tools and calling the Wix APIs until the task is completed.', '**Exception — creating a new Wix site/website:** For a normal creation request — and only then — skip WixREADME and the docs search, and route straight to the Wix site-creation tools available to you; their descriptions carry the routing rules. Everything else starts with WixREADME as usual.', "If the user explicitly asks for a headless site, Wix Classic Editor site, or manual account/API-based site creation, call CreateWixBusinessGuide right away — these don't need the site's purpose first.", "Never default to AI or search templates unless the user explicitly requests it. When the user named no creation method - let the user make that choice as the site-creation tools' descriptions direct. Never route normal site creation through ManageWixSite, CallWixSiteAPI, or ExecuteWixAPI.");
     }
-    lines.push(`${exception}If the user asks to list, show, or find their Wix sites, ${includeReadme ? 'skip WixREADME and ' : ''}call ListWixSites directly.`, `${exception}If the user wants to upload local or attached image files to a Wix site, skip ${includeReadme ? 'WixREADME and ' : ''}all docs/schema/API flows — call UploadImageToWixSite directly. Do NOT use ExecuteWixAPI, SearchWixAPISpec, or any Media Manager REST API for image uploads.`);
+    lines.push(`${exception}If the user asks to list, show, or find their Wix sites, ${includeReadme ? 'skip WixREADME and ' : ''}call ListWixSites directly.`);
+    if (includeImageUploadGuidance) {
+        lines.push(`${exception}If the user wants to upload local or attached image files to a Wix site, skip ${includeReadme ? 'WixREADME and ' : ''}all docs/schema/API flows — call UploadImageToWixSite directly. Do NOT use ExecuteWixAPI, SearchWixAPISpec, or any Media Manager REST API for image uploads.`);
+    }
     if (includeReadme) {
         lines.push('If the WixREADME tool is not available to you, you should use the other flows as described without using the WixREADME tool until the task is completed.');
     }
@@ -34,9 +37,9 @@ function buildSystemReminderFlows(includeReadme) {
     lines.push(...DISCOVERY_FLOWS);
     return lines.join('\n');
 }
-export const SYSTEM_REMINDER_GUIDELINES = buildSystemReminderGuidelines(true);
-export function buildSystemReminder(includeReadme) {
-    const guidelines = buildSystemReminderGuidelines(includeReadme);
+export const SYSTEM_REMINDER_GUIDELINES = buildSystemReminderGuidelines(true, true);
+export function buildSystemReminder(includeReadme, includeImageUploadGuidance = true) {
+    const guidelines = buildSystemReminderGuidelines(includeReadme, includeImageUploadGuidance);
     const flows = buildSystemReminderFlows(includeReadme);
     return dedent `
     <agent-mandatory-instructions>
@@ -254,8 +257,8 @@ export const executeWixApiDescription = dedent `
 
   ${EXECUTE_WIX_API_MULTI_SITE_EXAMPLE}
 `;
-export function buildToolDescriptions(includeReadme) {
-    const reminder = buildSystemReminder(includeReadme);
+export function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true) {
+    const reminder = buildSystemReminder(includeReadme, includeImageUploadGuidance);
     return {
         WixREADME: dedent `
     # Tool: WixREADME
@@ -306,6 +309,7 @@ export function buildToolDescriptions(includeReadme) {
     **Prefer this tool over CallWixSiteAPI for listing sites.** Call this tool directly — it already knows the correct API and handles everything needed. Only fall back to CallWixSiteAPI if the user needs advanced filtering or specific site details beyond what this tool provides.
     ${reminder}
   `,
+        get_profile: "Returns the authenticated user's email address",
         GetSiteContext: dedent `
     Fetches deep context for a specific Wix site and returns it as structured markdown.
 

package/build/dts/index.d.ts

@@ -5,6 +5,7 @@ export { addApiCallTool, ToolHintsConfig } from './api-call/index.js';
 export { handleWixAPIResponse } from './tool-utils.js';
 export { addDocsResources } from './resources/docs.js';
 export { addSupportTool } from './support/index.js';
+export { addGetProfileTool } from './account-tools/get-profile-tool.js';
 export { addCreateSiteWidgetTool, addEditSiteWidgetTool, addPullSiteJobTool, addClaimSiteTool, addSiteCreationWidgetTools, addWixSiteCreationTool, addSearchSiteTemplatesTool, addCreateSiteFromTemplateTool, type SiteWidgetToolOptions } from './site-widget-tools/index.js';
 export * from './wixel/index.js';
 export { addImportClaudeDesignTool, type ImportClaudeDesignToolOptions } from './import-claude-design-tool/index.js';

package/build/dts/index.js

@@ -5,6 +5,7 @@ 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';
+export { addGetProfileTool } from './account-tools/get-profile-tool.js';
 export { addCreateSiteWidgetTool, addEditSiteWidgetTool, addPullSiteJobTool, addClaimSiteTool, addSiteCreationWidgetTools, addWixSiteCreationTool, addSearchSiteTemplatesTool, addCreateSiteFromTemplateTool } from './site-widget-tools/index.js';
 export * from './wixel/index.js';
 export { addImportClaudeDesignTool } from './import-claude-design-tool/index.js';

package/build/dts/toolkit-entry.d.cts

@@ -289,6 +289,8 @@ export interface WixToolkitOptions {
 	 * MCP server's text. Only affects description text — never the tool set itself.
 	 */
 	includeReadmeMentions?: boolean;
+	/** Keep image-upload routing guidance in tool descriptions. Defaults to `false`. */
+	includeImageUploadGuidance?: boolean;
 }
 /**
  * Create a WixToolkit that provides pre-wired tool objects for in-process use.

package/build/dts/toolkit-entry.d.ts

@@ -289,6 +289,8 @@ export interface WixToolkitOptions {
 	 * MCP server's text. Only affects description text — never the tool set itself.
 	 */
 	includeReadmeMentions?: boolean;
+	/** Keep image-upload routing guidance in tool descriptions. Defaults to `false`. */
+	includeImageUploadGuidance?: boolean;
 }
 /**
  * Create a WixToolkit that provides pre-wired tool objects for in-process use.

package/build/dts/toolkit.d.ts

@@ -151,6 +151,8 @@ export interface WixToolkitOptions {
      * MCP server's text. Only affects description text — never the tool set itself.
      */
     includeReadmeMentions?: boolean;
+    /** Keep image-upload routing guidance in tool descriptions. Defaults to `false`. */
+    includeImageUploadGuidance?: boolean;
 }
 export { extractText, formatToolResultAdditionalFields };
 /**

package/build/dts/toolkit.js

@@ -148,14 +148,13 @@ export { extractText, formatToolResultAdditionalFields };
  * schema manipulation (defaults) internally.
  */
 export function createWixToolkit(options) {
-    const { auth, docs, api, defaults = {}, exclude = [], clientName, hooks, conversationId, includeReadmeMentions = false } = options;
+    const { auth, docs, api, defaults = {}, exclude = [], clientName, hooks, conversationId, includeReadmeMentions = false, includeImageUploadGuidance = false } = options;
     const authStrategy = normalizeAuth(auth);
     const executeWixApiRequested = isExecuteWixApiRequested(api);
-    // Descriptions with WixREADME mentions removed, fed through the toolDescriptions
-    // override path. WixREADME is left out so its own description keeps its default text.
-    let descriptionsWithoutReadme;
+    // Apply both description flags consistently. WixREADME is left out when
+    // mentions are disabled so its own description keeps its default text.
+    const descriptionsWithoutReadme = buildToolDescriptions(includeReadmeMentions, includeImageUploadGuidance);
     if (!includeReadmeMentions) {
-        descriptionsWithoutReadme = buildToolDescriptions(false);
         delete descriptionsWithoutReadme.WixREADME;
     }
     const sessionId = uuidv4();
@@ -177,9 +176,10 @@ export function createWixToolkit(options) {
             authStrategy,
             dynamicContextEnabled: true,
             // README-free defaults first so consumer overrides still win.
-            toolDescriptions: descriptionsWithoutReadme
-                ? { ...descriptionsWithoutReadme, ...docsOptions.toolDescriptions }
-                : docsOptions.toolDescriptions
+            toolDescriptions: {
+                ...descriptionsWithoutReadme,
+                ...docsOptions.toolDescriptions
+            }
         });
     }
     else {
@@ -187,24 +187,18 @@ export function createWixToolkit(options) {
         addDocsTools(server, undefined, {
             authStrategy,
             dynamicContextEnabled: true,
-            ...(descriptionsWithoutReadme
-                ? { toolDescriptions: descriptionsWithoutReadme }
-                : {})
+            toolDescriptions: descriptionsWithoutReadme
         });
     }
     // Register API tools
     if (api) {
         const { tools: apiTools, disableTools, enableTools, toolDescriptions, toolHints, maxResponseSize, codeModeBaseUrl = 'https://mcp.wix.com' } = api;
         // Precedence (low → high): README-free defaults, code-mode variant, consumer overrides.
-        const effectiveToolDescriptions = includeReadmeMentions
-            ? executeWixApiRequested
-                ? { ...executeCodeModeToolDescriptions, ...toolDescriptions }
-                : toolDescriptions
-            : {
-                ...descriptionsWithoutReadme,
-                ...(executeWixApiRequested ? executeCodeModeToolDescriptions : {}),
-                ...toolDescriptions
-            };
+        const effectiveToolDescriptions = {
+            ...descriptionsWithoutReadme,
+            ...(executeWixApiRequested ? executeCodeModeToolDescriptions : {}),
+            ...toolDescriptions
+        };
         addApiCallTool(server, authStrategy, apiTools, disableTools, enableTools, effectiveToolDescriptions, toolHints, maxResponseSize);
         const requestedTools = new Set([
             ...(apiTools ?? []),