@wix/mcp 1.0.93 → 1.0.95

package/build/dts/config/file-params.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Client file parameters: the tool params listed under `_meta["openai/fileParams"]`
+ * (UploadImageToWixSite `image`, UploadHeadlessWebsiteFiles and ExecuteWixAPI
+ * `attachments`). The client swaps a file the agent has for a download URL before
+ * the call reaches us; every other client sends the agent's value unchanged, a path
+ * we can't read. Every file param describes itself with fileParamNote(), so the
+ * same warning keeps agents in other clients out of it.
+ *
+ * Recheck Claude: as of 2026-10 claude.ai, Claude Desktop, Cowork and Claude Code
+ * ignore `openai/fileParams` and have no other way to hand a file to a remote tool.
+ * The MCP files extension (`io.modelcontextprotocol/files`,
+ * modelcontextprotocol/experimental-ext-file-uploads#1, opened 2026-10-14, with an
+ * Anthropic-led working group) is the likely route. When Claude supports a file
+ * handoff: declare it on these params, add Claude to FILE_PARAM_CLIENTS, and rethink
+ * PickImagesForWixMedia (site-widget-tools/pick-images-tool), which exists only
+ * because Claude can't pass files.
+ */
+/** The clients that do the file swap. */
+export declare const FILE_PARAM_CLIENTS = "OpenAI clients (ChatGPT, Codex)";
+/** The warning a file param opens with, ending in what to do in other clients. */
+export declare function fileParamNote(otherwise: string): string;
+//# sourceMappingURL=file-params.d.ts.map

package/build/dts/config/file-params.js

@@ -0,0 +1,24 @@
+/**
+ * Client file parameters: the tool params listed under `_meta["openai/fileParams"]`
+ * (UploadImageToWixSite `image`, UploadHeadlessWebsiteFiles and ExecuteWixAPI
+ * `attachments`). The client swaps a file the agent has for a download URL before
+ * the call reaches us; every other client sends the agent's value unchanged, a path
+ * we can't read. Every file param describes itself with fileParamNote(), so the
+ * same warning keeps agents in other clients out of it.
+ *
+ * Recheck Claude: as of 2026-10 claude.ai, Claude Desktop, Cowork and Claude Code
+ * ignore `openai/fileParams` and have no other way to hand a file to a remote tool.
+ * The MCP files extension (`io.modelcontextprotocol/files`,
+ * modelcontextprotocol/experimental-ext-file-uploads#1, opened 2026-10-14, with an
+ * Anthropic-led working group) is the likely route. When Claude supports a file
+ * handoff: declare it on these params, add Claude to FILE_PARAM_CLIENTS, and rethink
+ * PickImagesForWixMedia (site-widget-tools/pick-images-tool), which exists only
+ * because Claude can't pass files.
+ */
+/** The clients that do the file swap. */
+export const FILE_PARAM_CLIENTS = 'OpenAI clients (ChatGPT, Codex)';
+/** The warning a file param opens with, ending in what to do in other clients. */
+export function fileParamNote(otherwise) {
+    return `${FILE_PARAM_CLIENTS} only: pass each file as you have it (attached in the chat or created in your sandbox, by its file id or path) and the client swaps it for { download_url, file_id, file_name?, mime_type? } before the call reaches Wix. No other client does this swap, so elsewhere a path or file:// URL here fails at once; leave this out and ${otherwise}.`;
+}
+//# sourceMappingURL=file-params.js.map

package/build/dts/config/param-descriptions.d.ts

@@ -1,7 +1,9 @@
 /**
- * Centralized parameter descriptions organized by tool.
- * Each tool has all its parameter descriptions in one place.
+ * The end of `whyNotExecuteWixAPI` where the server serves ExecuteWixAPI; `addApiCallTool` swaps it
+ * for `WHY_NOT_EXECUTE_NO_EXECUTE` where ExecuteWixAPI is off on purpose.
  */
