ros/n8n-skills
1
0
Fork 0
mirror of https://github.com/czlonkowski/n8n-skills.git synced 2026-03-16 23:43:08 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
f7d34f2b8e612a944f0314b8f1186060aa8326a2
n8n-skills/skills/n8n-mcp-tools-expert/README.md
czlonkowski f7d34f2b8e feat: Complete Skill #2 - n8n MCP Tools Expert 
Implements comprehensive guidance for using n8n-mcp MCP tools effectively.
This is the HIGHEST PRIORITY skill that addresses the 20% MCP tool failure rate.

Files created:
- 5 evaluations testing tool selection, nodeType formats, validation, and smart parameters
- SKILL.md (505 lines) - Core tool usage guide with telemetry insights
- SEARCH_GUIDE.md (243 lines) - Node discovery tools (search, essentials vs info)
- VALIDATION_GUIDE.md (377 lines) - Configuration validation and auto-sanitization
- WORKFLOW_GUIDE.md (385 lines) - Workflow management with 15 operation types
- README.md - Skill metadata emphasizing highest priority

Key features:
- Tool selection guide with success rates (search_nodes 99.9%, get_node_essentials 91.7%)
- nodeType format distinction (nodes-base.* vs n8n-nodes-base.*)
- Validation profiles explained (minimal/runtime/ai-friendly/strict)
- Smart parameters for IF/Switch nodes (branch="true", case=0)
- Auto-sanitization system for operator structures
- Telemetry insights (56s between edits, 18s search→essentials, 23s+58s validate→fix)
- AI connection types (8 types documented)

Total: ~1,650 lines across 10 files

Based on analysis of 447,557 real MCP tool usage events.

🤖 Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
2025-10-20 10:26:40 +02:00

3.0 KiB
Raw Blame History

n8n MCP Tools Expert

Expert guide for using n8n-mcp MCP tools effectively.

Purpose

Teaches how to use n8n-mcp MCP server tools correctly, fixing the 20% failure rate when using tools incorrectly.

Activates On

  • search nodes
  • find node
  • validate
  • MCP tools
  • template
  • workflow
  • n8n-mcp
  • tool selection

File Count

5 files, ~1,150 lines total

Priority

HIGHEST - Fixes 20% MCP tool failure rate

Dependencies

n8n-mcp tools: All of them! (40+ tools)

Related skills:

  • n8n Expression Syntax (write expressions for workflows)
  • n8n Workflow Patterns (use tools to build patterns)
  • n8n Validation Expert (interpret validation results)
  • n8n Node Configuration (configure nodes found with tools)

Coverage

Core Topics

  • Tool selection guide (which tool for which task)
  • nodeType format differences (nodes-base.* vs n8n-nodes-base.*)
  • Validation profiles (minimal/runtime/ai-friendly/strict)
  • Smart parameters (branch, case for multi-output nodes)
  • Auto-sanitization system
  • Workflow management (15 operation types)
  • AI connection types (8 types)

Tool Categories

  • Node Discovery (search, list, essentials, info)
  • Configuration Validation (minimal, operation, workflow)
  • Workflow Management (create, update, validate)
  • Template Library (search, get)
  • Documentation (tools, database stats)

Evaluations

5 scenarios (100% coverage expected):

  1. eval-001: Tool selection (search_nodes)
  2. eval-002: nodeType format (nodes-base.* prefix)
  3. eval-003: Validation workflow (profiles)
  4. eval-004: essentials vs info (5KB vs 100KB)
  5. eval-005: Smart parameters (branch, case)

Key Features

✅ Data-Driven: Based on 447,557 real MCP tool events ✅ Telemetry Insights: Actual usage patterns (56s between edits, 18s between search/essentials) ✅ Critical Mistakes: Highlights 20% failure rate issues ✅ Smart Parameters: Teaches semantic branch/case routing ✅ Auto-Sanitization: Explains automatic fixes ✅ Comprehensive: Covers all 40+ tools

Files

  • SKILL.md (480 lines) - Core tool usage guide
  • SEARCH_GUIDE.md (220 lines) - Node discovery tools
  • VALIDATION_GUIDE.md (250 lines) - Validation tools and profiles
  • WORKFLOW_GUIDE.md (200 lines) - Workflow management
  • README.md (this file) - Skill metadata

Success Metrics

Expected outcomes:

  • Correct nodeType formats (nodes-base.* for search)
  • get_node_essentials preferred over get_node_info
  • Validation profiles used correctly
  • Smart parameters for IF/Switch nodes
  • 20% failure rate reduced to <5%

Critical Insights

From MCP Testing Log:

  • search → essentials: 9,835 occurrences, 18s avg
  • validate → fix: 7,841 loops, 23s thinking, 58s fixing
  • update_partial: 38,287 uses, 56s between edits
  • get_node_info: 20% failure rate (use essentials!)

Last Updated

2025-10-20

Part of: n8n-skills repository Conceived by: Romuald Członkowski - www.aiadvisors.pl/en