@wix/mcp 1.0.81 → 1.0.82

package/build/bin-standalone.js

@@ -71652,6 +71652,8 @@ var SITE_CREATION_COPY = {
 var SITE_GUIDANCE = dedent_default`
   A new-site request has two things to settle: what the site is for, and how to build it. The how is AI generation vs. starting from a template, so naming templates, a template id or Wix Studio (Wix Studio is also the template side) already settles it.
 
+  One case skips all of this: the user ALREADY HAS the finished site as files — hand-written HTML/CSS/JS, a zip, or the export of an AI builder. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool. Send them to https://www.wix.com/headless/drop?utm_campaign=mcp — they drag the files in and get a live Wix-hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
+
   Settle what the site is for first: its purpose, topic, business type, audience, or main visitor action. Naming a method is not a description of the site, and neither is the business or industry on its own.
   If you can't tell yet, ask the preferred question below and nothing else — one question, no creation-method question in the same reply, and no internal tool names.
   Once the purpose is clear, unless the user already named a method, ${SITE_CREATION_COPY.unstatedMethod.nonWidget}. A method they named is settled — never re-open it. Never default to AI or to templates, and never ask the user to choose between Harmony and Wix Studio; infer that from their words.
@@ -71984,7 +71986,8 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     After calling, you MUST speak the message provided in the tool result to the user as your reply — do not stay silent and do not replace it with a one-line pointer to the widget. Write out ALL of it, word for word: its opening line (the "Ready to set up your … site?" question INCLUDING "Choose your path in the widget above:"), BOTH of its option bullets, and its "Next up:" line, each on its own line and in that order. Do not summarize, shorten, drop any line, invent your own opener, rename the options, or add an intro or outro.
   `,
     "import-claude-design-from-url": dedent_default`
-    Import a design into Wix from a publicly fetchable URL. The file is a self-contained HTML bundle with all images, fonts, and styles inlined. Creates a live Wix-hosted site and returns its URL.
+    Import a design created in Claude's design tool into Wix. Takes the signed claudeusercontent.com URL Claude Design produces for its self-contained HTML bundle (all images, fonts, and styles inlined); any other host is rejected. Creates a live Wix-hosted site and returns its URL.
+    NOT for site files the user provides themselves (their own HTML/CSS/JS, a zip, another builder's export) — for those, don't call this tool: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp, where they upload the files and get a live hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -72385,6 +72388,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     CreateWixBusinessGuide: dedent_default`
     Provides comprehensive documentation for creating a new Wix business (site, app, etc.).
     Call this ONLY when the user explicitly asks for a headless site, a Wix Classic Editor site, or manual/advanced account/API-based site creation — these don't need the site's purpose first. For normal site-creation ${SITE_CREATION_COPY.normalCreationRoute.nonWidget}; for a specific template id, call \`CreateSiteFromTemplate\`.
+    Exception, even when the user says "headless": if they ALREADY HAVE the finished site as files (their own HTML/CSS/JS, a zip, an AI-builder export) and want those files hosted, don't call this tool — send them to https://www.wix.com/headless/drop?utm_campaign=mcp to upload the files and get a live hosted site (give that URL exactly, keeping the utm_campaign=mcp parameter). This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -72813,7 +72817,16 @@ var known_apps_default = {
   "1480c568-5cbd-9392-5604-1148f5faffa0": "Promote SEO",
   "ff5d6eb1-65e4-4f9a-8b14-64d34c12cc2e": "Wix Rentals"
 };
-var DYNAMIC_CONTEXT_URL = "https://dev.wix.com/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_PATH = "/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_URL = `https://dev.wix.com${DYNAMIC_CONTEXT_PATH}`;
+var isWixHost = (hostname3) => hostname3 === "wix.com" || hostname3.endsWith(".wix.com");
+var dynamicContextUrl = () => {
+  if (typeof window === "undefined") {
+    return DYNAMIC_CONTEXT_URL;
+  }
+  const hostname3 = window.location?.hostname;
+  return typeof hostname3 === "string" && isWixHost(hostname3) ? DYNAMIC_CONTEXT_PATH : DYNAMIC_CONTEXT_URL;
+};
 var COUNT_SITES_URL = "https://www.wixapis.com/site-list/v2/sites/count";
 var MAX_SITES_FOR_DYNAMIC_CONTEXT = 10;
 var DYNAMIC_CONTEXT_PETRI_OVERRIDE = "shouldReturnDynamicContextInMCP#B";
@@ -72865,7 +72878,7 @@ async function getDynamicContext(auth, httpClient, filter, options) {
     if (filter?.siteId) body.site_id = filter.siteId;
     else if (filter?.siteName) body.site_name = filter.siteName;
     const dynamicContextPromise = httpClient.request({
-      url: DYNAMIC_CONTEXT_URL,
+      url: dynamicContextUrl(),
       method: "POST",
       headers: {
         ...accountHeaders,
@@ -85356,6 +85369,11 @@ var WixMcpServer = class extends McpServer {
   isMcpAppsInMcpEnabled() {
     return this.mcpAppsInMcpEnabled;
   }
+  /** Microsoft 365 Copilot ("sydney" at runtime) or Copilot Cowork ("copilot"). */
+  isMicrosoftCopilotClient() {
+    const clientName = this.getClientName?.()?.toLowerCase() ?? "";
+    return clientName.includes("sydney") || clientName.includes("copilot");
+  }
   shouldRenderMcpApps() {
     const clientName = this.getClientName?.()?.toLowerCase();
     const isOpenAi = clientName?.includes("openai") ?? false;

package/build/cjs/index.cjs

@@ -36094,6 +36094,11 @@ var WixMcpServer = class extends McpServer {
   isMcpAppsInMcpEnabled() {
     return this.mcpAppsInMcpEnabled;
   }
+  /** Microsoft 365 Copilot ("sydney" at runtime) or Copilot Cowork ("copilot"). */
+  isMicrosoftCopilotClient() {
+    const clientName = this.getClientName?.()?.toLowerCase() ?? "";
+    return clientName.includes("sydney") || clientName.includes("copilot");
+  }
   shouldRenderMcpApps() {
     const clientName = this.getClientName?.()?.toLowerCase();
     const isOpenAi = clientName?.includes("openai") ?? false;
@@ -37221,6 +37226,8 @@ var SITE_CREATION_COPY = {
 var SITE_GUIDANCE = dedent_default`
   A new-site request has two things to settle: what the site is for, and how to build it. The how is AI generation vs. starting from a template, so naming templates, a template id or Wix Studio (Wix Studio is also the template side) already settles it.
 
+  One case skips all of this: the user ALREADY HAS the finished site as files — hand-written HTML/CSS/JS, a zip, or the export of an AI builder. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool. Send them to https://www.wix.com/headless/drop?utm_campaign=mcp — they drag the files in and get a live Wix-hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
+
   Settle what the site is for first: its purpose, topic, business type, audience, or main visitor action. Naming a method is not a description of the site, and neither is the business or industry on its own.
   If you can't tell yet, ask the preferred question below and nothing else — one question, no creation-method question in the same reply, and no internal tool names.
   Once the purpose is clear, unless the user already named a method, ${SITE_CREATION_COPY.unstatedMethod.nonWidget}. A method they named is settled — never re-open it. Never default to AI or to templates, and never ask the user to choose between Harmony and Wix Studio; infer that from their words.
@@ -37553,7 +37560,8 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     After calling, you MUST speak the message provided in the tool result to the user as your reply — do not stay silent and do not replace it with a one-line pointer to the widget. Write out ALL of it, word for word: its opening line (the "Ready to set up your … site?" question INCLUDING "Choose your path in the widget above:"), BOTH of its option bullets, and its "Next up:" line, each on its own line and in that order. Do not summarize, shorten, drop any line, invent your own opener, rename the options, or add an intro or outro.
   `,
     "import-claude-design-from-url": dedent_default`
-    Import a design into Wix from a publicly fetchable URL. The file is a self-contained HTML bundle with all images, fonts, and styles inlined. Creates a live Wix-hosted site and returns its URL.
+    Import a design created in Claude's design tool into Wix. Takes the signed claudeusercontent.com URL Claude Design produces for its self-contained HTML bundle (all images, fonts, and styles inlined); any other host is rejected. Creates a live Wix-hosted site and returns its URL.
+    NOT for site files the user provides themselves (their own HTML/CSS/JS, a zip, another builder's export) — for those, don't call this tool: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp, where they upload the files and get a live hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -37954,6 +37962,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     CreateWixBusinessGuide: dedent_default`
     Provides comprehensive documentation for creating a new Wix business (site, app, etc.).
     Call this ONLY when the user explicitly asks for a headless site, a Wix Classic Editor site, or manual/advanced account/API-based site creation — these don't need the site's purpose first. For normal site-creation ${SITE_CREATION_COPY.normalCreationRoute.nonWidget}; for a specific template id, call \`CreateSiteFromTemplate\`.
+    Exception, even when the user says "headless": if they ALREADY HAVE the finished site as files (their own HTML/CSS/JS, a zip, an AI-builder export) and want those files hosted, don't call this tool — send them to https://www.wix.com/headless/drop?utm_campaign=mcp to upload the files and get a live hosted site (give that URL exactly, keeping the utm_campaign=mcp parameter). This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -38419,7 +38428,16 @@ var known_apps_default = {
   "1480c568-5cbd-9392-5604-1148f5faffa0": "Promote SEO",
   "ff5d6eb1-65e4-4f9a-8b14-64d34c12cc2e": "Wix Rentals"
 };
-var DYNAMIC_CONTEXT_URL = "https://dev.wix.com/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_PATH = "/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_URL = `https://dev.wix.com${DYNAMIC_CONTEXT_PATH}`;
+var isWixHost = (hostname2) => hostname2 === "wix.com" || hostname2.endsWith(".wix.com");
+var dynamicContextUrl = () => {
+  if (typeof window === "undefined") {
+    return DYNAMIC_CONTEXT_URL;
+  }
+  const hostname2 = window.location?.hostname;
+  return typeof hostname2 === "string" && isWixHost(hostname2) ? DYNAMIC_CONTEXT_PATH : DYNAMIC_CONTEXT_URL;
+};
 var COUNT_SITES_URL = "https://www.wixapis.com/site-list/v2/sites/count";
 var MAX_SITES_FOR_DYNAMIC_CONTEXT = 10;
 var DYNAMIC_CONTEXT_PETRI_OVERRIDE = "shouldReturnDynamicContextInMCP#B";
@@ -38471,7 +38489,7 @@ async function getDynamicContext(auth, httpClient6, filter, options) {
     if (filter?.siteId) body.site_id = filter.siteId;
     else if (filter?.siteName) body.site_name = filter.siteName;
     const dynamicContextPromise = httpClient6.request({
-      url: DYNAMIC_CONTEXT_URL,
+      url: dynamicContextUrl(),
       method: "POST",
       headers: {
         ...accountHeaders,
@@ -40932,9 +40950,18 @@ var SITE_CREATION_CUSTOM_ACTIONS_GUIDANCE = `2\u20133 specific, high-value setup
 * Events / Weddings / Real Estate: "add event schedules, display listings, and manage RSVP forms"
 * General / Unspecified: "${SITE_CREATION_DEFAULT_ACTIONS}"
 If none of these patterns fit the site, infer 2\u20133 actions that suit what that kind of business would manage on its site.`;
-function buildSiteCreationSelectorMessage(siteType, customActions) {
+function buildSiteCreationSelectorMessage(siteType, customActions, { plain = false } = {}) {
   const type = (siteType ?? "").trim() || "new";
   const actions = (customActions ?? "").trim() || SITE_CREATION_DEFAULT_ACTIONS;
+  const body = `Ready to set up your ${type} site? Choose your path in the widget above:
+
+* **Build with AI** for a custom, tailor-made layout
+* **Pick a template** to start with a pre-designed layout
+
+**Next up:** Once your site is created, you can customize it in Wix or ask me to ${actions}\u2014right here in the chat!`;
+  if (plain) {
+    return body;
+  }
   return `You are the assistant replying to the user \u2014 say this message out loud in chat (do NOT stay silent, and do NOT just point at the widget). Your reply is only complete if it includes ALL of the following, word for word, each on its own line and in this order:
 1. "Ready to set up your ${type} site? Choose your path in the widget above:" \u2014 keep the "Choose your path in the widget above:" part.
 2. "* **Build with AI** for a custom, tailor-made layout"
@@ -40943,12 +40970,7 @@ function buildSiteCreationSelectorMessage(siteType, customActions) {
 
 Copy those four lines as written; do not summarize, shorten, reorder, or reword any of them. Here is the full message to send:
 
-Ready to set up your ${type} site? Choose your path in the widget above:
-
-* **Build with AI** for a custom, tailor-made layout
-* **Pick a template** to start with a pre-designed layout
-
-**Next up:** Once your site is created, you can customize it in Wix or ask me to ${actions}\u2014right here in the chat!`;
+${body}`;
 }
 var OPENAI_WIDGET_MIME_TYPE = "text/html+skybridge";
 var SITE_WIDGET_MCP_CSP = {
@@ -47909,7 +47931,7 @@ function addCreateSiteWidgetTool(server, authStrategy, options) {
           `The prompt to build the site. If not provided, the user will be asked to provide a prompt.`
         ),
         suggestedSiteName: external_exports.string().optional().describe(
-          "Suggested site name to use for the site based on the site prompt."
+          "You must provide this on every call, including updates to an existing job, in English. A short name for the site: the business name the user gave, or one you derive from the site prompt."
         )
       },
       _meta: toolDefinitionMeta,
@@ -48066,6 +48088,10 @@ async function buildHarmonySite({
 
 // src/site-widget-tools/suggested-domain-tool/index.ts
 var WIX_APIS_BASE_URL3 = "https://www.wixapis.com";
+var DEFAULT_SITE_NAME = /^my site(\s+\d+)?$/i;
+function isDefaultSiteName(siteName) {
+  return DEFAULT_SITE_NAME.test(siteName.trim());
+}
 async function fetchSiteDisplayName(siteAuthorization, siteId) {
   const response = await fetch(
     `${WIX_APIS_BASE_URL3}/site-properties/v4/properties`,
@@ -48090,7 +48116,15 @@ function addSuggestedDomainTool(server, authStrategy) {
     GET_SUGGESTED_DOMAINS_TOOL_NAME,
     {
       title: "Get Suggested Domains",
-      description: 'Suggest available domain names. Provide either a free-text query (e.g. "pancakes business", "modern yoga studio") OR a siteId to auto-suggest based on the site name. At least one of query or siteId is required.',
+      description: dedent_default`
+        Suggests available domain names for a business, brand, or Wix site.
+
+        Call this when the user asks for domain name ideas, wants to know which domains are available, or wants a domain for a new or existing site.
+
+        Provide either a free-text \`query\` (the user's own words, e.g. "pancakes business", "modern yoga studio") OR a \`siteId\` to base the suggestions on that site's name. At least one of them is required.
+
+        Present the returned domains to the user as a short list. This tool only suggests domains — it does not purchase or connect them.
+      `,
       inputSchema: {
         query: zod_default.string().optional().describe(
           "Free-text keywords, business idea, or brand concept to base suggestions on. Use the user's own words."
@@ -48110,10 +48144,11 @@ function addSuggestedDomainTool(server, authStrategy) {
       },
       _meta: {
         securitySchemes: [{ type: "oauth2", scopes: ["offline_access"] }],
-        ui: { visibility: ["app"] },
+        // Model-visible so hosts (e.g. Microsoft 365 Copilot) can call it directly and show it
+        // in their debug info; 'app' keeps it callable from the site-builder widget.
+        ui: { visibility: ["app", "model"] },
         "openai/toolInvocation/invoking": "Fetching suggested domains",
-        "openai/toolInvocation/invoked": "Suggested domains retrieved",
-        "openai/visibility": "private"
+        "openai/toolInvocation/invoked": "Suggested domains retrieved"
       }
     },
     async (args, { panorama }) => {
@@ -48161,7 +48196,9 @@ function addSuggestedDomainTool(server, authStrategy) {
                 structuredContent: { domains: [] }
               };
             }
-            resolvedQuery = siteName;
+            if (!isDefaultSiteName(siteName) || !resolvedQuery) {
+              resolvedQuery = siteName;
+            }
           } catch (error2) {
             panorama.logger().error(
               `[getSuggestedDomains] Error fetching site name for siteId: ${siteId}`,
@@ -48619,7 +48656,8 @@ function addWixSiteCreationTool(server, _authStrategy, options) {
       };
       const message = buildSiteCreationSelectorMessage(
         args.query,
-        args.customActions
+        args.customActions,
+        { plain: server.isMicrosoftCopilotClient() }
       );
       return withJsonContent({
         content: [
@@ -51403,10 +51441,14 @@ function addImportClaudeDesignTool(server, authStrategy, options) {
       try {
         designUrl = new URL(args.url);
       } catch {
-        return errorResult("Invalid design URL.");
+        return errorResult(
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For site files the user provided themselves, do not retry: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site."
+        );
       }
       if (designUrl.protocol !== "https:" || !designUrl.hostname.endsWith(CLAUDE_USER_CONTENT_HOST_SUFFIX)) {
-        return errorResult("Invalid design URL.");
+        return errorResult(
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For site files the user provided themselves, do not retry: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site."
+        );
       }
       const accountHeaders = await authStrategy.getAccountAuthHeaders();
       const wixstroOptions = { baseUrl: wixstroBaseUrl, accountHeaders };

package/build/cjs/toolkit.cjs

@@ -17750,6 +17750,8 @@ var SITE_CREATION_COPY = {
 var SITE_GUIDANCE = dedent_default`
   A new-site request has two things to settle: what the site is for, and how to build it. The how is AI generation vs. starting from a template, so naming templates, a template id or Wix Studio (Wix Studio is also the template side) already settles it.
 
+  One case skips all of this: the user ALREADY HAS the finished site as files — hand-written HTML/CSS/JS, a zip, or the export of an AI builder. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool. Send them to https://www.wix.com/headless/drop?utm_campaign=mcp — they drag the files in and get a live Wix-hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
+
   Settle what the site is for first: its purpose, topic, business type, audience, or main visitor action. Naming a method is not a description of the site, and neither is the business or industry on its own.
   If you can't tell yet, ask the preferred question below and nothing else — one question, no creation-method question in the same reply, and no internal tool names.
   Once the purpose is clear, unless the user already named a method, ${SITE_CREATION_COPY.unstatedMethod.nonWidget}. A method they named is settled — never re-open it. Never default to AI or to templates, and never ask the user to choose between Harmony and Wix Studio; infer that from their words.
@@ -18082,7 +18084,8 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     After calling, you MUST speak the message provided in the tool result to the user as your reply — do not stay silent and do not replace it with a one-line pointer to the widget. Write out ALL of it, word for word: its opening line (the "Ready to set up your … site?" question INCLUDING "Choose your path in the widget above:"), BOTH of its option bullets, and its "Next up:" line, each on its own line and in that order. Do not summarize, shorten, drop any line, invent your own opener, rename the options, or add an intro or outro.
   `,
     "import-claude-design-from-url": dedent_default`
-    Import a design into Wix from a publicly fetchable URL. The file is a self-contained HTML bundle with all images, fonts, and styles inlined. Creates a live Wix-hosted site and returns its URL.
+    Import a design created in Claude's design tool into Wix. Takes the signed claudeusercontent.com URL Claude Design produces for its self-contained HTML bundle (all images, fonts, and styles inlined); any other host is rejected. Creates a live Wix-hosted site and returns its URL.
+    NOT for site files the user provides themselves (their own HTML/CSS/JS, a zip, another builder's export) — for those, don't call this tool: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp, where they upload the files and get a live hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -18483,6 +18486,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     CreateWixBusinessGuide: dedent_default`
     Provides comprehensive documentation for creating a new Wix business (site, app, etc.).
     Call this ONLY when the user explicitly asks for a headless site, a Wix Classic Editor site, or manual/advanced account/API-based site creation — these don't need the site's purpose first. For normal site-creation ${SITE_CREATION_COPY.normalCreationRoute.nonWidget}; for a specific template id, call \`CreateSiteFromTemplate\`.
+    Exception, even when the user says "headless": if they ALREADY HAVE the finished site as files (their own HTML/CSS/JS, a zip, an AI-builder export) and want those files hosted, don't call this tool — send them to https://www.wix.com/headless/drop?utm_campaign=mcp to upload the files and get a live hosted site (give that URL exactly, keeping the utm_campaign=mcp parameter). This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -18948,7 +18952,16 @@ var known_apps_default = {
   "1480c568-5cbd-9392-5604-1148f5faffa0": "Promote SEO",
   "ff5d6eb1-65e4-4f9a-8b14-64d34c12cc2e": "Wix Rentals"
 };
-var DYNAMIC_CONTEXT_URL = "https://dev.wix.com/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_PATH = "/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_URL = `https://dev.wix.com${DYNAMIC_CONTEXT_PATH}`;
+var isWixHost = (hostname) => hostname === "wix.com" || hostname.endsWith(".wix.com");
+var dynamicContextUrl = () => {
+  if (typeof window === "undefined") {
+    return DYNAMIC_CONTEXT_URL;
+  }
+  const hostname = window.location?.hostname;
+  return typeof hostname === "string" && isWixHost(hostname) ? DYNAMIC_CONTEXT_PATH : DYNAMIC_CONTEXT_URL;
+};
 var COUNT_SITES_URL = "https://www.wixapis.com/site-list/v2/sites/count";
 var MAX_SITES_FOR_DYNAMIC_CONTEXT = 10;
 var DYNAMIC_CONTEXT_PETRI_OVERRIDE = "shouldReturnDynamicContextInMCP#B";
@@ -19000,7 +19013,7 @@ async function getDynamicContext(auth, httpClient, filter, options) {
     if (filter?.siteId) body.site_id = filter.siteId;
     else if (filter?.siteName) body.site_name = filter.siteName;
     const dynamicContextPromise = httpClient.request({
-      url: DYNAMIC_CONTEXT_URL,
+      url: dynamicContextUrl(),
       method: "POST",
       headers: {
         ...accountHeaders,

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

@@ -80,6 +80,8 @@ export const SITE_CREATION_COPY = {
 const SITE_GUIDANCE = dedent `
   A new-site request has two things to settle: what the site is for, and how to build it. The how is AI generation vs. starting from a template, so naming templates, a template id or Wix Studio (Wix Studio is also the template side) already settles it.
 
+  One case skips all of this: the user ALREADY HAS the finished site as files — hand-written HTML/CSS/JS, a zip, or the export of an AI builder. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool. Send them to https://www.wix.com/headless/drop?utm_campaign=mcp — they drag the files in and get a live Wix-hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
+
   Settle what the site is for first: its purpose, topic, business type, audience, or main visitor action. Naming a method is not a description of the site, and neither is the business or industry on its own.
   If you can't tell yet, ask the preferred question below and nothing else — one question, no creation-method question in the same reply, and no internal tool names.
   Once the purpose is clear, unless the user already named a method, ${SITE_CREATION_COPY.unstatedMethod.nonWidget}. A method they named is settled — never re-open it. Never default to AI or to templates, and never ask the user to choose between Harmony and Wix Studio; infer that from their words.
@@ -412,7 +414,8 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
     After calling, you MUST speak the message provided in the tool result to the user as your reply — do not stay silent and do not replace it with a one-line pointer to the widget. Write out ALL of it, word for word: its opening line (the "Ready to set up your … site?" question INCLUDING "Choose your path in the widget above:"), BOTH of its option bullets, and its "Next up:" line, each on its own line and in that order. Do not summarize, shorten, drop any line, invent your own opener, rename the options, or add an intro or outro.
   `,
         'import-claude-design-from-url': dedent `
-    Import a design into Wix from a publicly fetchable URL. The file is a self-contained HTML bundle with all images, fonts, and styles inlined. Creates a live Wix-hosted site and returns its URL.
+    Import a design created in Claude's design tool into Wix. Takes the signed claudeusercontent.com URL Claude Design produces for its self-contained HTML bundle (all images, fonts, and styles inlined); any other host is rejected. Creates a live Wix-hosted site and returns its URL.
+    NOT for site files the user provides themselves (their own HTML/CSS/JS, a zip, another builder's export) — for those, don't call this tool: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp, where they upload the files and get a live hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
   `,
         RunWixCliCommand: dedent `
     Executes Wix CLI commands for Wix app development and management.
@@ -813,6 +816,7 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
         CreateWixBusinessGuide: dedent `
     Provides comprehensive documentation for creating a new Wix business (site, app, etc.).
     Call this ONLY when the user explicitly asks for a headless site, a Wix Classic Editor site, or manual/advanced account/API-based site creation — these don't need the site's purpose first. For normal site-creation ${SITE_CREATION_COPY.normalCreationRoute.nonWidget}; for a specific template id, call \`CreateSiteFromTemplate\`.
+    Exception, even when the user says "headless": if they ALREADY HAVE the finished site as files (their own HTML/CSS/JS, a zip, an AI-builder export) and want those files hosted, don't call this tool — send them to https://www.wix.com/headless/drop?utm_campaign=mcp to upload the files and get a live hosted site (give that URL exactly, keeping the utm_campaign=mcp parameter). This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 

package/build/dts/import-claude-design-tool/index.js

@@ -86,11 +86,11 @@ export function addImportClaudeDesignTool(server, authStrategy, options) {
             designUrl = new URL(args.url);
         }
         catch {
-            return errorResult('Invalid design URL.');
+            return errorResult('Invalid design URL — this tool only accepts the claudeusercontent.com URL produced by Claude Design. For site files the user provided themselves, do not retry: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site.');
         }
         if (designUrl.protocol !== 'https:' ||
             !designUrl.hostname.endsWith(CLAUDE_USER_CONTENT_HOST_SUFFIX)) {
-            return errorResult('Invalid design URL.');
+            return errorResult('Invalid design URL — this tool only accepts the claudeusercontent.com URL produced by Claude Design. For site files the user provided themselves, do not retry: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site.');
         }
         // Resolve the caller's account identity BEFORE the design fetch — the
         // design URL is single-use, so an unauthenticated caller must fail

package/build/dts/site-widget-tools/constants.d.ts

@@ -14,12 +14,19 @@ export declare const SITE_CREATION_DEFAULT_ACTIONS = "add products, set up booki
  */
 export declare const SITE_CREATION_CUSTOM_ACTIONS_GUIDANCE = "2\u20133 specific, high-value setup actions for the site's industry, written as a comma-separated phrase (it slots into \"\u2026ask me to ___ right here in the chat\"). Use the following domain patterns as guidance:\n* E-commerce / Retail: \"add products, set up payment methods, and organize collections\"\n* Restaurants / Food / Bakeries: \"add menu items, set up online ordering, and collect table reservations\"\n* Services / Fitness / Salons / Consultants: \"set up booking slots, add service pricing, and manage appointments\"\n* Creative / Portfolios / Photographers: \"upload project galleries, feature client reviews, and customize contact forms\"\n* Events / Weddings / Real Estate: \"add event schedules, display listings, and manage RSVP forms\"\n* General / Unspecified: \"add products, set up bookings, and adjust your content\"\nIf none of these patterns fit the site, infer 2\u20133 actions that suit what that kind of business would manage on its site.";
 /**
- * Builds the WixSiteCreation chooser reply. The message is fully composed here and wrapped in an
- * `<instructions>` preamble that tells the host model to display the body verbatim (keeping the
- * bullets and line breaks). The site type comes from `query`; the "Next up:" actions come from the
- * inferred `customActions`.
+ * Builds the WixSiteCreation chooser reply. The message is fully composed here and wrapped in a
+ * preamble that tells the host model to display the body verbatim (keeping the bullets and line
+ * breaks). The site type comes from `query`; the "Next up:" actions come from the inferred
+ * `customActions`.
+ *
+ * With `plain`, only the message itself is returned. Microsoft 365 Copilot's safety filter reads
+ * instructions inside a tool result ("you are the assistant…", "word for word…") as prompt
+ * injection and blocks the whole reply ("Sorry, it looks like I can't chat about this"); there the
+ * verbatim-reply instruction lives only in the tool description.
  */
-export declare function buildSiteCreationSelectorMessage(siteType?: string, customActions?: string): string;
+export declare function buildSiteCreationSelectorMessage(siteType?: string, customActions?: string, { plain }?: {
+    plain?: boolean;
+}): string;
 /** OpenAI/ChatGPT widget MIME type for Skybridge rendering */
 export declare const OPENAI_WIDGET_MIME_TYPE = "text/html+skybridge";
 /**

package/build/dts/site-widget-tools/constants.js

@@ -23,14 +23,28 @@ export const SITE_CREATION_CUSTOM_ACTIONS_GUIDANCE = `2–3 specific, high-value
 * General / Unspecified: "${SITE_CREATION_DEFAULT_ACTIONS}"
 If none of these patterns fit the site, infer 2–3 actions that suit what that kind of business would manage on its site.`;
 /**
- * Builds the WixSiteCreation chooser reply. The message is fully composed here and wrapped in an
- * `<instructions>` preamble that tells the host model to display the body verbatim (keeping the
- * bullets and line breaks). The site type comes from `query`; the "Next up:" actions come from the
- * inferred `customActions`.
+ * Builds the WixSiteCreation chooser reply. The message is fully composed here and wrapped in a
+ * preamble that tells the host model to display the body verbatim (keeping the bullets and line
+ * breaks). The site type comes from `query`; the "Next up:" actions come from the inferred
+ * `customActions`.
+ *
+ * With `plain`, only the message itself is returned. Microsoft 365 Copilot's safety filter reads
+ * instructions inside a tool result ("you are the assistant…", "word for word…") as prompt
+ * injection and blocks the whole reply ("Sorry, it looks like I can't chat about this"); there the
+ * verbatim-reply instruction lives only in the tool description.
  */
-export function buildSiteCreationSelectorMessage(siteType, customActions) {
+export function buildSiteCreationSelectorMessage(siteType, customActions, { plain = false } = {}) {
     const type = (siteType ?? '').trim() || 'new';
     const actions = (customActions ?? '').trim() || SITE_CREATION_DEFAULT_ACTIONS;
+    const body = `Ready to set up your ${type} site? Choose your path in the widget above:
+
+* **Build with AI** for a custom, tailor-made layout
+* **Pick a template** to start with a pre-designed layout
+
+**Next up:** Once your site is created, you can customize it in Wix or ask me to ${actions}—right here in the chat!`;
+    if (plain) {
+        return body;
+    }
     return `You are the assistant replying to the user — say this message out loud in chat (do NOT stay silent, and do NOT just point at the widget). Your reply is only complete if it includes ALL of the following, word for word, each on its own line and in this order:
 1. "Ready to set up your ${type} site? Choose your path in the widget above:" — keep the "Choose your path in the widget above:" part.
 2. "* **Build with AI** for a custom, tailor-made layout"
@@ -39,12 +53,7 @@ export function buildSiteCreationSelectorMessage(siteType, customActions) {
 
 Copy those four lines as written; do not summarize, shorten, reorder, or reword any of them. Here is the full message to send:
 
-Ready to set up your ${type} site? Choose your path in the widget above:
-
-* **Build with AI** for a custom, tailor-made layout
-* **Pick a template** to start with a pre-designed layout
-
-**Next up:** Once your site is created, you can customize it in Wix or ask me to ${actions}—right here in the chat!`;
+${body}`;
 }
 /** OpenAI/ChatGPT widget MIME type for Skybridge rendering */
 export const OPENAI_WIDGET_MIME_TYPE = 'text/html+skybridge';

package/build/dts/site-widget-tools/site-builder-tool/index.js

@@ -67,7 +67,7 @@ export function addCreateSiteWidgetTool(server, authStrategy, options) {
             suggestedSiteName: z
                 .string()
                 .optional()
-                .describe('Suggested site name to use for the site based on the site prompt.')
+                .describe('You must provide this on every call, including updates to an existing job, in English. A short name for the site: the business name the user gave, or one you derive from the site prompt.')
         },
         _meta: toolDefinitionMeta,
         annotations: {

package/build/dts/site-widget-tools/site-creation-tool/index.js

@@ -85,8 +85,9 @@ export function addWixSiteCreationTool(server, _authStrategy, options) {
         // Reply instruction: a fixed SHAPE (question + the two options + a "Next up:" line) built
         // from the query (site type) and the inferred customActions, with the two option lines left
         // for the model to tailor to the industry. Returned as-is; the tool description also
-        // instructs the model to write it out (both are load-bearing).
-        const message = buildSiteCreationSelectorMessage(args.query, args.customActions);
+        // instructs the model to write it out (both are load-bearing). Microsoft Copilot gets the
+        // message without the preamble: its safety filter blocks the reply otherwise.
+        const message = buildSiteCreationSelectorMessage(args.query, args.customActions, { plain: server.isMicrosoftCopilotClient() });
         return withJsonContent({
             content: [
                 {

package/build/dts/site-widget-tools/suggested-domain-tool/index.js

@@ -1,7 +1,14 @@
 import { rethrowIfUnauthorized } from '../../auth/index.js';
 import z from 'zod';
+import dedent from 'dedent';
 import { GET_SUGGESTED_DOMAINS_TOOL_NAME } from '../constants.js';
 const WIX_APIS_BASE_URL = 'https://www.wixapis.com';
+// Sites keep this placeholder until the owner renames them, and domain search
+// rejects it as a blacklisted term.
+const DEFAULT_SITE_NAME = /^my site(\s+\d+)?$/i;
+function isDefaultSiteName(siteName) {
+    return DEFAULT_SITE_NAME.test(siteName.trim());
+}
 async function fetchSiteDisplayName(siteAuthorization, siteId) {
     const response = await fetch(`${WIX_APIS_BASE_URL}/site-properties/v4/properties`, {
         headers: {
@@ -19,7 +26,15 @@ export function addSuggestedDomainTool(server, authStrategy) {
     const { getSiteAuthHeaders, isAnonymous } = authStrategy;
     server.registerTool(GET_SUGGESTED_DOMAINS_TOOL_NAME, {
         title: 'Get Suggested Domains',
-        description: 'Suggest available domain names. Provide either a free-text query (e.g. "pancakes business", "modern yoga studio") OR a siteId to auto-suggest based on the site name. At least one of query or siteId is required.',
+        description: dedent `
+        Suggests available domain names for a business, brand, or Wix site.
+
+        Call this when the user asks for domain name ideas, wants to know which domains are available, or wants a domain for a new or existing site.
+
+        Provide either a free-text \`query\` (the user's own words, e.g. "pancakes business", "modern yoga studio") OR a \`siteId\` to base the suggestions on that site's name. At least one of them is required.
+
+        Present the returned domains to the user as a short list. This tool only suggests domains — it does not purchase or connect them.
+      `,
         inputSchema: {
             query: z
                 .string()
@@ -45,10 +60,11 @@ export function addSuggestedDomainTool(server, authStrategy) {
         },
         _meta: {
             securitySchemes: [{ type: 'oauth2', scopes: ['offline_access'] }],
-            ui: { visibility: ['app'] },
+            // Model-visible so hosts (e.g. Microsoft 365 Copilot) can call it directly and show it
+            // in their debug info; 'app' keeps it callable from the site-builder widget.
+            ui: { visibility: ['app', 'model'] },
             'openai/toolInvocation/invoking': 'Fetching suggested domains',
-            'openai/toolInvocation/invoked': 'Suggested domains retrieved',
-            'openai/visibility': 'private'
+            'openai/toolInvocation/invoked': 'Suggested domains retrieved'
         }
     }, async (args, { panorama }) => {
         console.log('[getSuggestedDomains] Invoked with args:', args);
@@ -90,7 +106,9 @@ export function addSuggestedDomainTool(server, authStrategy) {
                             structuredContent: { domains: [] }
                         };
                     }
-                    resolvedQuery = siteName;
+                    if (!isDefaultSiteName(siteName) || !resolvedQuery) {
+                        resolvedQuery = siteName;
+                    }
                 }
                 catch (error) {
                     panorama

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

@@ -58,6 +58,8 @@ export declare class WixMcpServer extends McpServer {
     setOpenAiMcpAppsEnabled(enabled: boolean): void;
     setMcpAppsInMcpEnabled(enabled: boolean): void;
     isMcpAppsInMcpEnabled(): boolean;
+    /** Microsoft 365 Copilot ("sydney" at runtime) or Copilot Cowork ("copilot"). */
+    isMicrosoftCopilotClient(): boolean;
     shouldRenderMcpApps(): boolean;
     getWidgetExtras(): WidgetExtras;
     tool(name: string, cb: WixToolCallback): RegisteredTool;

package/build/dts/wix-mcp-server.js

@@ -60,6 +60,11 @@ export class WixMcpServer extends McpServer {
     isMcpAppsInMcpEnabled() {
         return this.mcpAppsInMcpEnabled;
     }
+    /** Microsoft 365 Copilot ("sydney" at runtime) or Copilot Cowork ("copilot"). */
+    isMicrosoftCopilotClient() {
+        const clientName = this.getClientName?.()?.toLowerCase() ?? '';
+        return clientName.includes('sydney') || clientName.includes('copilot');
+    }
     shouldRenderMcpApps() {
         const clientName = this.getClientName?.()?.toLowerCase();
         const isOpenAi = clientName?.includes('openai') ?? false;

package/build/esm/index.js

@@ -29818,6 +29818,11 @@ var WixMcpServer = class extends McpServer {
   isMcpAppsInMcpEnabled() {
     return this.mcpAppsInMcpEnabled;
   }
+  /** Microsoft 365 Copilot ("sydney" at runtime) or Copilot Cowork ("copilot"). */
+  isMicrosoftCopilotClient() {
+    const clientName = this.getClientName?.()?.toLowerCase() ?? "";
+    return clientName.includes("sydney") || clientName.includes("copilot");
+  }
   shouldRenderMcpApps() {
     const clientName = this.getClientName?.()?.toLowerCase();
     const isOpenAi = clientName?.includes("openai") ?? false;
@@ -30942,6 +30947,8 @@ var SITE_CREATION_COPY = {
 var SITE_GUIDANCE = dedent_default`
   A new-site request has two things to settle: what the site is for, and how to build it. The how is AI generation vs. starting from a template, so naming templates, a template id or Wix Studio (Wix Studio is also the template side) already settles it.
 
+  One case skips all of this: the user ALREADY HAS the finished site as files — hand-written HTML/CSS/JS, a zip, or the export of an AI builder. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool. Send them to https://www.wix.com/headless/drop?utm_campaign=mcp — they drag the files in and get a live Wix-hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
+
   Settle what the site is for first: its purpose, topic, business type, audience, or main visitor action. Naming a method is not a description of the site, and neither is the business or industry on its own.
   If you can't tell yet, ask the preferred question below and nothing else — one question, no creation-method question in the same reply, and no internal tool names.
   Once the purpose is clear, unless the user already named a method, ${SITE_CREATION_COPY.unstatedMethod.nonWidget}. A method they named is settled — never re-open it. Never default to AI or to templates, and never ask the user to choose between Harmony and Wix Studio; infer that from their words.
@@ -31274,7 +31281,8 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     After calling, you MUST speak the message provided in the tool result to the user as your reply — do not stay silent and do not replace it with a one-line pointer to the widget. Write out ALL of it, word for word: its opening line (the "Ready to set up your … site?" question INCLUDING "Choose your path in the widget above:"), BOTH of its option bullets, and its "Next up:" line, each on its own line and in that order. Do not summarize, shorten, drop any line, invent your own opener, rename the options, or add an intro or outro.
   `,
     "import-claude-design-from-url": dedent_default`
-    Import a design into Wix from a publicly fetchable URL. The file is a self-contained HTML bundle with all images, fonts, and styles inlined. Creates a live Wix-hosted site and returns its URL.
+    Import a design created in Claude's design tool into Wix. Takes the signed claudeusercontent.com URL Claude Design produces for its self-contained HTML bundle (all images, fonts, and styles inlined); any other host is rejected. Creates a live Wix-hosted site and returns its URL.
+    NOT for site files the user provides themselves (their own HTML/CSS/JS, a zip, another builder's export) — for those, don't call this tool: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp, where they upload the files and get a live hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -31675,6 +31683,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     CreateWixBusinessGuide: dedent_default`
     Provides comprehensive documentation for creating a new Wix business (site, app, etc.).
     Call this ONLY when the user explicitly asks for a headless site, a Wix Classic Editor site, or manual/advanced account/API-based site creation — these don't need the site's purpose first. For normal site-creation ${SITE_CREATION_COPY.normalCreationRoute.nonWidget}; for a specific template id, call \`CreateSiteFromTemplate\`.
+    Exception, even when the user says "headless": if they ALREADY HAVE the finished site as files (their own HTML/CSS/JS, a zip, an AI-builder export) and want those files hosted, don't call this tool — send them to https://www.wix.com/headless/drop?utm_campaign=mcp to upload the files and get a live hosted site (give that URL exactly, keeping the utm_campaign=mcp parameter). This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -32140,7 +32149,16 @@ var known_apps_default = {
   "1480c568-5cbd-9392-5604-1148f5faffa0": "Promote SEO",
   "ff5d6eb1-65e4-4f9a-8b14-64d34c12cc2e": "Wix Rentals"
 };
-var DYNAMIC_CONTEXT_URL = "https://dev.wix.com/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_PATH = "/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_URL = `https://dev.wix.com${DYNAMIC_CONTEXT_PATH}`;
+var isWixHost = (hostname2) => hostname2 === "wix.com" || hostname2.endsWith(".wix.com");
+var dynamicContextUrl = () => {
+  if (typeof window === "undefined") {
+    return DYNAMIC_CONTEXT_URL;
+  }
+  const hostname2 = window.location?.hostname;
+  return typeof hostname2 === "string" && isWixHost(hostname2) ? DYNAMIC_CONTEXT_PATH : DYNAMIC_CONTEXT_URL;
+};
 var COUNT_SITES_URL = "https://www.wixapis.com/site-list/v2/sites/count";
 var MAX_SITES_FOR_DYNAMIC_CONTEXT = 10;
 var DYNAMIC_CONTEXT_PETRI_OVERRIDE = "shouldReturnDynamicContextInMCP#B";
@@ -32192,7 +32210,7 @@ async function getDynamicContext(auth, httpClient6, filter, options) {
     if (filter?.siteId) body.site_id = filter.siteId;
     else if (filter?.siteName) body.site_name = filter.siteName;
     const dynamicContextPromise = httpClient6.request({
-      url: DYNAMIC_CONTEXT_URL,
+      url: dynamicContextUrl(),
       method: "POST",
       headers: {
         ...accountHeaders,
@@ -34643,9 +34661,18 @@ var SITE_CREATION_CUSTOM_ACTIONS_GUIDANCE = `2\u20133 specific, high-value setup
 * Events / Weddings / Real Estate: "add event schedules, display listings, and manage RSVP forms"
 * General / Unspecified: "${SITE_CREATION_DEFAULT_ACTIONS}"
 If none of these patterns fit the site, infer 2\u20133 actions that suit what that kind of business would manage on its site.`;
-function buildSiteCreationSelectorMessage(siteType, customActions) {
+function buildSiteCreationSelectorMessage(siteType, customActions, { plain = false } = {}) {
   const type = (siteType ?? "").trim() || "new";
   const actions = (customActions ?? "").trim() || SITE_CREATION_DEFAULT_ACTIONS;
+  const body = `Ready to set up your ${type} site? Choose your path in the widget above:
+
+* **Build with AI** for a custom, tailor-made layout
+* **Pick a template** to start with a pre-designed layout
+
+**Next up:** Once your site is created, you can customize it in Wix or ask me to ${actions}\u2014right here in the chat!`;
+  if (plain) {
+    return body;
+  }
   return `You are the assistant replying to the user \u2014 say this message out loud in chat (do NOT stay silent, and do NOT just point at the widget). Your reply is only complete if it includes ALL of the following, word for word, each on its own line and in this order:
 1. "Ready to set up your ${type} site? Choose your path in the widget above:" \u2014 keep the "Choose your path in the widget above:" part.
 2. "* **Build with AI** for a custom, tailor-made layout"
@@ -34654,12 +34681,7 @@ function buildSiteCreationSelectorMessage(siteType, customActions) {
 
 Copy those four lines as written; do not summarize, shorten, reorder, or reword any of them. Here is the full message to send:
 
-Ready to set up your ${type} site? Choose your path in the widget above:
-
-* **Build with AI** for a custom, tailor-made layout
-* **Pick a template** to start with a pre-designed layout
-
-**Next up:** Once your site is created, you can customize it in Wix or ask me to ${actions}\u2014right here in the chat!`;
+${body}`;
 }
 var OPENAI_WIDGET_MIME_TYPE = "text/html+skybridge";
 var SITE_WIDGET_MCP_CSP = {
@@ -41614,7 +41636,7 @@ function addCreateSiteWidgetTool(server, authStrategy, options) {
           `The prompt to build the site. If not provided, the user will be asked to provide a prompt.`
         ),
         suggestedSiteName: external_exports.string().optional().describe(
-          "Suggested site name to use for the site based on the site prompt."
+          "You must provide this on every call, including updates to an existing job, in English. A short name for the site: the business name the user gave, or one you derive from the site prompt."
         )
       },
       _meta: toolDefinitionMeta,
@@ -41771,6 +41793,10 @@ async function buildHarmonySite({
 
 // src/site-widget-tools/suggested-domain-tool/index.ts
 var WIX_APIS_BASE_URL3 = "https://www.wixapis.com";
+var DEFAULT_SITE_NAME = /^my site(\s+\d+)?$/i;
+function isDefaultSiteName(siteName) {
+  return DEFAULT_SITE_NAME.test(siteName.trim());
+}
 async function fetchSiteDisplayName(siteAuthorization, siteId) {
   const response = await fetch(
     `${WIX_APIS_BASE_URL3}/site-properties/v4/properties`,
@@ -41795,7 +41821,15 @@ function addSuggestedDomainTool(server, authStrategy) {
     GET_SUGGESTED_DOMAINS_TOOL_NAME,
     {
       title: "Get Suggested Domains",
-      description: 'Suggest available domain names. Provide either a free-text query (e.g. "pancakes business", "modern yoga studio") OR a siteId to auto-suggest based on the site name. At least one of query or siteId is required.',
+      description: dedent_default`
+        Suggests available domain names for a business, brand, or Wix site.
+
+        Call this when the user asks for domain name ideas, wants to know which domains are available, or wants a domain for a new or existing site.
+
+        Provide either a free-text \`query\` (the user's own words, e.g. "pancakes business", "modern yoga studio") OR a \`siteId\` to base the suggestions on that site's name. At least one of them is required.
+
+        Present the returned domains to the user as a short list. This tool only suggests domains — it does not purchase or connect them.
+      `,
       inputSchema: {
         query: zod_default.string().optional().describe(
           "Free-text keywords, business idea, or brand concept to base suggestions on. Use the user's own words."
@@ -41815,10 +41849,11 @@ function addSuggestedDomainTool(server, authStrategy) {
       },
       _meta: {
         securitySchemes: [{ type: "oauth2", scopes: ["offline_access"] }],
-        ui: { visibility: ["app"] },
+        // Model-visible so hosts (e.g. Microsoft 365 Copilot) can call it directly and show it
+        // in their debug info; 'app' keeps it callable from the site-builder widget.
+        ui: { visibility: ["app", "model"] },
         "openai/toolInvocation/invoking": "Fetching suggested domains",
-        "openai/toolInvocation/invoked": "Suggested domains retrieved",
-        "openai/visibility": "private"
+        "openai/toolInvocation/invoked": "Suggested domains retrieved"
       }
     },
     async (args, { panorama }) => {
@@ -41866,7 +41901,9 @@ function addSuggestedDomainTool(server, authStrategy) {
                 structuredContent: { domains: [] }
               };
             }
-            resolvedQuery = siteName;
+            if (!isDefaultSiteName(siteName) || !resolvedQuery) {
+              resolvedQuery = siteName;
+            }
           } catch (error2) {
             panorama.logger().error(
               `[getSuggestedDomains] Error fetching site name for siteId: ${siteId}`,
@@ -42322,7 +42359,8 @@ function addWixSiteCreationTool(server, _authStrategy, options) {
       };
       const message = buildSiteCreationSelectorMessage(
         args.query,
-        args.customActions
+        args.customActions,
+        { plain: server.isMicrosoftCopilotClient() }
       );
       return withJsonContent({
         content: [
@@ -45178,10 +45216,14 @@ function addImportClaudeDesignTool(server, authStrategy, options) {
       try {
         designUrl = new URL(args.url);
       } catch {
-        return errorResult("Invalid design URL.");
+        return errorResult(
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For site files the user provided themselves, do not retry: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site."
+        );
       }
       if (designUrl.protocol !== "https:" || !designUrl.hostname.endsWith(CLAUDE_USER_CONTENT_HOST_SUFFIX)) {
-        return errorResult("Invalid design URL.");
+        return errorResult(
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For site files the user provided themselves, do not retry: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site."
+        );
       }
       const accountHeaders = await authStrategy.getAccountAuthHeaders();
       const wixstroOptions = { baseUrl: wixstroBaseUrl, accountHeaders };

package/build/esm/toolkit.js

@@ -12177,6 +12177,8 @@ var SITE_CREATION_COPY = {
 var SITE_GUIDANCE = dedent_default`
   A new-site request has two things to settle: what the site is for, and how to build it. The how is AI generation vs. starting from a template, so naming templates, a template id or Wix Studio (Wix Studio is also the template side) already settles it.
 
+  One case skips all of this: the user ALREADY HAS the finished site as files — hand-written HTML/CSS/JS, a zip, or the export of an AI builder. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool. Send them to https://www.wix.com/headless/drop?utm_campaign=mcp — they drag the files in and get a live Wix-hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
+
   Settle what the site is for first: its purpose, topic, business type, audience, or main visitor action. Naming a method is not a description of the site, and neither is the business or industry on its own.
   If you can't tell yet, ask the preferred question below and nothing else — one question, no creation-method question in the same reply, and no internal tool names.
   Once the purpose is clear, unless the user already named a method, ${SITE_CREATION_COPY.unstatedMethod.nonWidget}. A method they named is settled — never re-open it. Never default to AI or to templates, and never ask the user to choose between Harmony and Wix Studio; infer that from their words.
@@ -12509,7 +12511,8 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     After calling, you MUST speak the message provided in the tool result to the user as your reply — do not stay silent and do not replace it with a one-line pointer to the widget. Write out ALL of it, word for word: its opening line (the "Ready to set up your … site?" question INCLUDING "Choose your path in the widget above:"), BOTH of its option bullets, and its "Next up:" line, each on its own line and in that order. Do not summarize, shorten, drop any line, invent your own opener, rename the options, or add an intro or outro.
   `,
     "import-claude-design-from-url": dedent_default`
-    Import a design into Wix from a publicly fetchable URL. The file is a self-contained HTML bundle with all images, fonts, and styles inlined. Creates a live Wix-hosted site and returns its URL.
+    Import a design created in Claude's design tool into Wix. Takes the signed claudeusercontent.com URL Claude Design produces for its self-contained HTML bundle (all images, fonts, and styles inlined); any other host is rejected. Creates a live Wix-hosted site and returns its URL.
+    NOT for site files the user provides themselves (their own HTML/CSS/JS, a zip, another builder's export) — for those, don't call this tool: send the user to https://www.wix.com/headless/drop?utm_campaign=mcp, where they upload the files and get a live hosted site. Give that URL exactly as written, keeping the utm_campaign=mcp parameter.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -12910,6 +12913,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     CreateWixBusinessGuide: dedent_default`
     Provides comprehensive documentation for creating a new Wix business (site, app, etc.).
     Call this ONLY when the user explicitly asks for a headless site, a Wix Classic Editor site, or manual/advanced account/API-based site creation — these don't need the site's purpose first. For normal site-creation ${SITE_CREATION_COPY.normalCreationRoute.nonWidget}; for a specific template id, call \`CreateSiteFromTemplate\`.
+    Exception, even when the user says "headless": if they ALREADY HAVE the finished site as files (their own HTML/CSS/JS, a zip, an AI-builder export) and want those files hosted, don't call this tool — send them to https://www.wix.com/headless/drop?utm_campaign=mcp to upload the files and get a live hosted site (give that URL exactly, keeping the utm_campaign=mcp parameter). This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -13375,7 +13379,16 @@ var known_apps_default = {
   "1480c568-5cbd-9392-5604-1148f5faffa0": "Promote SEO",
   "ff5d6eb1-65e4-4f9a-8b14-64d34c12cc2e": "Wix Rentals"
 };
-var DYNAMIC_CONTEXT_URL = "https://dev.wix.com/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_PATH = "/_api/dynamic-context/v1/dynamic-context";
+var DYNAMIC_CONTEXT_URL = `https://dev.wix.com${DYNAMIC_CONTEXT_PATH}`;
+var isWixHost = (hostname) => hostname === "wix.com" || hostname.endsWith(".wix.com");
+var dynamicContextUrl = () => {
+  if (typeof window === "undefined") {
+    return DYNAMIC_CONTEXT_URL;
+  }
+  const hostname = window.location?.hostname;
+  return typeof hostname === "string" && isWixHost(hostname) ? DYNAMIC_CONTEXT_PATH : DYNAMIC_CONTEXT_URL;
+};
 var COUNT_SITES_URL = "https://www.wixapis.com/site-list/v2/sites/count";
 var MAX_SITES_FOR_DYNAMIC_CONTEXT = 10;
 var DYNAMIC_CONTEXT_PETRI_OVERRIDE = "shouldReturnDynamicContextInMCP#B";
@@ -13427,7 +13440,7 @@ async function getDynamicContext(auth, httpClient, filter, options) {
     if (filter?.siteId) body.site_id = filter.siteId;
     else if (filter?.siteName) body.site_name = filter.siteName;
     const dynamicContextPromise = httpClient.request({
-      url: DYNAMIC_CONTEXT_URL,
+      url: dynamicContextUrl(),
       method: "POST",
       headers: {
         ...accountHeaders,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/mcp",
-  "version": "1.0.81",
+  "version": "1.0.82",
   "description": "A Model Context Protocol server for Wix AI tools",
   "bin": "./build/bin-standalone.js",
   "dependencies": {
@@ -133,5 +133,5 @@
       ]
     }
   },
-  "falconPackageHash": "04c1a3fafda823896c3a8c44537812f0689d6738d5369629956fdaf4"
+  "falconPackageHash": "b8ae29303e3809101199412477e8e9124437d8603c423399ed88697d"
 }