n8n-mcp 2.66.1 → 2.66.3

package/dist/mcp/server.js

@@ -1489,15 +1489,22 @@ class N8NDocumentationMCPServer {
         if (!node) {
             throw new Error(`Node ${nodeType} not found`);
         }
+        const isCommunityNode = node.isCommunity ?? false;
+        const isMarkedAsAITool = node.isAITool ?? false;
+        let aiToolFlagSource = null;
+        if (isMarkedAsAITool) {
+            aiToolFlagSource = isCommunityNode ? 'declared-or-ai-category' : 'declared-property';
+        }
         const aiToolCapabilities = {
             canBeUsedAsTool: true,
-            hasUsableAsToolProperty: node.isAITool ?? false,
-            requiresEnvironmentVariable: !(node.isAITool ?? false) && node.package !== 'n8n-nodes-base',
+            hasUsableAsToolProperty: isMarkedAsAITool,
+            aiToolFlagSource,
+            requiresEnvironmentVariable: isCommunityNode,
             toolConnectionType: 'ai_tool',
             commonToolUseCases: this.getCommonAIToolUseCases(node.nodeType),
-            environmentRequirement: node.package && node.package !== 'n8n-nodes-base' ?
-                'N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true' :
-                null
+            environmentRequirement: isCommunityNode
+                ? 'N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true'
+                : null
         };
         let outputs = undefined;
         if (node.outputNames && Array.isArray(node.outputNames) && node.outputNames.length > 0) {
@@ -2105,11 +2112,11 @@ class N8NDocumentationMCPServer {
             tools,
             totalCount: tools.length,
             requirements: {
-                environmentVariable: 'N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true',
-                nodeProperty: 'usableAsTool: true',
+                environmentVariable: 'N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true (community nodes only; built-in tools need no environment variable)',
+                nodeProperty: 'usableAsTool (declared; community nodes may instead carry the codex AI category)',
             },
             usage: {
-                description: 'These nodes have the usableAsTool property set to true, making them optimized for AI agent usage.',
+                description: 'These nodes are marked as AI tools. For built-in nodes this reflects a declared usableAsTool property; for community nodes it can also be inferred from the package\'s AI category, since community metadata often omits the property.',
                 note: 'ANY node in n8n can be used as an AI tool by connecting it to the ai_tool port of an AI Agent node.',
                 examples: [
                     'Regular nodes like Slack, Google Sheets, or HTTP Request can be used as tools',
@@ -2863,61 +2870,6 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             } : undefined
         };
     }
-    async getNodeAsToolInfo(nodeType) {
-        await this.ensureInitialized();
-        if (!this.repository)
-            throw new Error('Repository not initialized');
-        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
-        let node = this.repository.getNode(normalizedType);
-        if (!node && normalizedType !== nodeType) {
-            node = this.repository.getNode(nodeType);
-        }
-        if (!node) {
-            const alternatives = (0, node_utils_1.getNodeTypeAlternatives)(normalizedType);
-            for (const alt of alternatives) {
-                const found = this.repository.getNode(alt);
-                if (found) {
-                    node = found;
-                    break;
-                }
-            }
-        }
-        if (!node) {
-            throw new Error(`Node ${nodeType} not found`);
-        }
-        const commonUseCases = this.getCommonAIToolUseCases(node.nodeType);
-        const aiToolCapabilities = {
-            canBeUsedAsTool: true,
-            hasUsableAsToolProperty: node.isAITool,
-            requiresEnvironmentVariable: !node.isAITool && node.package !== 'n8n-nodes-base',
-            connectionType: 'ai_tool',
-            commonUseCases,
-            requirements: {
-                connection: 'Connect to the "ai_tool" port of an AI Agent node',
-                environment: node.package !== 'n8n-nodes-base' ?
-                    'Set N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true for community nodes' :
-                    'No special environment variables needed for built-in nodes'
-            },
-            examples: this.getAIToolExamples(node.nodeType),
-            tips: [
-                'Give the tool a clear, descriptive name in the AI Agent settings',
-                'Write a detailed tool description to help the AI understand when to use it',
-                'Test the node independently before connecting it as a tool',
-                node.isAITool ?
-                    'This node is optimized for AI tool usage' :
-                    'This is a regular node that can be used as an AI tool'
-            ]
-        };
-        return {
-            nodeType: node.nodeType,
-            workflowNodeType: (0, node_utils_1.getWorkflowNodeType)(node.package, node.nodeType),
-            displayName: node.displayName,
-            description: node.description,
-            package: node.package,
-            isMarkedAsAITool: node.isAITool,
-            aiToolCapabilities
-        };
-    }
     getOutputDescriptions(nodeType, outputName, index) {
         if (nodeType === 'nodes-base.splitInBatches') {
             if (outputName === 'done' && index === 0) {
@@ -3035,53 +2987,6 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         }
         return undefined;
     }
-    getAIToolExamples(nodeType) {
-        const exampleMap = {
-            'nodes-base.slack': {
-                toolName: 'Send Slack Message',
-                toolDescription: 'Sends a message to a specified Slack channel or user. Use this to notify team members about important events or results.',
-                nodeConfig: {
-                    resource: 'message',
-                    operation: 'post',
-                    channel: '={{ $fromAI("channel", "The Slack channel to send to, e.g. #general") }}',
-                    text: '={{ $fromAI("message", "The message content to send") }}'
-                }
-            },
-            'nodes-base.googleSheets': {
-                toolName: 'Update Google Sheet',
-                toolDescription: 'Reads or updates data in a Google Sheets spreadsheet. Use this to log information, retrieve data, or update records.',
-                nodeConfig: {
-                    operation: 'append',
-                    sheetId: 'your-sheet-id',
-                    range: 'A:Z',
-                    dataMode: 'autoMap'
-                }
-            },
-            'nodes-base.httpRequest': {
-                toolName: 'Call API',
-                toolDescription: 'Makes HTTP requests to external APIs. Use this to fetch data, trigger webhooks, or integrate with any web service.',
-                nodeConfig: {
-                    method: '={{ $fromAI("method", "HTTP method: GET, POST, PUT, DELETE") }}',
-                    url: '={{ $fromAI("url", "The complete API endpoint URL") }}',
-                    sendBody: true,
-                    bodyContentType: 'json',
-                    jsonBody: '={{ $fromAI("body", "Request body as JSON object") }}'
-                }
-            }
-        };
-        for (const [key, example] of Object.entries(exampleMap)) {
-            if (nodeType.includes(key)) {
-                return example;
-            }
-        }
-        return {
-            toolName: 'Custom Tool',
-            toolDescription: 'Performs specific operations. Describe what this tool does and when to use it.',
-            nodeConfig: {
-                note: 'Configure the node based on its specific requirements'
-            }
-        };
-    }
     async validateNodeMinimal(nodeType, config) {
         await this.ensureInitialized();
         if (!this.repository)