@wix/mcp 1.0.78 → 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.
 
@@ -18200,7 +18214,27 @@ function buildToolDescriptions(includeReadme) {
 
     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.
+    Top-level verticals and their subcategories. This is a shallow orientation snapshot, NOT the full tree: every subcategory below contains many more resources, and each resource its methods — none of them listed here. Filter lightIndex by menuPath for the complete live tree:
+    wix-apis
+    ├── account-level
+    │   └── accounts, ai-credits, b2b-site-management, domains, enterprise, resellers, sites, studio-workspace, user-management
+    ├── app-management
+    │   └── app-billing, app-extensions, app-installations, app-instance, app-permissions, app-tools, bi-event, companion-apps, embedded-scripts, market-listing, oauth-2, site-plugins
+    ├── assets
+    │   └── media, pro-gallery, rich-content
+    ├── business-management
+    │   └── ai-site-chat, analytics, app-installation, async-job, automations, branches, calendar, captcha, cookie-consent-policy, custom-embeds, dashboard, data-extension-schema, faq-app, functions, get-paid, google-business-profile, headless, locations, marketing, multilingual, notifications, online-programs, payments, secrets, seo, site-properties, site-search, site-urls, tags
+    ├── business-solutions
+    │   └── benefit-programs, blog, bookings, cms, coupons, donations, e-commerce, events, forum, gift-cards, meetings, portfolio, pricing-plans, restaurants, stores, suppliers-hub
+    ├── crm
+    │   └── communication, community, crm, forms, loyalty-program, members-contacts
+    ├── mobile
+    │   └── containers-app
+    ├── site
+    │   └── accessibility, viewer
+    └── tools
+        └── dynamic-site-context, semantic-search
+    (each leaf above expands into resources → methods; explore via lightIndex, e.g. lightIndex.filter(r => r.menuPath[1] === "e-commerce"))
 
     Important schema guidance:
     - For ExecuteWixAPI, ALWAYS use \`method.publicUrl\`. It is the complete, executable \`https://www.wixapis.com/...\` URL for that method. When \`publicUrl\` is present, never build the execution URL by hand and never expose any other field as "the endpoint".
@@ -21587,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();
@@ -21610,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) {
@@ -21629,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/code-mode/index.d.ts

@@ -19,10 +19,11 @@ export interface CodeModeOptions {
 export declare const EXECUTE_TOOL_NAME = "ExecuteWixAPI";
 export declare function addCodeModeTools(server: WixMcpServer, options: CodeModeOptions): Promise<void>;
 /**
- * Sync registration of SearchWixAPISpec without the optional
- * fetchCategoryTree description enrichment. Use this from sync entry points
- * such as createWixToolkit; use addCodeModeTools when you can await and want
- * the description enriched with the live top-level vertical tree.
+ * Register SearchWixAPISpec. The description must stay a byte-stable
+ * constant: tool descriptions sit at the head of consumers' LLM prompt-cache
+ * prefix, so any variance invalidates their entire cache. The verticals
+ * snapshot lives in default-config.ts; agents see the live tree via
+ * lightIndex.
  */
 export declare function addSearchCodeModeTool(server: WixMcpServer, options: CodeModeOptions): void;
 export declare function addExecuteCodeModeTool(server: WixMcpServer, options: CodeModeOptions): void;

package/build/dts/code-mode/index.js

@@ -10,9 +10,7 @@ const SEARCH_TOOL_NAME = 'SearchWixAPISpec';
 export const EXECUTE_TOOL_NAME = 'ExecuteWixAPI';
 export async function addCodeModeTools(server, options) {
     const { codeModeBaseUrl, authStrategy, disableTools = [], toolDescriptions, maxResponseSize } = options;
-    if (!disableTools.includes(SEARCH_TOOL_NAME)) {
-        await addSearchTool(server, codeModeBaseUrl, disableTools, toolDescriptions, maxResponseSize, authStrategy);
-    }
+    addSearchCodeModeTool(server, options);
     if (!disableTools.includes(EXECUTE_TOOL_NAME) && authStrategy) {
         addExecuteCodeModeTool(server, {
             codeModeBaseUrl,
@@ -24,10 +22,11 @@ export async function addCodeModeTools(server, options) {
     }
 }
 /**
- * Sync registration of SearchWixAPISpec without the optional
- * fetchCategoryTree description enrichment. Use this from sync entry points
- * such as createWixToolkit; use addCodeModeTools when you can await and want
- * the description enriched with the live top-level vertical tree.
+ * Register SearchWixAPISpec. The description must stay a byte-stable
+ * constant: tool descriptions sit at the head of consumers' LLM prompt-cache
+ * prefix, so any variance invalidates their entire cache. The verticals
+ * snapshot lives in default-config.ts; agents see the live tree via
+ * lightIndex.
  */
 export function addSearchCodeModeTool(server, options) {
     const { codeModeBaseUrl, authStrategy, disableTools = [], toolDescriptions, maxResponseSize } = options;
@@ -51,67 +50,6 @@ export function addExecuteCodeModeTool(server, options) {
         maxResponseSize
     });
 }
-const CATEGORY_TREE_CODE = `async function() {
-  const tree = {};
-  lightIndex.forEach(r => {
-    const top = r.menuPath[0];
-    const sub = r.menuPath[1];
-    if (!tree[top]) tree[top] = {};
-    if (sub) { if (!tree[top][sub]) tree[top][sub] = 0; tree[top][sub]++; }
-  });
-  return Object.entries(tree).map(([cat, subs]) => {
-    const total = Object.values(subs).reduce((a, b) => a + b, 0);
-    return cat + ' [' + total + ' resources]: ' + Object.keys(subs).join(', ');
-  }).join('\\n');
-}`;
-async function fetchCategoryTree(codeModeBaseUrl, authorization) {
-    // Precomputed by the server's spec-sync cron. The legacy path below ran
-    // CATEGORY_TREE_CODE in a Dynamic Worker on every tool registration —
-    // one billable isolate per MCP session; keep it only as a fallback for
-    // servers that predate the category-tree endpoint.
-    try {
-        const resp = await fetch(`${codeModeBaseUrl}/api/code-mode/category-tree`, {
-            headers: authorization ? { Authorization: authorization } : {}
-        });
-        if (resp.ok) {
-            const data = (await resp.json());
-            if (typeof data.result === 'string')
-                return data.result;
-        }
-    }
-    catch {
-        // fall through to the search-based fallback
-    }
-    return fetchCategoryTreeViaSearch(`${codeModeBaseUrl}/api/code-mode/search`, authorization);
-}
-async function fetchCategoryTreeViaSearch(searchUrl, authorization) {
-    try {
-        const resp = await fetch(searchUrl, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                ...(authorization ? { Authorization: authorization } : {})
-            },
-            body: JSON.stringify({ code: CATEGORY_TREE_CODE })
-        });
-        if (!resp.ok)
-            return null;
-        const data = (await resp.json());
-        return typeof data.result === 'string' ? data.result : null;
-    }
-    catch {
-        return null;
-    }
-}
-async function addSearchTool(server, codeModeBaseUrl, _disableTools, toolDescriptions, maxResponseSize, authStrategy) {
-    let description = toolDescriptions?.[SEARCH_TOOL_NAME] ??
-        defaultToolDescriptions.SearchWixAPISpec;
-    const categoryTree = await fetchCategoryTree(codeModeBaseUrl, await resolveLoopbackAuthorization(authStrategy));
-    if (categoryTree) {
-        description = description.replace(/Top-level verticals:.*$/m, categoryTree);
-    }
-    registerSearchTool(server, codeModeBaseUrl, description, maxResponseSize, authStrategy);
-}
 const SEARCH_MAX_RESPONSE_CHARS = 64_000;
 /**
  * Search needs no auth of its own; without a header the call is bucketed by the

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.
 
@@ -542,7 +546,27 @@ export function buildToolDescriptions(includeReadme) {
 
     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.
+    Top-level verticals and their subcategories. This is a shallow orientation snapshot, NOT the full tree: every subcategory below contains many more resources, and each resource its methods — none of them listed here. Filter lightIndex by menuPath for the complete live tree:
+    wix-apis
+    ├── account-level
+    │   └── accounts, ai-credits, b2b-site-management, domains, enterprise, resellers, sites, studio-workspace, user-management
+    ├── app-management
+    │   └── app-billing, app-extensions, app-installations, app-instance, app-permissions, app-tools, bi-event, companion-apps, embedded-scripts, market-listing, oauth-2, site-plugins
+    ├── assets
+    │   └── media, pro-gallery, rich-content
+    ├── business-management
+    │   └── ai-site-chat, analytics, app-installation, async-job, automations, branches, calendar, captcha, cookie-consent-policy, custom-embeds, dashboard, data-extension-schema, faq-app, functions, get-paid, google-business-profile, headless, locations, marketing, multilingual, notifications, online-programs, payments, secrets, seo, site-properties, site-search, site-urls, tags
+    ├── business-solutions
+    │   └── benefit-programs, blog, bookings, cms, coupons, donations, e-commerce, events, forum, gift-cards, meetings, portfolio, pricing-plans, restaurants, stores, suppliers-hub
+    ├── crm
+    │   └── communication, community, crm, forms, loyalty-program, members-contacts
+    ├── mobile
+    │   └── containers-app
+    ├── site
+    │   └── accessibility, viewer
+    └── tools
+        └── dynamic-site-context, semantic-search
+    (each leaf above expands into resources → methods; explore via lightIndex, e.g. lightIndex.filter(r => r.menuPath[1] === "e-commerce"))
 
     Important schema guidance:
     - For ExecuteWixAPI, ALWAYS use \`method.publicUrl\`. It is the complete, executable \`https://www.wixapis.com/...\` URL for that method. When \`publicUrl\` is present, never build the execution URL by hand and never expose any other field as "the endpoint".

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 ?? []),