n8n-mcp 2.16.1 → 2.17.1

package/dist/mcp/tool-docs/discovery/list-ai-tools.js

@@ -5,26 +5,30 @@ exports.listAiToolsDoc = {
     name: 'list_ai_tools',
     category: 'discovery',
     essentials: {
-        description: 'Returns 263 nodes with built-in AI features. CRITICAL: Any of the 525 n8n nodes can be used as an AI tool by connecting it to an AI Agent node\'s tool port. This list only shows nodes with AI-specific features, not all usable nodes.',
+        description: 'DEPRECATED: Basic list of 263 AI nodes. For comprehensive AI Agent guidance, use tools_documentation({topic: "ai_agents_guide"}). That guide covers architecture, connections, tools, validation, and best practices. Use search_nodes({query: "AI", includeExamples: true}) for AI nodes with working examples.',
         keyParameters: [],
-        example: 'list_ai_tools()',
+        example: 'tools_documentation({topic: "ai_agents_guide"}) // Recommended alternative',
         performance: 'Instant (cached)',
         tips: [
-            'ANY node can be an AI tool - not limited to this list',
-            'Connect Slack, Database, HTTP Request, etc. to AI Agent tool port',
+            'NEW: Use ai_agents_guide for comprehensive AI workflow documentation',
+            'Use search_nodes({includeExamples: true}) for AI nodes with real-world examples',
+            'ANY node can be an AI tool - not limited to AI-specific nodes',
             'Use get_node_as_tool_info for guidance on any node'
         ]
     },
     full: {
-        description: 'Lists 263 nodes that have built-in AI capabilities or are optimized for AI workflows. IMPORTANT: This is NOT a complete list of nodes usable as AI tools. Any of the 525 n8n nodes can be connected to an AI Agent node\'s tool port to function as an AI tool. This includes Slack, Google Sheets, databases, HTTP requests, and more.',
+        description: '**DEPRECATED in favor of ai_agents_guide**. Lists 263 nodes with built-in AI capabilities. For comprehensive documentation on building AI Agent workflows, use tools_documentation({topic: "ai_agents_guide"}) which covers architecture, the 8 AI connection types, validation, and best practices with real examples. IMPORTANT: This basic list is NOT a complete guide - use the full AI Agents guide instead.',
         parameters: {},
-        returns: 'Array of 263 AI-optimized nodes including: OpenAI (GPT-3/4), Anthropic (Claude), Google AI (Gemini/PaLM), Cohere, HuggingFace, Pinecone, Qdrant, Supabase Vector Store, LangChain nodes, embeddings processors, vector stores, chat models, and AI-specific utilities. Each entry includes nodeType, displayName, and AI-specific capabilities.',
+        returns: 'Array of 263 AI-optimized nodes. RECOMMENDED: Use ai_agents_guide for comprehensive guidance, or search_nodes({query: "AI", includeExamples: true}) for AI nodes with working configuration examples.',
         examples: [
-            'list_ai_tools() - Returns all 263 AI-optimized nodes',
-            '// To use ANY node as AI tool:',
-            '// 1. Add any node (e.g., Slack, MySQL, HTTP Request)',
-            '// 2. Connect it to AI Agent node\'s "Tool" input port',
-            '// 3. The AI agent can now use that node\'s functionality'
+            '// RECOMMENDED: Use the comprehensive AI Agents guide',
+            'tools_documentation({topic: "ai_agents_guide"})',
+            '',
+            '// Or search for AI nodes with real-world examples',
+            'search_nodes({query: "AI Agent", includeExamples: true})',
+            '',
+            '// Basic list (deprecated)',
+            'list_ai_tools() - Returns 263 AI-optimized nodes'
         ],
         useCases: [
             'Discover AI model integrations (OpenAI, Anthropic, Google AI)',

package/dist/mcp/tool-docs/discovery/list-ai-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-ai-tools.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/discovery/list-ai-tools.ts"],"names":[],"mappings":";;;AAEa,QAAA,cAAc,GAAsB;IAC/C,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,0OAA0O;QACvP,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,iBAAiB;QAC1B,WAAW,EAAE,kBAAkB;QAC/B,IAAI,EAAE;YACJ,uDAAuD;YACvD,mEAAmE;YACnE,oDAAoD;SACrD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,yUAAyU;QACtV,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,iVAAiV;QAC1V,QAAQ,EAAE;YACR,sDAAsD;YACtD,gCAAgC;YAChC,uDAAuD;YACvD,wDAAwD;YACxD,2DAA2D;SAC5D;QACD,QAAQ,EAAE;YACR,+DAA+D;YAC/D,4CAA4C;YAC5C,4CAA4C;YAC5C,8CAA8C;SAC/C;QACD,WAAW,EAAE,4CAA4C;QACzD,aAAa,EAAE;YACb,mEAAmE;YACnE,sHAAsH;YACtH,uEAAuE;SACxE;QACD,QAAQ,EAAE;YACR,6EAA6E;YAC7E,+DAA+D;YAC/D,+DAA+D;SAChE;QACD,YAAY,EAAE,CAAC,0CAA0C,EAAE,qCAAqC,EAAE,wCAAwC,CAAC;KAC5I;CACF,CAAC"}
+{"version":3,"file":"list-ai-tools.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/discovery/list-ai-tools.ts"],"names":[],"mappings":";;;AAEa,QAAA,cAAc,GAAsB;IAC/C,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,kTAAkT;QAC/T,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,4EAA4E;QACrF,WAAW,EAAE,kBAAkB;QAC/B,IAAI,EAAE;YACJ,sEAAsE;YACtE,iFAAiF;YACjF,+DAA+D;YAC/D,oDAAoD;SACrD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,oZAAoZ;QACja,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,uMAAuM;QAChN,QAAQ,EAAE;YACR,uDAAuD;YACvD,iDAAiD;YACjD,EAAE;YACF,oDAAoD;YACpD,0DAA0D;YAC1D,EAAE;YACF,4BAA4B;YAC5B,kDAAkD;SACnD;QACD,QAAQ,EAAE;YACR,+DAA+D;YAC/D,4CAA4C;YAC5C,4CAA4C;YAC5C,8CAA8C;SAC/C;QACD,WAAW,EAAE,4CAA4C;QACzD,aAAa,EAAE;YACb,mEAAmE;YACnE,sHAAsH;YACtH,uEAAuE;SACxE;QACD,QAAQ,EAAE;YACR,6EAA6E;YAC7E,+DAA+D;YAC/D,+DAA+D;SAChE;QACD,YAAY,EAAE,CAAC,0CAA0C,EAAE,qCAAqC,EAAE,wCAAwC,CAAC;KAC5I;CACF,CAAC"}

package/dist/mcp/tool-docs/guides/ai-agents-guide.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const aiAgentsGuide: ToolDocumentation;
+//# sourceMappingURL=ai-agents-guide.d.ts.map

package/dist/mcp/tool-docs/guides/ai-agents-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-agents-guide.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/guides/ai-agents-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,aAAa,EAAE,iBA+tB3B,CAAC"}