+export declare const WHY_NOT_EXECUTE_RECONNECT = "if the Wix MCP doesn't offer it at all, say so here, and tell the user once that their Wix connection may be an old or cached version that a reconnect refreshes.";
+export declare const WHY_NOT_EXECUTE_NO_EXECUTE = "if it isn't in your tool list, say so.";
 export declare const paramDescriptions: {
     CallWixSiteAPI: {
         siteId: string;
@@ -9,6 +11,7 @@ export declare const paramDescriptions: {
         method: string;
         body: string;
         reason: string;
+        whyNotExecuteWixAPI: string;
         sourceDocUrl: string;
     };
     ListWixSites: {
@@ -29,6 +32,10 @@ export declare const paramDescriptions: {
     ExecuteWixAPI: {
         sourceDocUrls: string;
     };
+    ReportIssueToWix: {
+        message: string;
+        requestId: string;
+    };
     SupportAndFeedback: {
         message: string;
         requestId: string;
@@ -71,6 +78,11 @@ export declare const paramDescriptions: {
         maxResults: string;
         reason: string;
     };
+    SearchWixHelpCenter: {
+        searchTerm: string;
+        maxResults: string;
+        reason: string;
+    };
     ReadFullDocsArticle: {
         articleUrl: string;
     };

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

@@ -1,9 +1,29 @@
 import { ALLOWED_HOSTNAMES } from '../api-call/validation.js';
+import { fileParamNote } from './file-params.js';
 import { ARRAY_QUERY_PARAMS_RULE, WQL_FILTER_RULE } from './api-request-rules.js';
 /**
  * Centralized parameter descriptions organized by tool.
  * Each tool has all its parameter descriptions in one place.
  */
+const REPORT_ISSUE_TO_WIX_PARAMS = {
+    message: [
+        'The report of one issue, sent to Wix as free text. Only this issue — no session summary, play-by-play or unrelated problems:',
+        '- What was being attempted, in a sentence.',
+        '- The tool or endpoint, the HTTP status and the error message.',
+        '- What you expected instead, and the workaround if any.',
+        '- Where the fault likely lives (API behavior / API schema / docs / Wix tooling / unsure), and whether you confirmed it.',
+        '- The context needed to reproduce it: agent/model, site id, the Wix area or API.',
+        "- The user's own words, verbatim, if they added any.",
+        'NEVER include secrets — no bearer tokens, API keys, or credentials — and no personal data beyond what the report needs.'
+    ].join('\n'),
+    requestId: 'Optional request id (x-wix-request-id) of the failed Wix API call this report is about.'
+};
+/**
+ * The end of `whyNotExecuteWixAPI` where the server serves ExecuteWixAPI; `addApiCallTool` swaps it
+ * for `WHY_NOT_EXECUTE_NO_EXECUTE` where ExecuteWixAPI is off on purpose.
+ */
+export const WHY_NOT_EXECUTE_RECONNECT = "if the Wix MCP doesn't offer it at all, say so here, and tell the user once that their Wix connection may be an old or cached version that a reconnect refreshes.";
+export const WHY_NOT_EXECUTE_NO_EXECUTE = "if it isn't in your tool list, say so.";
 export const paramDescriptions = {
     CallWixSiteAPI: {
         siteId: 'The id of the site selected using site selection tool',
@@ -20,6 +40,7 @@ export const paramDescriptions = {
             WQL_FILTER_RULE
         ].join('\n'),
         reason: 'One sentence explaining the original user request and why you are calling this API to complete it.',
+        whyNotExecuteWixAPI: `One sentence: why this call goes through CallWixSiteAPI and not ExecuteWixAPI, the preferred tool. If ExecuteWixAPI isn't loaded, load it through your client's tool search before calling this tool; ${WHY_NOT_EXECUTE_RECONNECT}`,
         sourceDocUrl: [
             'The URL of the documentation or recipe where you found this API endpoint.',
             'MAKE SURE THE ENDPOINT URL IS REALLY THERE AND YOUR ARE NOT GUESSING IT !!!',
@@ -55,18 +76,9 @@ export const paramDescriptions = {
             'Use ["other"] ONLY IF YOU HAVE A VERY GOOD REASON TO DO SO'
         ].join('\n')
     },
-    SupportAndFeedback: {
-        message: [
-            'The composed feedback message to send to Wix. Wix receives only free text, so a bare sentence is low-signal — send a summary of the whole session, not just the last error. Structure it in three layers:',
-            '1. Provenance — labelled lines (omit ones that do not apply): agent/model, Wix tooling used, Wix areas/APIs touched, Wix products (stores, bookings, ...), site id, relevant links (dashboard, docs pages read, live site) and other ids created this run.',
-            '2. Narrative — "In the user\'s words": anything the user added when you offered, quoted verbatim (redact secrets only). Then user intent + run summary (what they set out to build, what worked vs. what fought back), a condensed play-by-play of the session (key exchanges, tool calls, decisions), and the friction points — every place something got in the way, each with specifics: the step/endpoint, HTTP status and error message, the gap, the workaround, and what you expected instead. Include issues you recovered from.',
-            '3. Attribution — for each significant friction point, your best diagnosis of where the fault lives: API behavior / API schema / API reference docs / docs articles or examples / Wix tooling (MCP tools, auth flow) / other-unsure — plus whether you confirmed it or are assuming. Do not force a tag; "unsure" beats a wrong route.',
-            'End with a bottom line: one or two sentences naming the single most important problem and its impact — a concise engineering assessment, not softened or hedged.',
-            'Write it as a scannable few paragraphs or a short bulleted list — thorough on the friction, distilled rather than a transcript dump.',
-            'NEVER include secrets — no bearer tokens, API keys, or credentials — and no personal data beyond what the feedback needs.'
-        ].join('\n'),
-        requestId: 'Optional request id (x-wix-request-id) returned from a failed Wix API call this feedback relates to.'
-    },
+    ReportIssueToWix: REPORT_ISSUE_TO_WIX_PARAMS,
+    // The tool's former name, kept for importers that read it by that key.
+    SupportAndFeedback: REPORT_ISSUE_TO_WIX_PARAMS,
     SearchWixWDSDocumentation: {
         searchTerm: 'The search term to search for in the Wix Design System Documentation',
         maxResults: 'The maximum number of results to return, default is 10, max is 15'
@@ -105,10 +117,17 @@ export const paramDescriptions = {
         maxResults: 'The maximum number of results to return, default is 10, max is 15',
         reason: 'One sentence describing the original user request and the task you are trying to accomplish with this search.'
     },
+    SearchWixHelpCenter: {
+        searchTerm: 'What the site owner wants to do or fix, in plain words (e.g. "connect a domain bought elsewhere", "cancel a Premium plan")',
+        maxResults: 'The maximum number of articles to return (1–15, default 15). Each article is returned with up to 60 lines.',
+        reason: 'One sentence describing the original user request and the task you are trying to accomplish with this search.'
+    },
     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).' +
-            ' Wix skills pages (https://www.wix.com/skills/..., https://dev.wix.com/docs/skills/...) are read as-is, including their referenced files.'
+            ' Wix Help Center articles (https://support.wix.com/en/article/...) are read as-is.' +
+            ' Wix skills pages (https://www.wix.com/skills/..., https://dev.wix.com/docs/skills/...) and Wix Headless agent pages (https://www.wix.com/headless/..., e.g. https://www.wix.com/headless/skill.md) are read as-is, including their referenced files.' +
+            ' Source links (https://dev.wix.com/rawdocs/api/get-source-content?repo=...&path=...) found in skills and recipes are read as-is.'
     },
     ReadFullDocsMethodSchema: {
         articleUrl: 'The URL of the documentation to fetch. Should be something like https://dev.wix.com/docs/.../...' +
@@ -125,7 +144,7 @@ export const paramDescriptions = {
     },
     UploadImageToWixSite: {
         siteId: 'The ID (UUID) of the Wix site to upload to. REQUIRED. If the user has not clearly specified which site, ASK them which site to upload to (or use ListWixSites to help them pick) BEFORE calling this tool. NEVER call this tool with a missing, empty, placeholder, or guessed siteId — ask first instead.',
-        image: 'Array of file ATTACHMENTS: files the user uploaded in the chat, or files you created in your own file sandbox. Each item requires download_url and file_id, and may optionally include file_name and mime_type — the platform resolves a file passed here into these fields automatically, so just include the files. For plain image URLs the user pasted, use imageUrls instead. ALWAYS pass ALL attachments together in a single call — NEVER call this tool once per image. Do NOT use together with imageBase64.',
+        image: `${fileParamNote('send the image as imageBase64 (the whole file, one per call) or as a public URL in imageUrls')} For plain image URLs the user pasted, use imageUrls instead. ALWAYS pass ALL files together in a single call — NEVER call this tool once per image. Do NOT use together with imageBase64.`,
         imageUrls: 'Array of publicly accessible image URLs (e.g. links the user pasted or URLs produced by other tools). Use this for plain URLs that are NOT chat attachments — no file_id is needed. ALWAYS pass ALL URLs together in a single call. Can be combined with image; do NOT use together with imageBase64.',
         imageBase64: 'Base64-encoded image data. Use when the client can read a file and encode it as base64. May include a data URL prefix (e.g. "data:image/jpeg;base64,...") or be raw base64. Do NOT use together with image.',
         mimeType: 'MIME type of the image (e.g. "image/jpeg", "image/png", "image/webp"). Required when imageBase64 does not include a data URL prefix.',
@@ -149,7 +168,7 @@ export const paramDescriptions = {
         operationName: 'Operation to run when the document defines more than one named operation.',
         siteId: 'The Wix site to run against. Required for site-level operations (anything reading or writing inside a site — products, orders, contacts, bookings, CMS, blog, members ...). Resolve it with GetSiteContext or ListWixSites; never pass a guessed value.',
         scope: '"site" (default when siteId is given) runs with a site-scoped credential; "account" runs account-level operations (sites, account settings) and ignores siteId.',
-        hasMutations: 'Whether this document creates, updates, deletes or otherwise mutates Wix data. True for any mutation root field (in any operation of the document) even when the intent is inspection; false only for pure queries. This flag alone decides whether a transient server error may be retried, so never mark a document that writes as false.',
+        hasMutations: 'True if the document contains a mutation root field in any of its operations; false if it contains only queries. A transient server error is retried only when this is false.',
         reason: 'One sentence explaining the original user request and why you are running this GraphQL operation to complete it.'
     },
     RunWixCliCommand: {

package/build/dts/constants.d.ts

@@ -1,5 +1,6 @@
 export declare const RAW_DOCS_API_URL = "https://dev.wix.com/rawdocs/api";
 export declare const GET_ARTICLE_CONTENT_URL = "https://dev.wix.com/rawdocs/api/get-article-content";
+export declare const GET_SOURCE_CONTENT_URL = "https://dev.wix.com/rawdocs/api/get-source-content";
 export declare const PORTAL_INDEX_URL = "https://dev.wix.com/rawdocs/api/portal-index";
 export declare const DOCS_API_BASE_URL = "https://dev.wix.com/docs/api/v1";
 export declare const GET_SKILLS_BY_PORTAL_URL = "https://dev.wix.com/docs/api/v1/docs-web-app/menu-node/get-skills-by-portal";

package/build/dts/constants.js

@@ -1,5 +1,6 @@
 export const RAW_DOCS_API_URL = 'https://dev.wix.com/rawdocs/api';
 export const GET_ARTICLE_CONTENT_URL = `${RAW_DOCS_API_URL}/get-article-content`;
+export const GET_SOURCE_CONTENT_URL = `${RAW_DOCS_API_URL}/get-source-content`;
 export const PORTAL_INDEX_URL = `${RAW_DOCS_API_URL}/portal-index`;
 export const DOCS_API_BASE_URL = 'https://dev.wix.com/docs/api/v1';
 export const GET_SKILLS_BY_PORTAL_URL = `${DOCS_API_BASE_URL}/docs-web-app/menu-node/get-skills-by-portal`;

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

@@ -1,6 +1,6 @@
 import type { WixMcpServer } from '../wix-mcp-server.js';
 import { McpAuthenticationStrategy } from '../auth/index.js';
-export declare const VALID_DOCS_TOOLS: readonly ["WDS", "REST", "SDK", "BUILD_APPS", "WIX_HEADLESS", "VELO", "BUSINESS_SOLUTIONS", "CLI", "OVERVIEW"];
+export declare const VALID_DOCS_TOOLS: readonly ["WDS", "REST", "SDK", "BUILD_APPS", "WIX_HEADLESS", "VELO", "BUSINESS_SOLUTIONS", "CLI", "OVERVIEW", "HELP_CENTER"];
 export type DocsTool = (typeof VALID_DOCS_TOOLS)[number];
 /**
  * Configuration for a README doc entry
@@ -18,9 +18,12 @@ export interface ReadmeDocConfig {
 }
 export interface DocsToolsOptions {
     getToKnowWixEnabled?: boolean;
+    /** @deprecated CreateWixBusinessGuide was removed (StartHeadlessBuild replaces its headless route); ignored. */
     createWixBusinessGuideEnabled?: boolean;
     /** StartDeployWebsite (publish ready-made site files) — an account-owner flow; off for visitor servers. */
     startDeployWebsiteEnabled?: boolean;
+    /** StartHeadlessBuild (build a new site in code) — an account-owner flow; off for visitor servers. */
+    startHeadlessBuildEnabled?: boolean;
     disableTools?: string[];
     /** Custom descriptions for tools, keyed by tool name */
     toolDescriptions?: Record<string, string>;
@@ -40,17 +43,27 @@ export interface DocsToolsOptions {
     commitHash?: string;
     /** Tags to filter skills by (e.g. ['velo', 'cms']) */
     skillsTags?: string[];
+    /** Append the management recipes list (every recipe by area, each a link to its article) to the end of WixREADME, for every client. Default true; false leaves it out, and the README then points at the wix-manage skill and the public list only. */
+    readmeRecipesIndexEnabled?: boolean;
     /** Enable dynamic context fetch */
     dynamicContextEnabled?: boolean;
     /** Enable partner context section in dynamic context output */
     partnerContextEnabled?: boolean;
-    /** Whether the client is a CLI environment (e.g. Claude Code) where users can run terminal commands.
-     *  Accepts a boolean or a function for lazy evaluation (useful when client name is only known after MCP init). */
+    /** GetSiteContext renders the site's companion app. Off by default: only Aria (via the toolkit) needs it. */
+    includeCompanionApp?: boolean;
+    /** @deprecated Only CreateWixBusinessGuide read it, and that tool was removed; ignored. */
     cliEnabled?: boolean | (() => boolean);
     /** Use the new platformized semantic search API (POST /v1/docs/search) instead of the legacy GET endpoint */
     usePlatformizedSearch?: boolean;
     /** Use the platformized menu browse API (POST /v1/docs/menu/browse) instead of scraping the legacy get-menu-content markdown. Falls back to legacy on transport errors. */
     usePlatformizedBrowse?: boolean;
+    /**
+     * The Mintlify docs site (see ./mintlify-docs.ts). Off by default.
+     * `'mintlify'`: REST and SDK search read the Mintlify KBs, and articles are
+     * read from Mintlify's `.md`. `'mintlify-links'`: search reads today's KBs and
+     * resolves the links in tool output to the Mintlify site.
+     */
+    docsSite?: string;
 }
 export declare const addDocsTools: (server: WixMcpServer, allowedTools?: DocsTool[], options?: DocsToolsOptions) => void;
 //# sourceMappingURL=docs.d.ts.map