@wix/mcp 1.0.89 → 1.0.90

package/build/dts/config/param-descriptions.js

@@ -107,7 +107,8 @@ export const paramDescriptions = {
     },
     ReadFullDocsArticle: {
         articleUrl: 'The URL of the docs article or method article to fetch. Should be something like https://dev.wix.com/docs/.../...' +
-            ' For REST docs, use the URL as-is. For SDK docs, the URL SHOULD include the query param ?apiView=SDK (e.g. https://dev.wix.com/docs/...?apiView=SDK).'
+            ' For REST docs, use the URL as-is. For SDK docs, the URL SHOULD include the query param ?apiView=SDK (e.g. https://dev.wix.com/docs/...?apiView=SDK).' +
+            ' Wix skills pages (https://www.wix.com/skills/..., https://dev.wix.com/docs/skills/...) are read as-is, including their referenced files.'
     },
     ReadFullDocsMethodSchema: {
         articleUrl: 'The URL of the documentation to fetch. Should be something like https://dev.wix.com/docs/.../...' +

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

@@ -0,0 +1,13 @@
+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

@@ -0,0 +1,45 @@
+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

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

@@ -19,6 +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;
     disableTools?: string[];
     /** Custom descriptions for tools, keyed by tool name */
     toolDescriptions?: Record<string, string>;

package/build/dts/docs/docs.js

@@ -2,12 +2,13 @@ import { z } from 'zod';
 import { runSemanticSearchAndFormat } from './semanticSearch.js';
 import { logger } from '../infra/logger.js';
 import { captureException } from '@sentry/node';
-import { fetchArticleContent } from './fetch-article.js';
+import { fetchArticleContent, isSkillsRegistryUrl } from './fetch-article.js';
 import { normalizeMenuContent, summarizeLargeMenu, fetchMenuContent, MENU_CONTENT_THRESHOLD } from './normalize-menu-content.js';
 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 { defaultToolDescriptions } from '../config/default-config.js';
 import { desc } from '../config/param-descriptions.js';
 import dedent from 'dedent';
@@ -67,7 +68,7 @@ export const addDocsTools = (server, allowedTools = [
     'CLI',
     'OVERVIEW'
 ], options = {}) => {
-    const { getToKnowWixEnabled = false, createWixBusinessGuideEnabled = true, disableTools, toolDescriptions, readmeDocs, authStrategy, skillsPortalUrl, skillsRepo, repo, skillsPr, commitHash, skillsTags, dynamicContextEnabled, cliEnabled = false, usePlatformizedSearch = true, usePlatformizedBrowse = true } = 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 effectiveRepo = repo ?? skillsRepo;
     const effectiveCommitHash = commitHash ?? skillsPr;
     // Helper to get description (custom or default)
@@ -123,6 +124,15 @@ export const addDocsTools = (server, allowedTools = [
         !disableTools?.includes('CreateWixBusinessGuide')) {
         addCreateWixBusinessGuideTools(server, disableTools || [], toolDescriptions, cliEnabled);
     }
+    // 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, {
+            skillsPortalUrl,
+            repo: effectiveRepo,
+            commitHash: effectiveCommitHash
+        });
+    }
     // WDS Documentation
     if (allowedTools.includes('WDS') &&
         !disableTools?.includes('SearchWixWDSDocumentation')) {
@@ -622,17 +632,20 @@ export const addDocsTools = (server, allowedTools = [
                 articleUrl: z.string().url().describe(d.articleUrl)
             };
         })(), { readOnlyHint: true, destructiveHint: false, openWorldHint: false }, async ({ articleUrl }, { httpClient }) => {
-            // URL validation: only allow known docs prefixes
+            // URL validation: known docs prefixes, or a Wix skills registry page
+            // (https://www.wix.com/skills/..., https://dev.wix.com/docs/skills/...).
             const validPrefixes = ['https://dev.wix.com/docs/'];
             if (skillsPortalUrl)
                 validPrefixes.push(skillsPortalUrl);
-            if (!validPrefixes.some((p) => articleUrl.startsWith(p))) {
+            const isSkillsPage = isSkillsRegistryUrl(articleUrl);
+            if (!isSkillsPage &&
+                !validPrefixes.some((p) => articleUrl.startsWith(p))) {
                 return {
                     isError: true,
                     content: [
                         {
                             type: 'text',
-                            text: `Invalid article URL: must start with https://dev.wix.com/docs/. Got: "${articleUrl}"`
+                            text: `Invalid article URL: must start with https://dev.wix.com/docs/, or be a Wix skills page (https://www.wix.com/skills/...). Got: "${articleUrl}"`
                         }
                     ]
                 };
@@ -640,8 +653,9 @@ export const addDocsTools = (server, allowedTools = [
             // Every docs page has a .md twin whose menu pages link children WITH
             // the .md suffix, so agents that navigated the .md tree pass .md URLs
             // here — which 404 in get-article-content. Read the canonical page.
-            // (dev.wix.com only: on the skills portal .md is the real path.)
-            if (articleUrl.startsWith('https://dev.wix.com/docs/')) {
+            // (dev.wix.com docs only: on the skills registry .md is the real path.)
+            if (!isSkillsPage &&
+                articleUrl.startsWith('https://dev.wix.com/docs/')) {
                 articleUrl = articleUrl.replace(/\.md$/, '');
             }
             try {

package/build/dts/docs/fetch-article.d.ts

@@ -35,5 +35,6 @@ export declare function fetchRecipesIndex(): Promise<string>;
  * ```
  */
 export declare function fetchArticle(articleUrl: string): Promise<string>;
+export declare function isSkillsRegistryUrl(url: string): boolean;
 export declare function fetchArticleContent(httpClient: HttpClient, articleUrl: string, mode: 'article' | 'methodSchema' | 'raw', stripHeader?: boolean, skillsPortalUrl?: string, repo?: string, commitHash?: string, fetchMcpWhiteList?: boolean): Promise<string>;
 //# sourceMappingURL=fetch-article.d.ts.map

package/build/dts/docs/fetch-article.js

@@ -50,6 +50,38 @@ export async function fetchArticle(articleUrl) {
 // Internal implementation
 // ---------------------------------------------------------------------------
 const DOCS_URL_PREFIX = 'https://dev.wix.com/docs/';
+/**
+ * The Wix skills registry serves agent skills (SKILL.md and bundled files)
+ * as raw markdown straight from the `wix/skills` repo, on every host the
+ * gateway maps to it. Pages there are not docs articles: the rawdocs
+ * get-article-content API does not know them, and `.md` is a real path, so
+ * they are fetched as-is.
+ */
+const SKILLS_REGISTRY_URL = new RegExp('^https://(?:dev\\.wix\\.com(?:/docs)?|www\\.wix\\.com(?:/velo/reference)?)/skills(?:[/.?#]|$)');
+export function isSkillsRegistryUrl(url) {
+    return SKILLS_REGISTRY_URL.test(url.trim());
+}
+async function fetchSkillsRegistryPage(httpClient, url) {
+    let data;
+    try {
+        ({ data } = await httpClient.get(url, {
+            headers: { accept: 'text/markdown, text/plain;q=0.9, */*;q=0.1' }
+        }));
+    }
+    catch (error) {
+        const { message, status } = getHttpErrorDetails(error);
+        const statusSuffix = status ? ` (status ${status})` : '';
+        throw new Error(`${message}${statusSuffix}`);
+    }
+    if (typeof data !== 'string') {
+        // The manifest endpoint is JSON; anything else is text.
+        return JSON.stringify(data, null, 2);
+    }
+    if (!data.trim()) {
+        throw new Error('Article content is empty');
+    }
+    return data;
+}
 function getResponseErrorMessage(data) {
     if (!data) {
         return undefined;
@@ -152,10 +184,16 @@ export async function fetchArticleContent(httpClient, articleUrl, mode, stripHea
         }
         catch (error) {
             console.warn(`[fetch] Override failed for ${effectiveUrl}, falling back to ${articleUrl}:`, error instanceof Error ? error.message : error);
-            // Fall through to normal fetch
-            content = await fetchArticleContentFromDigor(httpClient, articleUrl, mode, stripHeader);
+            // Fall through to the normal fetch for this URL: the registry for a
+            // skills page (rawdocs cannot serve those), rawdocs otherwise.
+            content = isSkillsRegistryUrl(articleUrl)
+                ? await fetchSkillsRegistryPage(httpClient, articleUrl)
+                : await fetchArticleContentFromDigor(httpClient, articleUrl, mode, stripHeader);
         }
     }
+    else if (isSkillsRegistryUrl(articleUrl)) {
+        content = await fetchSkillsRegistryPage(httpClient, articleUrl);
+    }
     else if (mode === 'raw') {
         let parsedUrl;
         try {

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 site files the user provided themselves, do not retry this tool. For a full agentic flow, read the recipe and publish the files yourself: https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md — it covers creating the site and uploading the files end to end. If you can't follow it, or it doesn't apply, send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site.");
+            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.");
         }
         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 site files the user provided themselves, do not retry this tool. For a full agentic flow, read the recipe and publish the files yourself: https://dev.wix.com/docs/api-reference/account-level/sites/skills/upload-a-website-or-html-files.md — it covers creating the site and uploading the files end to end. If you can't follow it, or it doesn't apply, send the user to https://www.wix.com/headless/drop?utm_campaign=mcp to upload them and get a live hosted site.");
+            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.");
         }
         // 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,6 +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;
 	disableTools?: string[];
 	/** Custom descriptions for tools, keyed by tool name */
 	toolDescriptions?: Record<string, string>;

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

@@ -127,6 +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;
 	disableTools?: string[];
 	/** Custom descriptions for tools, keyed by tool name */
 	toolDescriptions?: Record<string, string>;