@wix/mcp 1.0.0 → 1.0.2

package/README.md

@@ -18,7 +18,7 @@ args: ["/Users/absolute/path/to/repo/dir/."]
 
 ```
 command: node
-args: ["/Users/absolute/path/to/build/index.js"]
+args: ["/Users/absolute/path/to/build/bin.js"]
 ```
 
 # Optional config arguments:
@@ -29,6 +29,9 @@ args: ["/Users/absolute/path/to/build/index.js"]
 ### enable experimental tools:
 `--experimental=WIX_API,CLI_COMMAND` - enable specific experimental tools (disabled by default)
 
+### choose a CLI mode:
+`--cli=wix-one` - specifies to use Wix One CLI mode (if not specified, default CLI mode is used)
+
 ### choose a logger:
 `--logger=mcp` - log to MCP server (default)
 `--logger=file` - log to file (in `~/wix-mcp-log.txt`)
@@ -63,6 +66,11 @@ It's exactly parallel to the real docs url, for example:
 Docs URL: https://dev.wix.com/docs/picasso/wix-ai-docs/best-practices/sdk-best-practices
 Resource URI: wix-docs://picasso/wix-ai-docs/best-practices/sdk-best-practices
 
+pass:
+`--portals=<docs-portal-name>`
+to load all docs from the portal as resources
+
+
 # Cursor
 
 ## Cursor MCP docs:
