mirror of https://mirror.skon.top/github.com/czlonkowski/n8n-skills synced 2026-04-20 21:02:34 +08:00

Files

czlonkowski c4df184423 feat: Sync skills with n8n-mcp tool API updates (v1.2.0)

- Fix property removal: undefined → null (matching actual MCP API)
- Add n8n_manage_datatable tool (data table CRUD, filtering, dry-run)
- Add transferWorkflow operation (18 ops total, was 17)
- Add 7 autofix types: node-type-correction, webhook-missing-path,
  typeversion-upgrade, version-migration + confidence thresholds
- Add AI agent patterns: MCP Client Tool, streaming, fallback models, RAG
- Replace all deprecated tool names across 18+ files:
  get_node_essentials → get_node, validate_node_operation → validate_node,
  get_property_dependencies → get_node search_properties mode
- Sync .claude/skills/ with updated skills directory
- Update docs/ with current unified tool API references

Conceived by Romuald Członkowski - www.aiadvisors.pl/en

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-26 10:39:14 +01:00

4.5 KiB

Raw Blame History

MCP Tool Testing Log

Generated: 2025-10-20

Purpose: Document actual tool responses for skill content creation

This log contains real responses from n8n-mcp tools to inform accurate skill content.

n8n API Status

Health Check Result:

{
  "status": "ok",
  "apiUrl": "https://n8n-test.n8n-mcp.com",
  "mcpVersion": "2.20.3",
  "versionCheck": "up to date",
  "responseTime": 798ms
}

✅ n8n API Tools Available: All workflow creation/management tools functional

Database Statistics

{
  "totalNodes": 537,
  "totalTemplates": 2653,
  "statistics": {
    "aiTools": 270,
    "triggers": 108,
    "versionedNodes": 141,
    "nodesWithDocumentation": 470,
    "documentationCoverage": "88%"
  },
  "packageBreakdown": [
    {"package": "@n8n/n8n-nodes-langchain", "nodeCount": 100},
    {"package": "n8n-nodes-base", "nodeCount": 437}
  ]
}

Key Insights:

537 nodes total (437 base + 100 langchain)
270 AI-capable tools
108 trigger nodes
88% documentation coverage
2,653 templates with avg 4,115 views

Search Tool Testing

search_nodes - Common Queries

Query: "webhook" → Returns Webhook (trigger), Respond to Webhook (transform)

nodeType format: nodes-base.webhook
workflowNodeType format: n8n-nodes-base.webhook
⚠️ Critical: Use different formats for different tools!

Query: "http" → Returns HTTP Request, HTTP Request Tool (AI), Code Tool

Regular: nodes-base.httpRequest
AI Tool: nodes-langchain.toolHttpRequest

Query: "database" → Returns Firebase, Redis Vector Store, etc.

Node Essentials Testing

Webhook Node

Key Properties:

httpMethod: GET, POST, PUT, DELETE, etc. (default: GET)
path: Webhook URL path (e.g., "form-submit")
responseMode: onReceived, lastNode, responseNode
CRITICAL: Webhook data structure is $json.body.* not $json.*

Output Structure:

{
  "headers": {...},
  "params": {...},
  "query": {...},
  "body": {  // ⚠️ User data is HERE!
    "name": "John",
    "email": "john@example.com"
  }
}

Validation Testing

Validation Profiles Comparison

Test Config: {resource: "channel", operation: "create"} on Slack node

Result: Missing required field "name"

All profiles detected this error
Fix provided: "Provide a channel name"
Warning about rate limits (best practice)

Template Analysis

Total Templates: 2,653 Popular Templates (webhook + slack):

#2947: Weather via Slack (1,500 views) - Webhook → OpenStreetMap → NWS → Slack
#4039: Download Slack Media (778 views) - SlackTrigger → HTTP Request
#5529: Jamf Patch to Slack (147 views) - Complex multi-node

Key Pattern: Webhook → Transform → Action → Notify (5-7 nodes avg)

Critical Findings for Skills

1. Expression Syntax (Skill #1)

✅ Webhook data under .body (not root)
✅ Code nodes use direct access ($json), NOT expressions ({{}})
✅ Node references: $node["Node Name"].json.field

2. MCP Tools Expert (Skill #2)

✅ nodeType formats differ: nodes-base.* vs n8n-nodes-base.*
✅ get_node preferred over get_node({detail: "full"}) (5KB vs 100KB+)
✅ Validation profiles: minimal/runtime/ai-friendly/strict
✅ Smart parameters: branch="true"/"false" for IF, case=N for Switch
✅ Auto-sanitization runs on ALL nodes during any update

3. Workflow Patterns (Skill #3)

✅ 2,653 real templates available
✅ Template metadata includes complexity, setup time, services
✅ Common pattern: Trigger → Process → Act (5-7 nodes)
✅ Webhook workflows: 27.6% of all workflows

4. Validation Expert (Skill #4)

✅ Real validation errors documented
✅ Auto-sanitization fixes operator structures
✅ Binary operators (equals, contains) vs unary (isEmpty, isNotEmpty)

5. Node Configuration (Skill #5)

✅ Property dependencies documented (e.g., sendBody → contentType)
✅ Operation-specific requirements vary
✅ 8 AI connection types supported

Tools Availability Summary

Available WITHOUT n8n API:

search_nodes, search_nodes, get_node ✅
validate_node({mode: "minimal"}), validate_node ✅
validate_workflow, get_node({mode: "search_properties"}) ✅
search_templates, get_template, list_tasks ✅

Requires n8n API (AVAILABLE at n8n-test.n8n-mcp.com):

n8n_create_workflow ✅
n8n_update_partial_workflow ✅
n8n_validate_workflow (by ID) ✅
n8n_list_workflows, n8n_get_workflow ✅
n8n_trigger_webhook_workflow ✅

Testing Complete: Ready for skill implementation with real data!

4.5 KiB Raw Blame History