Files
n8n-mcp/src/mcp
czlonkowski 59ae78f03a feat: add comprehensive AI Agents guide and deprecate list_ai_tools
Complete Phase 4 of AI validation implementation:

**New Guide (900+ lines)**
- src/mcp/tool-docs/guides/ai-agents-guide.ts: Comprehensive guide covering:
  * AI Agent Architecture (nodes, connections, workflow patterns)
  * 8 Essential Connection Types (detailed explanations with examples)
  * Building First AI Agent (step-by-step tutorial)
  * AI Tools Deep Dive (HTTP Request, Code, Vector Store, AI Agent Tool, MCP)
  * Advanced Patterns (streaming, fallback models, RAG, multi-agent)
  * Validation & Best Practices (workflow validation, common pitfalls)
  * Troubleshooting (connection issues, tool problems, performance)

**Integration**
- src/mcp/tool-docs/guides/index.ts: Export guide
- src/mcp/tool-docs/index.ts: Register ai_agents_guide in toolsDocumentation

**Deprecation**
- src/mcp/tool-docs/discovery/list-ai-tools.ts: Deprecate basic 263-node list
  * Updated to point users to comprehensive ai_agents_guide
  * Recommends search_nodes({includeExamples: true}) for examples

**Access**
- tools_documentation({topic: "ai_agents_guide"}) - full guide
- tools_documentation({topic: "ai_agents_guide", depth: "essentials"}) - quick reference

This replaces the basic list_ai_tools with progressive, complete documentation
for building production AI workflows in n8n.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-06 22:39:36 +02:00
..