@@ -78,9 +86,10 @@ https://docs.cursor.com/context/model-context-protocol
 ```
 {
   "mcpServers": {
-    "IGOR_TOOLS": {
+    "wix-local-mcp": {
       "command": "npx",
       "args": [
+        "-y",
         "@wix/mcp"
       ]
     }
@@ -92,7 +101,7 @@ https://docs.cursor.com/context/model-context-protocol
 ```
 {
   "mcpServers": {
-    "IGOR_TOOLS": {
+    "wix-local-mcp": {
       "command": "npx",
       "args": [
         "/Users/absolute/path/to/repo/dir/."
@@ -110,10 +119,10 @@ https://docs.cursor.com/context/model-context-protocol
 ```
 {
   "mcpServers": {
-    "IGOR_TOOLS": {
+    "wix-local-mcp": {
       "command": "node",
       "args": [
-        "/Users/absolute/path/to/build/index.js"
+        "/Users/absolute/path/to/build/bin.js"
       ]
     }
   }
@@ -123,7 +132,9 @@ https://docs.cursor.com/context/model-context-protocol
 ### You can try using bun + index.ts 
 
 # Troubleshooting
-
+- check the logs from claude desktop / cursor
+- is the error related to node / fnm / nvm ? make sure you have the latest node version as the default on in the path
+- is the error related to npx? make sure you use -y and the correct npm registry
 - try including full path to node
 - try using bun and index.ts directly
 - make sure build files have permissions for cursor to access

package/bin.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import './build/index.js';
+import './build/bin.js';

package/build/api-call/index.d.ts

@@ -0,0 +1,2 @@
+import { WixMcpServer } from '../wix-mcp-server.js';
+export declare function addApiCallTool(server: WixMcpServer, getSiteAccessToken: (siteId: string) => Promise<string>, getAccountAccessToken: () => Promise<string>): void;

package/build/api-call/index.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+import { logger } from '../logger.js';
+import { handleWixAPIResponse } from '../tool-utils.js';
+export function addApiCallTool(server, getSiteAccessToken, getAccountAccessToken) {
+    server.tool('CallWixSiteAPI', 'Call Wix apis on a business or site. Use this to create, read, update, and delete data and other Wix entities in your Wix site,' +
+        `You should ALWAYS check the rest docs - "SearchWixRESTDocumentation" for the specific API you want to call, don't just call it without knowing what it does, CHECK THE DOCS`, {
+        siteId: z
+            .string()
+            .describe('The id of the site selected using site selection tool'),
+        url: z
+            .string()
+            .describe('The url of the api to call - ALWAYS get the information from the Wix REST docs or from the conversation context, the URL MUST BE ABSOLUTE URL'),
+        method: z
+            .string()
+            .describe('The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)'),
+        body: z
+            .string()
+            .optional()
+            .describe('A string representing of a valid JSON object to describe the body of the request')
+    }, async ({ url, body, method, siteId }) => {
+        logger.log(`Calling Wix Site API: ${siteId} ${url}, body: ${JSON.stringify(body)}`);
+        const authorization = await getSiteAccessToken(siteId);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: authorization,
+                    ...(body ? { 'Content-Type': 'application/json' } : {})
+                },
+                body: method === 'GET' ? undefined : body
+            });
+            const responseData = await handleWixAPIResponse(response);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Wix Site API call successful: ${JSON.stringify(responseData)}`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            logger.error(`Failed to call Wix Site API: ${error}`);
+            throw new Error(`Failed to call Wix Site API: ${error}`);
+        }
+    });
+    server.tool('ListWixSites', 'List Wix sites for the current user', async () => {
+        const sitesRes = await fetch('https://www.wixapis.com/site-list/v2/sites/query', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Accept: 'application/json, text/plain, */*',
+                Authorization: await getAccountAccessToken()
+            },
+            body: JSON.stringify({
+                query: {
+                    cursorPaging: { limit: 50 }
+                }
+            })
+        });
+        const result = await sitesRes.json().then(({ sites }) => sites?.map(({ id, displayName }) => ({
+            id,
+            name: displayName
+        })) ?? []);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result)
+                },
+                {
+                    type: 'text',
+                    text: 'if there is more than one site returned, the user should pick one from a list, list the sites (only name) for the user and ask them to pick one'
+                }
+            ]
+        };
+    });
+    server.tool('ManageWixSite', `Use account level API in order to create a site, update a site and publish site.
+    ALWAYS use "SearchWixRESTDocumentation" to search for the API you should invoke, NEVER GUESS THE SITE API URL
+    You should ALWAYS check the rest docs - "SearchWixRESTDocumentation" for the specific API you want to call, don't just call it without knowing what it does, CHECK THE DOCS`, {
+        url: z
+            .string()
+            .describe('The url of the api to call - ALWAYS get the information from the Wix REST docs DONT GUESS IT, the URL MUST BE ABSOLUTE URL'),
+        method: z
+            .string()
+            .describe('The HTTP method to use for the API call (e.g. GET, POST, PUT, DELETE)'),
+        body: z
+            .string()
+            .optional()
+            .describe('A string representing of a valid JSON object to describe the body of the request')
+    }, async ({ url, body, method }) => {
+        logger.log(`Calling Wix Account level API: ${url}, body: ${JSON.stringify(body)}`);
+        const authorization = await getAccountAccessToken();
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: authorization,
+                    ...(body ? { 'Content-Type': 'application/json' } : {})
+                },
+                body: method === 'GET' ? undefined : body
+            });
+            const responseData = await handleWixAPIResponse(response);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Wix Account API call successful: ${JSON.stringify(responseData)}`
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            logger.error(`Failed to call Wix Account API: ${error}`);
+            throw new Error(`Failed to call Wix Account API: ${error}`);
+        }
+    });
+}

package/build/bin.d.ts

@@ -0,0 +1,6 @@
+import './sentry.js';
+declare const PUBLIC_TOOLS: readonly ["WDS", "REST", "SDK", "BUILD_APPS", "WIX_HEADLESS", "BUSINESS_SOLUTIONS"];
+declare const EXPERIMENTAL_TOOLS: readonly ["WIX_API", "CLI_COMMAND"];
+type Tool = (typeof PUBLIC_TOOLS)[number] | (typeof EXPERIMENTAL_TOOLS)[number];
+export declare const DEFAULT_TOOLS: Tool[];
+export {};

package/build/bin.js

@@ -0,0 +1,98 @@
+import './sentry.js';
+import minimist from 'minimist';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { addDocsTools, VALID_DOCS_TOOLS } from './docs/docs.js';
+import { addCliTools, VALID_CLI_TOOLS } from './cli-tools/cli.js';
+import { logger, attachStdErrLogger, attachMcpServerLogger, attachFileLogger } from './logger.js';
+import { WixMcpServer } from './wix-mcp-server.js';
+import { addDocsResources } from './resources/docs.js';
+const PUBLIC_TOOLS = [...VALID_DOCS_TOOLS];
+const EXPERIMENTAL_TOOLS = ['WIX_API', 'CLI_COMMAND'];
+export const DEFAULT_TOOLS = [...VALID_DOCS_TOOLS];
+const parsedArgs = minimist(process.argv.slice(2));
+function parseExperimentalArg() {
+    const experimentalArg = parsedArgs['experimental'];
+    if (!experimentalArg)
+        return [];
+    return experimentalArg
+        .split(',')
+        .map((t) => t.trim())
+        .filter((tool) => EXPERIMENTAL_TOOLS.includes(tool));
+}
+function parseToolsArg() {
+    const toolsArg = parsedArgs['tools'];
+    const experimentalTools = parseExperimentalArg();
+    if (!toolsArg) {
+        // When no tools specified, return both default and experimental tools
+        return [...DEFAULT_TOOLS, ...experimentalTools];
+    }
+    const requestedTools = toolsArg.split(',').map((t) => t.trim());
+    const tools = [
+        // Include valid non-experimental tools
+        ...requestedTools.filter((tool) => PUBLIC_TOOLS.includes(tool)),
+        // Include enabled experimental tools
+        ...experimentalTools
+    ];
+    // Warn about enabled experimental tools
+    tools.forEach((tool) => {
+        if (EXPERIMENTAL_TOOLS.includes(tool)) {
+            logger.log(`Warning: ${tool} is an experimental tool and may have limited functionality or breaking changes`);
+        }
+    });
+    return tools;
+}
+const loggerType = parsedArgs['logger'] || 'mcp';
+if (loggerType === 'file') {
+    attachFileLogger();
+}
+else {
+    // Initially we log to stderr, because MCP server is not connected yet
+    // When the server is connected, we attach the MCP server logger
+    attachStdErrLogger();
+}
+logger.log('--------------------------------');
+logger.log('starting WIX MCP server');
+logger.log('--------------------------------');
+const server = new WixMcpServer({
+    name: 'wix-mcp-server',
+    version: '1.0.0'
+}, {
+    capabilities: {
+        tools: {},
+        prompts: {},
+        logging: {},
+        resources: {}
+    }
+});
+const activeTools = parseToolsArg();
+logger.log('Active tools:', activeTools);
+const docsTools = activeTools.filter((tool) => VALID_DOCS_TOOLS.includes(tool));
+if (docsTools.length > 0) {
+    logger.log('Adding docs tools:', docsTools);
+    addDocsTools(server, docsTools);
+}
+const isWixOne = parsedArgs['cli'] === 'wix-one';
+const cliTools = activeTools.filter((tool) => VALID_CLI_TOOLS.includes(tool));
+if (cliTools.length > 0) {
+    logger.log('Adding cli tools:', cliTools, 'isWixOne:', isWixOne);
+    addCliTools(server, cliTools, isWixOne);
+}
+try {
+    const portals = parsedArgs['portals']?.split(',') || [];
+    if (portals.length > 0) {
+        logger.log('Adding docs resources for portals:', portals);
+        await addDocsResources(server, portals);
+    }
+}
+catch (error) {
+    logger.error('Error adding docs resources:', error);
+}
+logger.log('Starting server');
+const transport = new StdioServerTransport();
+logger.log('Connecting to transport');
+await server.connect(transport);
+logger.log('Transport connected');
+if (loggerType === 'mcp') {
+    // From now on, we log to the MCP server
+    attachMcpServerLogger(server);
+}

package/build/cli-tools/cli.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const VALID_CLI_TOOLS: readonly ["WIX_API", "CLI_COMMAND", "CLI_COMMAND_INTERACTIVE_MODE"];
+export type CLITool = (typeof VALID_CLI_TOOLS)[number];
+export declare function addCliTools(server: McpServer, allowedTools?: CLITool[], isWixOne?: boolean): void;

package/build/cli-tools/cli.js

@@ -1,8 +1,9 @@
 import { z } from 'zod';
-import { getCliAuthTokenForSiteId, getSiteIdFromCliAppConfig, handleWixAPIResponse } from './utils.js';
+import { getCliAuthTokenForSiteId, getSiteIdFromCliAppConfig } from './utils.js';
 import { logger } from '../logger.js';
 import { execa } from 'execa';
 import { mockInteractiveGenerateCommandTool } from '../interactive-command-tools/interactive-command-utils.js';
+import { handleWixAPIResponse } from '../tool-utils.js';
 export const VALID_CLI_TOOLS = [
     'WIX_API',
     'CLI_COMMAND',
@@ -12,7 +13,7 @@ export function addCliTools(server, allowedTools = [
     'WIX_API',
     'CLI_COMMAND',
     'CLI_COMMAND_INTERACTIVE_MODE'
-]) {
+], isWixOne = false) {
     if (allowedTools.includes('WIX_API')) {
         server.tool('CallWixAPI', 'Call Wix apis on an app. Use this to create, read, update, and delete data and other Wix entities in your Wix app.', {
             appPath: z
@@ -239,7 +240,7 @@ export function addCliTools(server, allowedTools = [
                 // Format generate command with proper arguments
                 commandName = 'npx';
                 commandArgs = [
-                    'wix',
+                    isWixOne ? 'wix-one' : 'wix',
                     'app',
                     'generate',
                     '-t',
@@ -254,6 +255,9 @@ export function addCliTools(server, allowedTools = [
                 commandName = commandParts[0];
                 commandArgs = commandParts.slice(1);
             }
+            if (isWixOne && commandName === 'wix') {
+                commandName = 'wix-one';
+            }
             try {
                 logger.log(`Executing Wix CLI command: ${commandName} ${commandArgs.join(' ')}`);
                 // Execute with timeout

package/build/cli-tools/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function getCliAuthTokenForSiteId(siteIdOrAccountsFileName: string): string;
+export declare function getSiteIdFromCliAppConfig(appPath: string): any;

package/build/cli-tools/utils.js

@@ -10,22 +10,3 @@ export function getSiteIdFromCliAppConfig(appPath) {
     const appConfig = JSON.parse(readFileSync(path.join(appPath, '.wix/app.config.json'), 'utf8'));
     return appConfig.siteId;
 }
-const safeParseJSON = (text) => {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return text;
-    }
-};
-export const handleWixAPIResponse = async (response) => {
-    const responseText = await response.text();
-    const responseData = safeParseJSON(responseText);
-    if (!response.ok) {
-        const errorDetails = typeof responseData === 'object'
-            ? JSON.stringify(responseData)
-            : responseData;
-        throw new Error(`Failed to call Wix API: ${response.status} ${response.statusText}. ${errorDetails}`);
-    }
-    return responseData;
-};

package/build/docs/docs.d.ts

@@ -0,0 +1,4 @@
+import type { WixMcpServer } from '../wix-mcp-server.js';
+export declare const VALID_DOCS_TOOLS: readonly ["WDS", "REST", "SDK", "BUILD_APPS", "WIX_HEADLESS", "BUSINESS_SOLUTIONS"];
+export type DocsTool = (typeof VALID_DOCS_TOOLS)[number];
+export declare const addDocsTools: (server: WixMcpServer, allowedTools?: DocsTool[]) => void;

package/build/docs/docs.js

@@ -7,14 +7,16 @@ export const VALID_DOCS_TOOLS = [
     'REST',
     'SDK',
     'BUILD_APPS',
-    'WIX_HEADLESS'
+    'WIX_HEADLESS',
+    'BUSINESS_SOLUTIONS'
 ];
 export const addDocsTools = (server, allowedTools = [
     'WDS',
     'REST',
     'SDK',
     'BUILD_APPS',
-    'WIX_HEADLESS'
+    'WIX_HEADLESS',
+    'BUSINESS_SOLUTIONS'
 ]) => {
     // WDS Documentation
     if (allowedTools.includes('WDS')) {
@@ -33,13 +35,17 @@ export const addDocsTools = (server, allowedTools = [
                 .min(1)
                 .max(15)
                 .optional()
-                .default(5)
+                .default(10)
         }, async ({ searchTerm, maxResults }, { panorama }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Wix WDS`);
