@wix/mcp 1.0.90 → 1.0.91

package/build/bin-standalone.js

@@ -71599,7 +71599,7 @@ function buildSystemReminderGuidelines(includeReadme, includeImageUploadGuidance
       "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 \u2014 creating a new Wix site/website:** For a normal creation request \u2014 and only then \u2014 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 \u2014 these don't need the site's purpose first.",
-      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call DeployWebsite right away \u2014 not a site-creation tool, not the docs.",
+      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call StartDeployWebsite right away \u2014 not a site-creation tool, not the docs.",
       "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."
     );
   }
@@ -71681,7 +71681,7 @@ 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: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call DeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
+  One case skips all of this: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call StartDeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
 
   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.
@@ -72073,7 +72073,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
   `,
     "import-claude-design-from-url": dedent_default`
     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 a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call DeployWebsite instead; it returns the recipe to publish the files yourself.
+    NOT for a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call StartDeployWebsite instead; it returns the recipe to publish the files yourself.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -72555,7 +72555,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     Results: each root field fails independently — \`errors[].path\` names the failing field and \`errors[].extensions.message\` the cause (e.g. PERMISSION_DENIED); \`data\` still holds the fields that succeeded. Mutations return the created/updated entity — read the IDs from it and do not re-query to verify. Large results are truncated: narrow the selection or page size instead of re-running.
     Set \`hasMutations: true\` for any document containing a mutation root field.
   `,
-    DeployWebsite: dedent_default`
+    StartDeployWebsite: dedent_default`
     The user — or you, earlier in this conversation — ALREADY HAVE a finished page or site, in any form, and it should be live on Wix: HTML/CSS/JS files, a static build (dist/, out/), a zip, another AI builder's export, or a page/design you created in this conversation (export it to HTML first — a finished design IS a finished page). Call this when the user says deploy, host, publish, put online, make it live, get a URL, or upload my site / index.html.
     Also for updating a site deployed this way (replace its files; same site, same URL) and for implementing a backend on one (stores, bookings, CMS, members) as a Wix Headless project — same site, same URL. Works with or without a Wix login (anonymous deploy with a save link), through the Wix MCP alone or from a shell.
     Missing real functionality — a fake checkout, a form that goes nowhere, bookings — is NOT a reason to rebuild the site with a site-creation tool: deploy the page as is, then add the backend afterwards (the recipe covers it).
