Romuald Członkowski
25784142fe
fix: address tools documentation gaps and outdated references (v2.26.3) ( #443 )
2025-11-26 00:57:15 +01:00
Romuald Członkowski
1be06c217f
fix: synchronize tool documentation with v2.26.0 tool consolidation (v2.26.2) ( #442 )
...
* fix: synchronize tool documentation with v2.26.0 tool consolidation (v2.26.2)
- Delete 23 obsolete documentation files for removed tools
- Create consolidated documentation for get_node, validate_node, n8n_executions
- Update search_templates with all searchModes
- Update n8n_get_workflow with all modes
- Fix stale relatedTools references
- Update tools-documentation.ts overview to reflect 19 consolidated tools
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
* fix: address code review - fix remaining stale tool references
- Fix relatedTools in system/tools-documentation.ts (get_node_for_task → search_templates)
- Fix relatedTools in validation/validate-workflow.ts (remove references to removed tools)
- Fix relatedTools in n8n-autofix-workflow.ts (remove references to removed tools)
- Update tools-n8n-friendly.ts with consolidated tools (validate_node, get_node, search_templates)
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
* fix: address final code review - fix remaining stale references
- Fix ai-agents-guide.ts: get_node_essentials → get_node, remove list_ai_tools
- Fix get-template.ts: list_node_templates → search_templates, remove get_templates_for_task
- Fix n8n-list-workflows.ts: n8n_get_workflow_minimal → n8n_get_workflow, n8n_list_executions → n8n_executions
- Fix n8n-trigger-webhook-workflow.ts: n8n_get_execution/n8n_list_executions → n8n_executions
- Fix n8n-delete-workflow.ts: n8n_get_workflow_minimal → n8n_get_workflow, n8n_delete_execution → n8n_executions
- Fix CHANGELOG date typo: 2025-01-25 → 2025-11-25
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
* test: adjust comprehensive docs threshold after tool consolidation
Reduce expected character count from 5000 to 4000 in tool-invocation.test.ts
to account for reduced documentation after v2.26.0 tool consolidation
(31→19 tools, actual output is ~4645 chars).
Conceived by Romuald Członkowski - www.aiadvisors.pl/en
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
---------
Co-authored-by: Claude <noreply@anthropic.com >
2025-11-25 21:28:11 +01:00
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
czlonkowski
24d775960b
refactor: rewrite all MCP tool documentation for AI agent optimization
...
- Redesigned documentation to be utilitarian and AI-agent focused
- Removed all pleasantries, emojis, and conversational language
- Added concrete numbers throughout (528 nodes, 108 triggers, 264 AI tools)
- Updated all tool descriptions with practical, actionable information
- Enhanced examples with actual return structures and usage patterns
- Made Code node guides prominently featured in overview
- Verified documentation accuracy through extensive testing
- Standardized format across all 30+ tool documentation files
Documentation now optimized for token efficiency while maintaining
clarity and completeness for AI agent consumption.
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-07-17 21:35:01 +02:00
czlonkowski
c1a6347d4f
feat: complete modular documentation system for all MCP tools ( #60 )
...
- Migrated all 40 MCP tools documentation to modular structure
- Created comprehensive documentation with both essentials and full details
- Organized tools by category: discovery, configuration, validation, templates, workflow_management, system, special
- Fixed all TODO placeholders with informative, precise content
- Each tool now has concise description, key tips, and full documentation
- Improved documentation quality: 30-40% more concise while maintaining usefulness
- Fixed TypeScript compilation issues and removed orphaned content
- All tools accessible via tools_documentation MCP endpoint
- Build successful with zero errors
🤖 Generated with [Claude Code](https://claude.ai/code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-07-17 21:35:00 +02:00