-                const result = await runSemanticSearchAndFormat('WDS', {
-                    searchTerm: searchTerm
-                }, Math.max(1, Math.min(maxResults ?? 5, 15)));
+                const result = await runSemanticSearchAndFormat({
+                    toolName: 'WDS',
+                    toolParams: {
+                        searchTerm: searchTerm
+                    },
+                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15))
+                });
                 return {
                     content: [
                         {
@@ -82,18 +88,27 @@ export const addDocsTools = (server, allowedTools = [
                 .min(1)
                 .max(15)
                 .optional()
-                .default(5)
+                .default(10)
         }, async ({ searchTerm, maxResults }, { panorama }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Wix REST API`);
-                const result = await runSemanticSearchAndFormat('REST', {
-                    searchTerm: searchTerm
-                }, Math.max(1, Math.min(maxResults ?? 5, 15)));
+                const result = await runSemanticSearchAndFormat({
+                    toolName: 'REST',
+                    toolParams: {
+                        searchTerm: searchTerm
+                    },
+                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15)),
+                    linesInEachResult: 15
+                });
                 return {
                     content: [
                         {
                             type: 'text',
                             text: result
+                        },
+                        {
+                            type: 'text',
+                            text: 'Next, you MUST use the ReadFullDocsArticle tool if you want to read the full documentation for a specific article or method.'
                         }
                     ]
                 };
@@ -114,6 +129,61 @@ export const addDocsTools = (server, allowedTools = [
             }
         });
     }
+    if (allowedTools.includes('BUSINESS_SOLUTIONS')) {
+        server.tool('WixBusinessFlowsDocumentation', [
+            'This tool provides step-by-step recipes for setting up complex Wix business solutions that involve multiple API calls.',
+            'It excels at guiding the creation of features like booking systems with payments.',
+            'For example, it can guide the setup of a service in Wix Bookings where customers can pay using Wix Payments, such as creating a bookable yoga class',
+            'It searches the Wix Business Solutions documentation for these integrated workflows involving services, bookings, payments, stores, blogs, and more.',
+            'Before attempting to implement a multi step API calls on Wix, YOU MUST TRY THIS TOOL FIRST.',
+            'If the result includes a link to another article, use ReadFullDocsArticle tool to fetch the full article.'
+        ].join('\n'), {
+            searchTerm: z
+                .string()
+                .describe('The search term for the required sample flow (e.g. "setup a new business")'),
+            maxResults: z
+                .number()
+                .describe('The maximum number of results to return, default is 5, max is 15')
+                .min(1)
+                .max(15)
+                .optional()
+                .default(5)
+        }, async ({ searchTerm, maxResults }, { panorama }) => {
+            try {
+                logger.log(`Searching for ${searchTerm} in Wix Sample Flows`);
+                const result = await runSemanticSearchAndFormat({
+                    toolName: 'BUSINESS_SOLUTIONS',
+                    toolParams: {
+                        searchTerm: '**RECIPE**:  Business Recipes - full setup flow for::: ' +
+                            searchTerm
+                    },
+                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15))
+                });
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: result
+                        }
+                    ]
+                };
+            }
+            catch (error) {
+                panorama.errorMonitor().reportError(error);
+                captureException(error, {
+                    tags: {
+                        componentId: 'SearchWixSampleFlowsDocumentation',
+                        toolName: 'SearchWixSampleFlowsDocumentation'
+                    }
+                });
+                logger.error(`Error searching for ${searchTerm} in Wix Sample Flows: ${error}`);
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: 'Error: ' + error.message }]
+                };
+            }
+        });
+    }
     // SDK Documentation
     if (allowedTools.includes('SDK')) {
         server.tool('SearchWixSDKDocumentation', [
@@ -138,9 +208,14 @@ export const addDocsTools = (server, allowedTools = [
                 panorama
                     .transaction('SearchWixSDKDocumentation')
                     .start({ maxResults });
-                const result = await runSemanticSearchAndFormat('SDK', {
-                    searchTerm: searchTerm
-                }, Math.max(1, Math.min(maxResults ?? 5, 15)));
+                const result = await runSemanticSearchAndFormat({
+                    toolName: 'SDK',
+                    toolParams: {
+                        searchTerm: searchTerm
+                    },
+                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15)),
+                    linesInEachResult: 15
+                });
                 panorama
                     .transaction('SearchWixSDKDocumentation')
                     .finish({ maxResults });
@@ -149,6 +224,10 @@ export const addDocsTools = (server, allowedTools = [
                         {
                             type: 'text',
                             text: result
+                        },
+                        {
+                            type: 'text',
+                            text: 'Next, you MUST use ReadFullDocsArticle tool if you want to read full documentation for a specific article or method.'
                         }
                     ]
                 };
@@ -190,9 +269,13 @@ export const addDocsTools = (server, allowedTools = [
         }, async ({ searchTerm, maxResults }, { panorama }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Build Apps`);
-                const result = await runSemanticSearchAndFormat('BUILD_APPS', {
-                    searchTerm: `wix cli docs for ${searchTerm}`
-                }, Math.max(1, Math.min(maxResults ?? 5, 15)));
+                const result = await runSemanticSearchAndFormat({
+                    toolName: 'BUILD_APPS',
+                    toolParams: {
+                        searchTerm: `wix cli docs for ${searchTerm}`
+                    },
+                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15))
+                });
                 return {
                     content: [
                         {
@@ -238,9 +321,13 @@ export const addDocsTools = (server, allowedTools = [
         }, async ({ searchTerm, maxResults }, { panorama }) => {
             try {
                 logger.log(`Searching for ${searchTerm} in Headless`);
-                const result = await runSemanticSearchAndFormat('WIX_HEADLESS', {
-                    searchTerm: searchTerm
-                }, Math.max(1, Math.min(maxResults ?? 5, 15)));
+                const result = await runSemanticSearchAndFormat({
+                    toolName: 'WIX_HEADLESS',
+                    toolParams: {
+                        searchTerm: searchTerm
+                    },
+                    maxResults: Math.max(1, Math.min(maxResults ?? 5, 15))
+                });
                 return {
                     content: [
                         {
@@ -265,4 +352,91 @@ export const addDocsTools = (server, allowedTools = [
             }
         });
     }
+    server.tool('ReadFullDocsArticle', [
+        'Fetches the full Wix docs article or method article.',
+        'Use this tool when you read a summary of a docs article or method article, you have the docs url and want to read the full article.'
+    ].join('\n'), {
+        articleUrl: z
+            .string()
+            .describe('The URL of the docs article or method article to fetch. Should be something like https://dev.wix.com/docs/.../.../...')
+    }, async ({ articleUrl }) => {
+        try {
+            const articleContent = await fetchArticleContent(articleUrl, 'article');
+            if (!articleContent) {
+                throw new Error('Article content is empty');
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: articleContent
+                    },
+                    {
+                        type: 'text',
+                        text: [
+                            '---',
+                            'Next, if you are dealing with a method - you MUST call ReadFullDocsMethodSchema tool - it will give you the full request schema for the method.'
+                        ].join('\n')
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            logger.error(`Error fetching article content or method schema for ${articleUrl}: ${error}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Could not fetch article content, you should try completing the task without it.'
+                    }
+                ]
+            };
+        }
+    });
+    server.tool('ReadFullDocsMethodSchema', [
+        'Fetches the full method schema for a given method. Always use it before calling the method.',
+        'This will give you the entire request/response schema with all the fields and their descriptions.'
+    ].join('\n'), {
+        articleUrl: z
+            .string()
+            .describe('The URL of the documentation to fetch. Should be something like https://dev.wix.com/docs/.../.../...')
+    }, async ({ articleUrl }) => {
+        try {
+            const articleContent = await fetchArticleContent(articleUrl, 'methodSchema');
+            if (!articleContent) {
+                throw new Error('Method schema is empty');
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: articleContent
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            logger.error(`Error fetching method schema for ${articleUrl}: ${error}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Could not fetch method schema, you should try completing the task without it.'
+                    }
+                ]
+            };
+        }
+    });
 };
+async function fetchArticleContent(articleUrl, mode) {
+    // https://dev.wix.com/digor/api/get-article-content?articleUrl=https://dev.wix.com/docs/rest/business-solutions/blog/draft-posts/create-draft-post&schema=true
+    const url = new URL(`https://dev.wix.com/digor/api/get-article-content`);
+    url.searchParams.set('articleUrl', articleUrl);
+    const schema = mode === 'methodSchema' ? 'true' : 'false';
+    url.searchParams.set('schema', schema);
+    logger.log(`Fetching resource from docs ${url.toString()}`);
+    const response = await fetch(url.toString());
+    const data = await response.json();
+    logger.log(`Fetched resource from docs: ${data.articleContent}`);
+    return data.articleContent;
+}