@@ -72565,7 +72565,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 a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call DeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
+    Exception, even when the user says "headless": if a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call StartDeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -73674,39 +73674,42 @@ ${articleContent}${nextSteps}`;
   );
 }
 
-// src/docs/deploy-website.ts
-var DEPLOY_WEBSITE_TOOL_NAME = "DeployWebsite";
-var DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
+// src/docs/start-deploy-website.ts
+var START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION = "A few sentences covering: the user's request (quoted if short); what the site is \u2014 its purpose and who it is for \u2014 and its current form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design created in this conversation), roughly how many files, and whether it includes images; what the site must be able to do for its visitors beyond showing pages, if anything \u2014 selling, bookings or reservations, tickets, menus and orders, rentals, forms, memberships or paid plans, donations, a blog, or anything else the user expects to work \u2014 described in your own words, or a note that it is a plain static site with no such needs; which agent or product you are and the harness you run in.";
+var START_DEPLOY_WEBSITE_TOOL_NAME = "StartDeployWebsite";
+var START_DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
 var DROP_PAGE_URL = "https://www.wix.com/headless/drop?utm_campaign=mcp";
 var FALLBACK_LINE = `Only if you cannot run it (you can't reach the file bytes, or a step fails and you can't fix it): send the user to ${DROP_PAGE_URL} \u2014 give that URL exactly as written, keeping the utm_campaign=mcp parameter.`;
-function deployWebsiteResponse(recipe) {
+function startDeployWebsiteResponse(recipe) {
   return [
-    `The following is the content of ${DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
+    `The following is the content of ${START_DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
     FALLBACK_LINE,
     "---",
     recipe.trim()
   ].join("\n\n");
 }
-var DEPLOY_WEBSITE_POINTER_RESPONSE = [
-  `Read and follow this recipe end to end: ${DEPLOY_WEBSITE_RECIPE_URL}`,
+var START_DEPLOY_WEBSITE_POINTER_RESPONSE = [
+  `Read and follow this recipe end to end: ${START_DEPLOY_WEBSITE_RECIPE_URL}`,
   "It covers creating the site and uploading the files (with or without a Wix login), updating a site deployed this way, and implementing a backend on it (stores, bookings, CMS, members) as a Wix Headless project. Do the publishing yourself \u2014 do not hand the user instructions.",
   FALLBACK_LINE
 ].join("\n\n");
-function addDeployWebsiteTool(server2, disableTools = [], toolDescriptions, fetchOptions = {}) {
-  if (disableTools.includes(DEPLOY_WEBSITE_TOOL_NAME)) {
+function addStartDeployWebsiteTool(server2, disableTools = [], toolDescriptions, fetchOptions = {}) {
+  if (disableTools.includes(START_DEPLOY_WEBSITE_TOOL_NAME)) {
     return;
   }
   server2.tool(
-    DEPLOY_WEBSITE_TOOL_NAME,
-    toolDescriptions?.[DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[DEPLOY_WEBSITE_TOOL_NAME],
-    {},
+    START_DEPLOY_WEBSITE_TOOL_NAME,
+    toolDescriptions?.[START_DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[START_DEPLOY_WEBSITE_TOOL_NAME],
+    {
+      brief: external_exports.string().min(1).describe(START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION)
+    },
     { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
     async (_args, { httpClient }) => {
-      let text = DEPLOY_WEBSITE_POINTER_RESPONSE;
+      let text = START_DEPLOY_WEBSITE_POINTER_RESPONSE;
       try {
         const recipe = await fetchArticleContent(
           httpClient,
-          DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
+          START_DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
           "article",
           true,
           fetchOptions.skillsPortalUrl,
@@ -73714,11 +73717,11 @@ function addDeployWebsiteTool(server2, disableTools = [], toolDescriptions, fetc
           fetchOptions.commitHash
         );
         if (recipe && recipe.trim()) {
-          text = deployWebsiteResponse(recipe);
+          text = startDeployWebsiteResponse(recipe);
         }
       } catch (error2) {
         console.warn(
-          `[DeployWebsite] recipe fetch failed, returning the pointer:`,
+          `[StartDeployWebsite] recipe fetch failed, returning the pointer:`,
           error2 instanceof Error ? error2.message : error2
         );
       }
@@ -73786,7 +73789,7 @@ var addDocsTools = (server2, allowedTools = [
   const {
     getToKnowWixEnabled = false,
     createWixBusinessGuideEnabled = true,
-    deployWebsiteEnabled = true,
+    startDeployWebsiteEnabled = true,
     disableTools,
     toolDescriptions,
     readmeDocs,
@@ -73852,8 +73855,8 @@ var addDocsTools = (server2, allowedTools = [
       cliEnabled
     );
   }
-  if (deployWebsiteEnabled) {
-    addDeployWebsiteTool(server2, disableTools || [], toolDescriptions, {
+  if (startDeployWebsiteEnabled) {
+    addStartDeployWebsiteTool(server2, disableTools || [], toolDescriptions, {
       skillsPortalUrl,
       repo: effectiveRepo,
       commitHash: effectiveCommitHash

package/build/cjs/index.cjs

@@ -37215,7 +37215,7 @@ function buildSystemReminderGuidelines(includeReadme, includeImageUploadGuidance
       "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 \u2014 creating a new Wix site/website:** For a normal creation request \u2014 and only then \u2014 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 \u2014 these don't need the site's purpose first.",
-      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call DeployWebsite right away \u2014 not a site-creation tool, not the docs.",
+      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call StartDeployWebsite right away \u2014 not a site-creation tool, not the docs.",
       "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."
     );
   }
@@ -37297,7 +37297,7 @@ 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: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call DeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
+  One case skips all of this: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call StartDeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
 
   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.
@@ -37689,7 +37689,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
   `,
     "import-claude-design-from-url": dedent_default`
     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 a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call DeployWebsite instead; it returns the recipe to publish the files yourself.
+    NOT for a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call StartDeployWebsite instead; it returns the recipe to publish the files yourself.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -38171,7 +38171,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     Results: each root field fails independently — \`errors[].path\` names the failing field and \`errors[].extensions.message\` the cause (e.g. PERMISSION_DENIED); \`data\` still holds the fields that succeeded. Mutations return the created/updated entity — read the IDs from it and do not re-query to verify. Large results are truncated: narrow the selection or page size instead of re-running.
     Set \`hasMutations: true\` for any document containing a mutation root field.
   `,
-    DeployWebsite: dedent_default`
+    StartDeployWebsite: dedent_default`
     The user — or you, earlier in this conversation — ALREADY HAVE a finished page or site, in any form, and it should be live on Wix: HTML/CSS/JS files, a static build (dist/, out/), a zip, another AI builder's export, or a page/design you created in this conversation (export it to HTML first — a finished design IS a finished page). Call this when the user says deploy, host, publish, put online, make it live, get a URL, or upload my site / index.html.
     Also for updating a site deployed this way (replace its files; same site, same URL) and for implementing a backend on one (stores, bookings, CMS, members) as a Wix Headless project — same site, same URL. Works with or without a Wix login (anonymous deploy with a save link), through the Wix MCP alone or from a shell.
     Missing real functionality — a fake checkout, a form that goes nowhere, bookings — is NOT a reason to rebuild the site with a site-creation tool: deploy the page as is, then add the backend afterwards (the recipe covers it).
@@ -38181,7 +38181,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 a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call DeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
+    Exception, even when the user says "headless": if a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call StartDeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -39328,39 +39328,42 @@ ${articleContent}${nextSteps}`;
   );
 }
 
-// src/docs/deploy-website.ts
-var DEPLOY_WEBSITE_TOOL_NAME = "DeployWebsite";
-var DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
+// src/docs/start-deploy-website.ts
+var START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION = "A few sentences covering: the user's request (quoted if short); what the site is \u2014 its purpose and who it is for \u2014 and its current form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design created in this conversation), roughly how many files, and whether it includes images; what the site must be able to do for its visitors beyond showing pages, if anything \u2014 selling, bookings or reservations, tickets, menus and orders, rentals, forms, memberships or paid plans, donations, a blog, or anything else the user expects to work \u2014 described in your own words, or a note that it is a plain static site with no such needs; which agent or product you are and the harness you run in.";
+var START_DEPLOY_WEBSITE_TOOL_NAME = "StartDeployWebsite";
+var START_DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
 var DROP_PAGE_URL = "https://www.wix.com/headless/drop?utm_campaign=mcp";
 var FALLBACK_LINE = `Only if you cannot run it (you can't reach the file bytes, or a step fails and you can't fix it): send the user to ${DROP_PAGE_URL} \u2014 give that URL exactly as written, keeping the utm_campaign=mcp parameter.`;
-function deployWebsiteResponse(recipe) {
+function startDeployWebsiteResponse(recipe) {
   return [
-    `The following is the content of ${DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
+    `The following is the content of ${START_DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
     FALLBACK_LINE,
     "---",
     recipe.trim()
   ].join("\n\n");
 }
-var DEPLOY_WEBSITE_POINTER_RESPONSE = [
-  `Read and follow this recipe end to end: ${DEPLOY_WEBSITE_RECIPE_URL}`,
+var START_DEPLOY_WEBSITE_POINTER_RESPONSE = [
+  `Read and follow this recipe end to end: ${START_DEPLOY_WEBSITE_RECIPE_URL}`,
   "It covers creating the site and uploading the files (with or without a Wix login), updating a site deployed this way, and implementing a backend on it (stores, bookings, CMS, members) as a Wix Headless project. Do the publishing yourself \u2014 do not hand the user instructions.",
   FALLBACK_LINE
 ].join("\n\n");
-function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
-  if (disableTools.includes(DEPLOY_WEBSITE_TOOL_NAME)) {
+function addStartDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
+  if (disableTools.includes(START_DEPLOY_WEBSITE_TOOL_NAME)) {
     return;
   }
   server.tool(
-    DEPLOY_WEBSITE_TOOL_NAME,
-    toolDescriptions?.[DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[DEPLOY_WEBSITE_TOOL_NAME],
-    {},
+    START_DEPLOY_WEBSITE_TOOL_NAME,
+    toolDescriptions?.[START_DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[START_DEPLOY_WEBSITE_TOOL_NAME],
+    {
+      brief: external_exports.string().min(1).describe(START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION)
+    },
     { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
     async (_args, { httpClient: httpClient6 }) => {
-      let text = DEPLOY_WEBSITE_POINTER_RESPONSE;
+      let text = START_DEPLOY_WEBSITE_POINTER_RESPONSE;
       try {
         const recipe = await fetchArticleContent(
           httpClient6,
-          DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
+          START_DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
           "article",
           true,
           fetchOptions.skillsPortalUrl,
@@ -39368,11 +39371,11 @@ function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetch
           fetchOptions.commitHash
         );
         if (recipe && recipe.trim()) {
-          text = deployWebsiteResponse(recipe);
+          text = startDeployWebsiteResponse(recipe);
         }
       } catch (error2) {
         console.warn(
-          `[DeployWebsite] recipe fetch failed, returning the pointer:`,
+          `[StartDeployWebsite] recipe fetch failed, returning the pointer:`,
           error2 instanceof Error ? error2.message : error2
         );
       }
@@ -39440,7 +39443,7 @@ var addDocsTools = (server, allowedTools = [
   const {
     getToKnowWixEnabled = false,
     createWixBusinessGuideEnabled = true,
-    deployWebsiteEnabled = true,
+    startDeployWebsiteEnabled = true,
     disableTools,
     toolDescriptions,
     readmeDocs,
@@ -39506,8 +39509,8 @@ var addDocsTools = (server, allowedTools = [
       cliEnabled
     );
   }
-  if (deployWebsiteEnabled) {
-    addDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
+  if (startDeployWebsiteEnabled) {
+    addStartDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
       skillsPortalUrl,
       repo: effectiveRepo,
       commitHash: effectiveCommitHash
@@ -52235,12 +52238,12 @@ function addImportClaudeDesignTool(server, authStrategy, options) {
         designUrl = new URL(args.url);
       } catch {
         return errorResult(
-          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool \u2014 call DeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp."
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool \u2014 call StartDeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp."
         );
       }
       if (designUrl.protocol !== "https:" || !designUrl.hostname.endsWith(CLAUDE_USER_CONTENT_HOST_SUFFIX)) {
         return errorResult(
-          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool \u2014 call DeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp."
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool \u2014 call StartDeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp."
         );
       }
       const accountHeaders = await authStrategy.getAccountAuthHeaders();

package/build/cjs/toolkit.cjs

@@ -17702,7 +17702,7 @@ function buildSystemReminderGuidelines(includeReadme, includeImageUploadGuidance
       "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 \u2014 creating a new Wix site/website:** For a normal creation request \u2014 and only then \u2014 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 \u2014 these don't need the site's purpose first.",
-      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call DeployWebsite right away \u2014 not a site-creation tool, not the docs.",
+      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call StartDeployWebsite right away \u2014 not a site-creation tool, not the docs.",
       "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."
     );
   }
@@ -17784,7 +17784,7 @@ 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: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call DeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
+  One case skips all of this: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call StartDeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
 
   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.
@@ -18176,7 +18176,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
   `,
     "import-claude-design-from-url": dedent_default`
     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 a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call DeployWebsite instead; it returns the recipe to publish the files yourself.
+    NOT for a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call StartDeployWebsite instead; it returns the recipe to publish the files yourself.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -18658,7 +18658,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     Results: each root field fails independently — \`errors[].path\` names the failing field and \`errors[].extensions.message\` the cause (e.g. PERMISSION_DENIED); \`data\` still holds the fields that succeeded. Mutations return the created/updated entity — read the IDs from it and do not re-query to verify. Large results are truncated: narrow the selection or page size instead of re-running.
     Set \`hasMutations: true\` for any document containing a mutation root field.
   `,
-    DeployWebsite: dedent_default`
+    StartDeployWebsite: dedent_default`
     The user — or you, earlier in this conversation — ALREADY HAVE a finished page or site, in any form, and it should be live on Wix: HTML/CSS/JS files, a static build (dist/, out/), a zip, another AI builder's export, or a page/design you created in this conversation (export it to HTML first — a finished design IS a finished page). Call this when the user says deploy, host, publish, put online, make it live, get a URL, or upload my site / index.html.
     Also for updating a site deployed this way (replace its files; same site, same URL) and for implementing a backend on one (stores, bookings, CMS, members) as a Wix Headless project — same site, same URL. Works with or without a Wix login (anonymous deploy with a save link), through the Wix MCP alone or from a shell.
     Missing real functionality — a fake checkout, a form that goes nowhere, bookings — is NOT a reason to rebuild the site with a site-creation tool: deploy the page as is, then add the backend afterwards (the recipe covers it).
@@ -18668,7 +18668,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 a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call DeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
+    Exception, even when the user says "headless": if a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call StartDeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -19815,39 +19815,42 @@ ${articleContent}${nextSteps}`;
   );
 }
 
-// src/docs/deploy-website.ts
-var DEPLOY_WEBSITE_TOOL_NAME = "DeployWebsite";
-var DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
+// src/docs/start-deploy-website.ts
+var START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION = "A few sentences covering: the user's request (quoted if short); what the site is \u2014 its purpose and who it is for \u2014 and its current form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design created in this conversation), roughly how many files, and whether it includes images; what the site must be able to do for its visitors beyond showing pages, if anything \u2014 selling, bookings or reservations, tickets, menus and orders, rentals, forms, memberships or paid plans, donations, a blog, or anything else the user expects to work \u2014 described in your own words, or a note that it is a plain static site with no such needs; which agent or product you are and the harness you run in.";
+var START_DEPLOY_WEBSITE_TOOL_NAME = "StartDeployWebsite";
+var START_DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
 var DROP_PAGE_URL = "https://www.wix.com/headless/drop?utm_campaign=mcp";
 var FALLBACK_LINE = `Only if you cannot run it (you can't reach the file bytes, or a step fails and you can't fix it): send the user to ${DROP_PAGE_URL} \u2014 give that URL exactly as written, keeping the utm_campaign=mcp parameter.`;
-function deployWebsiteResponse(recipe) {
+function startDeployWebsiteResponse(recipe) {
   return [
-    `The following is the content of ${DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
+    `The following is the content of ${START_DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
     FALLBACK_LINE,
     "---",
     recipe.trim()
   ].join("\n\n");
 }
-var DEPLOY_WEBSITE_POINTER_RESPONSE = [
-  `Read and follow this recipe end to end: ${DEPLOY_WEBSITE_RECIPE_URL}`,
+var START_DEPLOY_WEBSITE_POINTER_RESPONSE = [
+  `Read and follow this recipe end to end: ${START_DEPLOY_WEBSITE_RECIPE_URL}`,
   "It covers creating the site and uploading the files (with or without a Wix login), updating a site deployed this way, and implementing a backend on it (stores, bookings, CMS, members) as a Wix Headless project. Do the publishing yourself \u2014 do not hand the user instructions.",
   FALLBACK_LINE
 ].join("\n\n");
-function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
-  if (disableTools.includes(DEPLOY_WEBSITE_TOOL_NAME)) {
+function addStartDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
+  if (disableTools.includes(START_DEPLOY_WEBSITE_TOOL_NAME)) {
     return;
   }
   server.tool(
-    DEPLOY_WEBSITE_TOOL_NAME,
-    toolDescriptions?.[DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[DEPLOY_WEBSITE_TOOL_NAME],
-    {},
+    START_DEPLOY_WEBSITE_TOOL_NAME,
+    toolDescriptions?.[START_DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[START_DEPLOY_WEBSITE_TOOL_NAME],
+    {
+      brief: external_exports.string().min(1).describe(START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION)
+    },
     { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
     async (_args, { httpClient }) => {
-      let text = DEPLOY_WEBSITE_POINTER_RESPONSE;
+      let text = START_DEPLOY_WEBSITE_POINTER_RESPONSE;
       try {
         const recipe = await fetchArticleContent(
           httpClient,
-          DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
+          START_DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
           "article",
           true,
           fetchOptions.skillsPortalUrl,
@@ -19855,11 +19858,11 @@ function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetch
           fetchOptions.commitHash
         );
         if (recipe && recipe.trim()) {
-          text = deployWebsiteResponse(recipe);
+          text = startDeployWebsiteResponse(recipe);
         }
       } catch (error) {
         console.warn(
-          `[DeployWebsite] recipe fetch failed, returning the pointer:`,
+          `[StartDeployWebsite] recipe fetch failed, returning the pointer:`,
           error instanceof Error ? error.message : error
         );
       }
@@ -19916,7 +19919,7 @@ var addDocsTools = (server, allowedTools = [
   const {
     getToKnowWixEnabled = false,
     createWixBusinessGuideEnabled = true,
-    deployWebsiteEnabled = true,
+    startDeployWebsiteEnabled = true,
     disableTools,
     toolDescriptions,
     readmeDocs,
@@ -19982,8 +19985,8 @@ var addDocsTools = (server, allowedTools = [
       cliEnabled
     );
   }
-  if (deployWebsiteEnabled) {
-    addDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
+  if (startDeployWebsiteEnabled) {
+    addStartDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
       skillsPortalUrl,
       repo: effectiveRepo,
       commitHash: effectiveCommitHash

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

@@ -18,7 +18,7 @@ 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.", "If the user — or you, earlier in this conversation — already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call DeployWebsite right away — not a site-creation tool, not the docs.", "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('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.", "If the user — or you, earlier in this conversation — already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call StartDeployWebsite right away — not a site-creation tool, not the docs.", "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.`);
     if (includeImageUploadGuidance) {
@@ -80,7 +80,7 @@ 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: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call DeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
+  One case skips all of this: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call StartDeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
 
   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.
@@ -472,7 +472,7 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
   `,
         'import-claude-design-from-url': dedent `
     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 a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call DeployWebsite instead; it returns the recipe to publish the files yourself.
+    NOT for a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call StartDeployWebsite instead; it returns the recipe to publish the files yourself.
   `,
         RunWixCliCommand: dedent `
     Executes Wix CLI commands for Wix app development and management.
@@ -954,7 +954,7 @@ export function buildToolDescriptions(includeReadme, includeImageUploadGuidance
     Results: each root field fails independently — \`errors[].path\` names the failing field and \`errors[].extensions.message\` the cause (e.g. PERMISSION_DENIED); \`data\` still holds the fields that succeeded. Mutations return the created/updated entity — read the IDs from it and do not re-query to verify. Large results are truncated: narrow the selection or page size instead of re-running.
     Set \`hasMutations: true\` for any document containing a mutation root field.
   `,
-        DeployWebsite: dedent `
+        StartDeployWebsite: dedent `
     The user — or you, earlier in this conversation — ALREADY HAVE a finished page or site, in any form, and it should be live on Wix: HTML/CSS/JS files, a static build (dist/, out/), a zip, another AI builder's export, or a page/design you created in this conversation (export it to HTML first — a finished design IS a finished page). Call this when the user says deploy, host, publish, put online, make it live, get a URL, or upload my site / index.html.
     Also for updating a site deployed this way (replace its files; same site, same URL) and for implementing a backend on one (stores, bookings, CMS, members) as a Wix Headless project — same site, same URL. Works with or without a Wix login (anonymous deploy with a save link), through the Wix MCP alone or from a shell.
     Missing real functionality — a fake checkout, a form that goes nowhere, bookings — is NOT a reason to rebuild the site with a site-creation tool: deploy the page as is, then add the backend afterwards (the recipe covers it).
@@ -964,7 +964,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 a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call DeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
+    Exception, even when the user says "headless": if a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call StartDeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 

package/build/dts/docs/docs.d.ts

@@ -19,8 +19,8 @@ export interface ReadmeDocConfig {
 export interface DocsToolsOptions {
     getToKnowWixEnabled?: boolean;
     createWixBusinessGuideEnabled?: boolean;
-    /** DeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
-    deployWebsiteEnabled?: boolean;
+    /** StartDeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
+    startDeployWebsiteEnabled?: boolean;
     disableTools?: string[];
     /** Custom descriptions for tools, keyed by tool name */
     toolDescriptions?: Record<string, string>;

package/build/dts/docs/docs.js

@@ -8,7 +8,7 @@ import { fetchPlatformizedMenu, MenuNotFoundError } from './browse-menu.js';
 import { isQueryOrSearchEndpoint, QUERY_CAPABILITY_MARKER } from './searchFormatting.js';
 import { addGetToKnowTools, addGetSiteContextTool } from './get-to-know.js';
 import { addCreateWixBusinessGuideTools } from './create-site-guide.js';
-import { addDeployWebsiteTool } from './deploy-website.js';
+import { addStartDeployWebsiteTool } from './start-deploy-website.js';
 import { defaultToolDescriptions } from '../config/default-config.js';
 import { desc } from '../config/param-descriptions.js';
 import dedent from 'dedent';
@@ -68,7 +68,7 @@ export const addDocsTools = (server, allowedTools = [
     'CLI',
     'OVERVIEW'
 ], options = {}) => {
-    const { getToKnowWixEnabled = false, createWixBusinessGuideEnabled = true, deployWebsiteEnabled = true, disableTools, toolDescriptions, readmeDocs, authStrategy, skillsPortalUrl, skillsRepo, repo, skillsPr, commitHash, skillsTags, dynamicContextEnabled, cliEnabled = false, usePlatformizedSearch = true, usePlatformizedBrowse = true } = options;
+    const { getToKnowWixEnabled = false, createWixBusinessGuideEnabled = true, startDeployWebsiteEnabled = true, disableTools, toolDescriptions, readmeDocs, authStrategy, skillsPortalUrl, skillsRepo, repo, skillsPr, commitHash, skillsTags, dynamicContextEnabled, cliEnabled = false, usePlatformizedSearch = true, usePlatformizedBrowse = true } = options;
     const effectiveRepo = repo ?? skillsRepo;
     const effectiveCommitHash = commitHash ?? skillsPr;
     // Helper to get description (custom or default)
@@ -126,8 +126,8 @@ export const addDocsTools = (server, allowedTools = [
     }
     // On by default: it is a routing slot, not a docs source — the agent with
     // ready-made site files must find it next to the site-creation tools.
-    if (deployWebsiteEnabled) {
-        addDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
+    if (startDeployWebsiteEnabled) {
+        addStartDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
             skillsPortalUrl,
             repo: effectiveRepo,
             commitHash: effectiveCommitHash

package/build/dts/docs/start-deploy-website.d.ts

@@ -0,0 +1,14 @@
+import { WixMcpServer } from '../wix-mcp-server.js';
+export declare const START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION = "A few sentences covering: the user's request (quoted if short); what the site is \u2014 its purpose and who it is for \u2014 and its current form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design created in this conversation), roughly how many files, and whether it includes images; what the site must be able to do for its visitors beyond showing pages, if anything \u2014 selling, bookings or reservations, tickets, menus and orders, rentals, forms, memberships or paid plans, donations, a blog, or anything else the user expects to work \u2014 described in your own words, or a note that it is a plain static site with no such needs; which agent or product you are and the harness you run in.";
+export declare const START_DEPLOY_WEBSITE_TOOL_NAME = "StartDeployWebsite";
+export declare const START_DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
+export declare const DROP_PAGE_URL = "https://www.wix.com/headless/drop?utm_campaign=mcp";
+export declare function startDeployWebsiteResponse(recipe: string): string;
+export declare const START_DEPLOY_WEBSITE_POINTER_RESPONSE: string;
+export interface StartDeployWebsiteFetchOptions {
+    skillsPortalUrl?: string;
+    repo?: string;
+    commitHash?: string;
+}
+export declare function addStartDeployWebsiteTool(server: WixMcpServer, disableTools?: string[], toolDescriptions?: Record<string, string>, fetchOptions?: StartDeployWebsiteFetchOptions): void;
+//# sourceMappingURL=start-deploy-website.d.ts.map

package/build/dts/docs/start-deploy-website.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { defaultToolDescriptions } from '../config/default-config.js';
+import { fetchArticleContent } from './fetch-article.js';
+// Longer than the one-sentence `reason` on other tools: it is the only record of
+// who deploys what. Read by people via BI; it does not change the response.
+export const START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION = "A few sentences covering: the user's request (quoted if short); what the site is — its purpose and who it is for — and its current form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design created in this conversation), roughly how many files, and whether it includes images; what the site must be able to do for its visitors beyond showing pages, if anything — selling, bookings or reservations, tickets, menus and orders, rentals, forms, memberships or paid plans, donations, a blog, or anything else the user expects to work — described in your own words, or a note that it is a plain static site with no such needs; which agent or product you are and the harness you run in.";
+export const START_DEPLOY_WEBSITE_TOOL_NAME = 'StartDeployWebsite';
+export const START_DEPLOY_WEBSITE_RECIPE_URL = 'https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md';
+export const DROP_PAGE_URL = 'https://www.wix.com/headless/drop?utm_campaign=mcp';
+const FALLBACK_LINE = `Only if you cannot run it (you can't reach the file bytes, or a step fails and you can't fix it): send the user to ${DROP_PAGE_URL} — give that URL exactly as written, keeping the utm_campaign=mcp parameter.`;
+// The tool exists to take the agent's attention at routing time; the work itself
+// is the recipe, so the response IS the recipe — fetched live and returned whole,
+// so the agent never has to decide whether to go read it.
+export function startDeployWebsiteResponse(recipe) {
+    return [
+        `The following is the content of ${START_DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself — do not hand the user instructions.`,
+        FALLBACK_LINE,
+        '---',
+        recipe.trim()
+    ].join('\n\n');
+}
+// When the recipe can't be fetched, the pointer still routes correctly.
+export const START_DEPLOY_WEBSITE_POINTER_RESPONSE = [
+    `Read and follow this recipe end to end: ${START_DEPLOY_WEBSITE_RECIPE_URL}`,
+    'It covers creating the site and uploading the files (with or without a Wix login), updating a site deployed this way, and implementing a backend on it (stores, bookings, CMS, members) as a Wix Headless project. Do the publishing yourself — do not hand the user instructions.',
+    FALLBACK_LINE
+].join('\n\n');
+export function addStartDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
+    if (disableTools.includes(START_DEPLOY_WEBSITE_TOOL_NAME)) {
+        return;
+    }
+    server.tool(START_DEPLOY_WEBSITE_TOOL_NAME, toolDescriptions?.[START_DEPLOY_WEBSITE_TOOL_NAME] ??
+        defaultToolDescriptions[START_DEPLOY_WEBSITE_TOOL_NAME], {
+        brief: z.string().min(1).describe(START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION)
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async (_args, { httpClient }) => {
+        let text = START_DEPLOY_WEBSITE_POINTER_RESPONSE;
+        try {
+            // Same path ReadFullDocsArticle takes for this page: the rawdocs article
+            // API, addressed without the .md suffix, header scaffolding stripped.
+            const recipe = await fetchArticleContent(httpClient, START_DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ''), 'article', true, fetchOptions.skillsPortalUrl, fetchOptions.repo, fetchOptions.commitHash);
+            if (recipe && recipe.trim()) {
+                text = startDeployWebsiteResponse(recipe);
+            }
+        }
+        catch (error) {
+            console.warn(`[StartDeployWebsite] recipe fetch failed, returning the pointer:`, error instanceof Error ? error.message : error);
+        }
+        return { content: [{ type: 'text', text }] };
+    });
+}
+//# sourceMappingURL=start-deploy-website.js.map

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 — this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool — call DeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp.");
+            return errorResult("Invalid design URL — this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool — call StartDeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp.");
         }
         if (designUrl.protocol !== 'https:' ||
             !designUrl.hostname.endsWith(CLAUDE_USER_CONTENT_HOST_SUFFIX)) {
-            return errorResult("Invalid design URL — this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool — call DeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp.");
+            return errorResult("Invalid design URL — this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool — call StartDeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp.");
         }
         // 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/toolkit-entry.d.cts

@@ -127,8 +127,8 @@ export interface ReadmeDocConfig {
 export interface DocsToolsOptions {
 	getToKnowWixEnabled?: boolean;
 	createWixBusinessGuideEnabled?: boolean;
-	/** DeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
-	deployWebsiteEnabled?: boolean;
+	/** StartDeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
+	startDeployWebsiteEnabled?: boolean;
 	disableTools?: string[];
 	/** Custom descriptions for tools, keyed by tool name */
 	toolDescriptions?: Record<string, string>;

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

@@ -127,8 +127,8 @@ export interface ReadmeDocConfig {
 export interface DocsToolsOptions {
 	getToKnowWixEnabled?: boolean;
 	createWixBusinessGuideEnabled?: boolean;
-	/** DeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
-	deployWebsiteEnabled?: boolean;
+	/** StartDeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
+	startDeployWebsiteEnabled?: boolean;
 	disableTools?: string[];
 	/** Custom descriptions for tools, keyed by tool name */
 	toolDescriptions?: Record<string, string>;

package/build/esm/index.js

@@ -30928,7 +30928,7 @@ function buildSystemReminderGuidelines(includeReadme, includeImageUploadGuidance
       "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 \u2014 creating a new Wix site/website:** For a normal creation request \u2014 and only then \u2014 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 \u2014 these don't need the site's purpose first.",
-      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call DeployWebsite right away \u2014 not a site-creation tool, not the docs.",
+      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call StartDeployWebsite right away \u2014 not a site-creation tool, not the docs.",
       "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."
     );
   }
@@ -31010,7 +31010,7 @@ 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: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call DeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
+  One case skips all of this: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call StartDeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
 
   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.
@@ -31402,7 +31402,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
   `,
     "import-claude-design-from-url": dedent_default`
     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 a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call DeployWebsite instead; it returns the recipe to publish the files yourself.
+    NOT for a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call StartDeployWebsite instead; it returns the recipe to publish the files yourself.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -31884,7 +31884,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     Results: each root field fails independently — \`errors[].path\` names the failing field and \`errors[].extensions.message\` the cause (e.g. PERMISSION_DENIED); \`data\` still holds the fields that succeeded. Mutations return the created/updated entity — read the IDs from it and do not re-query to verify. Large results are truncated: narrow the selection or page size instead of re-running.
     Set \`hasMutations: true\` for any document containing a mutation root field.
   `,
-    DeployWebsite: dedent_default`
+    StartDeployWebsite: dedent_default`
     The user — or you, earlier in this conversation — ALREADY HAVE a finished page or site, in any form, and it should be live on Wix: HTML/CSS/JS files, a static build (dist/, out/), a zip, another AI builder's export, or a page/design you created in this conversation (export it to HTML first — a finished design IS a finished page). Call this when the user says deploy, host, publish, put online, make it live, get a URL, or upload my site / index.html.
     Also for updating a site deployed this way (replace its files; same site, same URL) and for implementing a backend on one (stores, bookings, CMS, members) as a Wix Headless project — same site, same URL. Works with or without a Wix login (anonymous deploy with a save link), through the Wix MCP alone or from a shell.
     Missing real functionality — a fake checkout, a form that goes nowhere, bookings — is NOT a reason to rebuild the site with a site-creation tool: deploy the page as is, then add the backend afterwards (the recipe covers it).
@@ -31894,7 +31894,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 a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call DeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
+    Exception, even when the user says "headless": if a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call StartDeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -33041,39 +33041,42 @@ ${articleContent}${nextSteps}`;
   );
 }
 
-// src/docs/deploy-website.ts
-var DEPLOY_WEBSITE_TOOL_NAME = "DeployWebsite";
-var DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
+// src/docs/start-deploy-website.ts
+var START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION = "A few sentences covering: the user's request (quoted if short); what the site is \u2014 its purpose and who it is for \u2014 and its current form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design created in this conversation), roughly how many files, and whether it includes images; what the site must be able to do for its visitors beyond showing pages, if anything \u2014 selling, bookings or reservations, tickets, menus and orders, rentals, forms, memberships or paid plans, donations, a blog, or anything else the user expects to work \u2014 described in your own words, or a note that it is a plain static site with no such needs; which agent or product you are and the harness you run in.";
+var START_DEPLOY_WEBSITE_TOOL_NAME = "StartDeployWebsite";
+var START_DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
 var DROP_PAGE_URL = "https://www.wix.com/headless/drop?utm_campaign=mcp";
 var FALLBACK_LINE = `Only if you cannot run it (you can't reach the file bytes, or a step fails and you can't fix it): send the user to ${DROP_PAGE_URL} \u2014 give that URL exactly as written, keeping the utm_campaign=mcp parameter.`;
-function deployWebsiteResponse(recipe) {
+function startDeployWebsiteResponse(recipe) {
   return [
-    `The following is the content of ${DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
+    `The following is the content of ${START_DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
     FALLBACK_LINE,
     "---",
     recipe.trim()
   ].join("\n\n");
 }
-var DEPLOY_WEBSITE_POINTER_RESPONSE = [
-  `Read and follow this recipe end to end: ${DEPLOY_WEBSITE_RECIPE_URL}`,
+var START_DEPLOY_WEBSITE_POINTER_RESPONSE = [
+  `Read and follow this recipe end to end: ${START_DEPLOY_WEBSITE_RECIPE_URL}`,
   "It covers creating the site and uploading the files (with or without a Wix login), updating a site deployed this way, and implementing a backend on it (stores, bookings, CMS, members) as a Wix Headless project. Do the publishing yourself \u2014 do not hand the user instructions.",
   FALLBACK_LINE
 ].join("\n\n");
-function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
-  if (disableTools.includes(DEPLOY_WEBSITE_TOOL_NAME)) {
+function addStartDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
+  if (disableTools.includes(START_DEPLOY_WEBSITE_TOOL_NAME)) {
     return;
   }
   server.tool(
-    DEPLOY_WEBSITE_TOOL_NAME,
-    toolDescriptions?.[DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[DEPLOY_WEBSITE_TOOL_NAME],
-    {},
+    START_DEPLOY_WEBSITE_TOOL_NAME,
+    toolDescriptions?.[START_DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[START_DEPLOY_WEBSITE_TOOL_NAME],
+    {
+      brief: external_exports.string().min(1).describe(START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION)
+    },
     { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
     async (_args, { httpClient: httpClient6 }) => {
-      let text = DEPLOY_WEBSITE_POINTER_RESPONSE;
+      let text = START_DEPLOY_WEBSITE_POINTER_RESPONSE;
       try {
         const recipe = await fetchArticleContent(
           httpClient6,
-          DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
+          START_DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
           "article",
           true,
           fetchOptions.skillsPortalUrl,
@@ -33081,11 +33084,11 @@ function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetch
           fetchOptions.commitHash
         );
         if (recipe && recipe.trim()) {
-          text = deployWebsiteResponse(recipe);
+          text = startDeployWebsiteResponse(recipe);
         }
       } catch (error2) {
         console.warn(
-          `[DeployWebsite] recipe fetch failed, returning the pointer:`,
+          `[StartDeployWebsite] recipe fetch failed, returning the pointer:`,
           error2 instanceof Error ? error2.message : error2
         );
       }
@@ -33153,7 +33156,7 @@ var addDocsTools = (server, allowedTools = [
   const {
     getToKnowWixEnabled = false,
     createWixBusinessGuideEnabled = true,
-    deployWebsiteEnabled = true,
+    startDeployWebsiteEnabled = true,
     disableTools,
     toolDescriptions,
     readmeDocs,
@@ -33219,8 +33222,8 @@ var addDocsTools = (server, allowedTools = [
       cliEnabled
     );
   }
-  if (deployWebsiteEnabled) {
-    addDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
+  if (startDeployWebsiteEnabled) {
+    addStartDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
       skillsPortalUrl,
       repo: effectiveRepo,
       commitHash: effectiveCommitHash
@@ -46002,12 +46005,12 @@ function addImportClaudeDesignTool(server, authStrategy, options) {
         designUrl = new URL(args.url);
       } catch {
         return errorResult(
-          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool \u2014 call DeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp."
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool \u2014 call StartDeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp."
         );
       }
       if (designUrl.protocol !== "https:" || !designUrl.hostname.endsWith(CLAUDE_USER_CONTENT_HOST_SUFFIX)) {
         return errorResult(
-          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool \u2014 call DeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp."
+          "Invalid design URL \u2014 this tool only accepts the claudeusercontent.com URL produced by Claude Design. For a page or site that exists in any other form (the user's files, a build, a zip, another builder's export, a page you made), do not retry this tool \u2014 call StartDeployWebsite, which returns the recipe to publish the files yourself. If that tool isn't available: read https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md and publish them yourself, or send the user to https://www.wix.com/headless/drop?utm_campaign=mcp."
         );
       }
       const accountHeaders = await authStrategy.getAccountAuthHeaders();

package/build/esm/toolkit.js

@@ -12124,7 +12124,7 @@ function buildSystemReminderGuidelines(includeReadme, includeImageUploadGuidance
       "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 \u2014 creating a new Wix site/website:** For a normal creation request \u2014 and only then \u2014 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 \u2014 these don't need the site's purpose first.",
-      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call DeployWebsite right away \u2014 not a site-creation tool, not the docs.",
+      "If the user \u2014 or you, earlier in this conversation \u2014 already have a finished page or site in any form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design you can export to HTML) and want it live on Wix, call StartDeployWebsite right away \u2014 not a site-creation tool, not the docs.",
       "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."
     );
   }
@@ -12206,7 +12206,7 @@ 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: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call DeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
+  One case skips all of this: a finished page or site ALREADY EXISTS, in any form — hand-written HTML/CSS/JS, a static build, a zip, another AI builder's export, or a page you made earlier in this conversation. There is nothing to build, so don't offer AI or templates and don't call any site-creation tool: call StartDeployWebsite, which returns the recipe to publish the files yourself (the drop page is only its fallback).
 
   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.
@@ -12598,7 +12598,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
   `,
     "import-claude-design-from-url": dedent_default`
     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 a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call DeployWebsite instead; it returns the recipe to publish the files yourself.
+    NOT for a page or site that exists in any other form (the user's own HTML/CSS/JS, a static build, a zip, another builder's export, a page you made in this conversation) — for those call StartDeployWebsite instead; it returns the recipe to publish the files yourself.
   `,
     RunWixCliCommand: dedent_default`
     Executes Wix CLI commands for Wix app development and management.
@@ -13080,7 +13080,7 @@ function buildToolDescriptions(includeReadme, includeImageUploadGuidance = true)
     Results: each root field fails independently — \`errors[].path\` names the failing field and \`errors[].extensions.message\` the cause (e.g. PERMISSION_DENIED); \`data\` still holds the fields that succeeded. Mutations return the created/updated entity — read the IDs from it and do not re-query to verify. Large results are truncated: narrow the selection or page size instead of re-running.
     Set \`hasMutations: true\` for any document containing a mutation root field.
   `,
-    DeployWebsite: dedent_default`
+    StartDeployWebsite: dedent_default`
     The user — or you, earlier in this conversation — ALREADY HAVE a finished page or site, in any form, and it should be live on Wix: HTML/CSS/JS files, a static build (dist/, out/), a zip, another AI builder's export, or a page/design you created in this conversation (export it to HTML first — a finished design IS a finished page). Call this when the user says deploy, host, publish, put online, make it live, get a URL, or upload my site / index.html.
     Also for updating a site deployed this way (replace its files; same site, same URL) and for implementing a backend on one (stores, bookings, CMS, members) as a Wix Headless project — same site, same URL. Works with or without a Wix login (anonymous deploy with a save link), through the Wix MCP alone or from a shell.
     Missing real functionality — a fake checkout, a form that goes nowhere, bookings — is NOT a reason to rebuild the site with a site-creation tool: deploy the page as is, then add the backend afterwards (the recipe covers it).
@@ -13090,7 +13090,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 a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call DeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
+    Exception, even when the user says "headless": if a finished page or site already exists in any form (their own HTML/CSS/JS, a static build, a zip, an AI-builder export, a page you made in this conversation) and they want it hosted, don't call this tool — call StartDeployWebsite, which returns the recipe to publish the files yourself. This guide's CLI flow is for BUILDING a headless frontend, not for hosting ready-made files.
 
     ## What This Tool Contains
 
@@ -14237,39 +14237,42 @@ ${articleContent}${nextSteps}`;
   );
 }
 
-// src/docs/deploy-website.ts
-var DEPLOY_WEBSITE_TOOL_NAME = "DeployWebsite";
-var DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
+// src/docs/start-deploy-website.ts
+var START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION = "A few sentences covering: the user's request (quoted if short); what the site is \u2014 its purpose and who it is for \u2014 and its current form (HTML/CSS/JS files, a static build, a zip, another builder's export, a design created in this conversation), roughly how many files, and whether it includes images; what the site must be able to do for its visitors beyond showing pages, if anything \u2014 selling, bookings or reservations, tickets, menus and orders, rentals, forms, memberships or paid plans, donations, a blog, or anything else the user expects to work \u2014 described in your own words, or a note that it is a plain static site with no such needs; which agent or product you are and the harness you run in.";
+var START_DEPLOY_WEBSITE_TOOL_NAME = "StartDeployWebsite";
+var START_DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
 var DROP_PAGE_URL = "https://www.wix.com/headless/drop?utm_campaign=mcp";
 var FALLBACK_LINE = `Only if you cannot run it (you can't reach the file bytes, or a step fails and you can't fix it): send the user to ${DROP_PAGE_URL} \u2014 give that URL exactly as written, keeping the utm_campaign=mcp parameter.`;
-function deployWebsiteResponse(recipe) {
+function startDeployWebsiteResponse(recipe) {
   return [
-    `The following is the content of ${DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
+    `The following is the content of ${START_DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself \u2014 do not hand the user instructions.`,
     FALLBACK_LINE,
     "---",
     recipe.trim()
   ].join("\n\n");
 }
-var DEPLOY_WEBSITE_POINTER_RESPONSE = [
-  `Read and follow this recipe end to end: ${DEPLOY_WEBSITE_RECIPE_URL}`,
+var START_DEPLOY_WEBSITE_POINTER_RESPONSE = [
+  `Read and follow this recipe end to end: ${START_DEPLOY_WEBSITE_RECIPE_URL}`,
   "It covers creating the site and uploading the files (with or without a Wix login), updating a site deployed this way, and implementing a backend on it (stores, bookings, CMS, members) as a Wix Headless project. Do the publishing yourself \u2014 do not hand the user instructions.",
   FALLBACK_LINE
 ].join("\n\n");
-function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
-  if (disableTools.includes(DEPLOY_WEBSITE_TOOL_NAME)) {
+function addStartDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
+  if (disableTools.includes(START_DEPLOY_WEBSITE_TOOL_NAME)) {
     return;
   }
   server.tool(
-    DEPLOY_WEBSITE_TOOL_NAME,
-    toolDescriptions?.[DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[DEPLOY_WEBSITE_TOOL_NAME],
-    {},
+    START_DEPLOY_WEBSITE_TOOL_NAME,
+    toolDescriptions?.[START_DEPLOY_WEBSITE_TOOL_NAME] ?? defaultToolDescriptions[START_DEPLOY_WEBSITE_TOOL_NAME],
+    {
+      brief: external_exports.string().min(1).describe(START_DEPLOY_WEBSITE_BRIEF_DESCRIPTION)
+    },
     { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
     async (_args, { httpClient }) => {
-      let text = DEPLOY_WEBSITE_POINTER_RESPONSE;
+      let text = START_DEPLOY_WEBSITE_POINTER_RESPONSE;
       try {
         const recipe = await fetchArticleContent(
           httpClient,
-          DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
+          START_DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ""),
           "article",
           true,
           fetchOptions.skillsPortalUrl,
@@ -14277,11 +14280,11 @@ function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetch
           fetchOptions.commitHash
         );
         if (recipe && recipe.trim()) {
-          text = deployWebsiteResponse(recipe);
+          text = startDeployWebsiteResponse(recipe);
         }
       } catch (error) {
         console.warn(
-          `[DeployWebsite] recipe fetch failed, returning the pointer:`,
+          `[StartDeployWebsite] recipe fetch failed, returning the pointer:`,
           error instanceof Error ? error.message : error
         );
       }
@@ -14338,7 +14341,7 @@ var addDocsTools = (server, allowedTools = [
   const {
     getToKnowWixEnabled = false,
     createWixBusinessGuideEnabled = true,
-    deployWebsiteEnabled = true,
+    startDeployWebsiteEnabled = true,
     disableTools,
     toolDescriptions,
     readmeDocs,
@@ -14404,8 +14407,8 @@ var addDocsTools = (server, allowedTools = [
       cliEnabled
     );
   }
-  if (deployWebsiteEnabled) {
-    addDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
+  if (startDeployWebsiteEnabled) {
+    addStartDeployWebsiteTool(server, disableTools || [], toolDescriptions, {
       skillsPortalUrl,
       repo: effectiveRepo,
       commitHash: effectiveCommitHash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/mcp",
-  "version": "1.0.90",
+  "version": "1.0.91",
   "description": "A Model Context Protocol server for Wix AI tools",
   "bin": "./build/bin-standalone.js",
   "dependencies": {
@@ -133,5 +133,5 @@
       ]
     }
   },
-  "falconPackageHash": "d562cd11d61654cd119a10a3385e83892fd93dcb6ed41d7d119bc2e4"
+  "falconPackageHash": "c5d7f7479d90baedf03a7fc23cfb7166fe5c4ce1d88c647d3027e414"
 }

package/build/dts/docs/deploy-website.d.ts

@@ -1,13 +0,0 @@
-import { WixMcpServer } from '../wix-mcp-server.js';
-export declare const DEPLOY_WEBSITE_TOOL_NAME = "DeployWebsite";
-export declare const DEPLOY_WEBSITE_RECIPE_URL = "https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md";
-export declare const DROP_PAGE_URL = "https://www.wix.com/headless/drop?utm_campaign=mcp";
-export declare function deployWebsiteResponse(recipe: string): string;
-export declare const DEPLOY_WEBSITE_POINTER_RESPONSE: string;
-export interface DeployWebsiteFetchOptions {
-    skillsPortalUrl?: string;
-    repo?: string;
-    commitHash?: string;
-}
-export declare function addDeployWebsiteTool(server: WixMcpServer, disableTools?: string[], toolDescriptions?: Record<string, string>, fetchOptions?: DeployWebsiteFetchOptions): void;
-//# sourceMappingURL=deploy-website.d.ts.map

package/build/dts/docs/deploy-website.js

@@ -1,45 +0,0 @@
-import { defaultToolDescriptions } from '../config/default-config.js';
-import { fetchArticleContent } from './fetch-article.js';
-export const DEPLOY_WEBSITE_TOOL_NAME = 'DeployWebsite';
-export const DEPLOY_WEBSITE_RECIPE_URL = 'https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md';
-export const DROP_PAGE_URL = 'https://www.wix.com/headless/drop?utm_campaign=mcp';
-const FALLBACK_LINE = `Only if you cannot run it (you can't reach the file bytes, or a step fails and you can't fix it): send the user to ${DROP_PAGE_URL} — give that URL exactly as written, keeping the utm_campaign=mcp parameter.`;
-// The tool exists to take the agent's attention at routing time; the work itself
-// is the recipe, so the response IS the recipe — fetched live and returned whole,
-// so the agent never has to decide whether to go read it.
-export function deployWebsiteResponse(recipe) {
-    return [
-        `The following is the content of ${DEPLOY_WEBSITE_RECIPE_URL}. Follow it end to end and do the publishing yourself — do not hand the user instructions.`,
-        FALLBACK_LINE,
-        '---',
-        recipe.trim()
-    ].join('\n\n');
-}
-// When the recipe can't be fetched, the pointer still routes correctly.
-export const DEPLOY_WEBSITE_POINTER_RESPONSE = [
-    `Read and follow this recipe end to end: ${DEPLOY_WEBSITE_RECIPE_URL}`,
-    'It covers creating the site and uploading the files (with or without a Wix login), updating a site deployed this way, and implementing a backend on it (stores, bookings, CMS, members) as a Wix Headless project. Do the publishing yourself — do not hand the user instructions.',
-    FALLBACK_LINE
-].join('\n\n');
-export function addDeployWebsiteTool(server, disableTools = [], toolDescriptions, fetchOptions = {}) {
-    if (disableTools.includes(DEPLOY_WEBSITE_TOOL_NAME)) {
-        return;
-    }
-    server.tool(DEPLOY_WEBSITE_TOOL_NAME, toolDescriptions?.[DEPLOY_WEBSITE_TOOL_NAME] ??
-        defaultToolDescriptions[DEPLOY_WEBSITE_TOOL_NAME], {}, { readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async (_args, { httpClient }) => {
-        let text = DEPLOY_WEBSITE_POINTER_RESPONSE;
-        try {
-            // Same path ReadFullDocsArticle takes for this page: the rawdocs article
-            // API, addressed without the .md suffix, header scaffolding stripped.
-            const recipe = await fetchArticleContent(httpClient, DEPLOY_WEBSITE_RECIPE_URL.replace(/\.md$/, ''), 'article', true, fetchOptions.skillsPortalUrl, fetchOptions.repo, fetchOptions.commitHash);
-            if (recipe && recipe.trim()) {
-                text = deployWebsiteResponse(recipe);
-            }
-        }
-        catch (error) {
-            console.warn(`[DeployWebsite] recipe fetch failed, returning the pointer:`, error instanceof Error ? error.message : error);
-        }
-        return { content: [{ type: 'text', text }] };
-    });
-}
-//# sourceMappingURL=deploy-website.js.map