skilld
All skills
czlonkowski avatar

/n8n-mcp-tools-expert

@22ec220
by Romuald Członkowskiczlonkowski/n8n-skills6.4k stars
1,050

Expert guide for using n8n-mcp MCP tools effectively. Use when searching for nodes, validating configurations, accessing templates, managing workflows, organizing workflows into folders, managing credentials, auditing instance security, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns. IMPORTANT — Always consult this skill before calling any n8n-mcp tool — it prevents common mistakes like wrong nodeType formats, incorrect parameter structures, and inefficient tool usage. If the user mentions n8n, workflows, nodes, or automation and you have n8n MCP tools available, use this skill first.

Ask your Agent

Use this Skill: https://skilld.dev/gh/czlonkowski/n8n-skills/n8n-mcp-tools-expert

This session only. Nothing lands on disk.

README.md

≈680 tokens on demand. Your agent reads this file only when SKILL.md points to it.

n8n MCP Tools Expert

Expert guide for using n8n-mcp MCP tools effectively.

Purpose

Teaches how to use n8n-mcp MCP server tools correctly for efficient workflow building.

Activates On

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

File Count

5 files

Priority

HIGHEST - Essential for correct MCP tool usage

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 (18 operation types)
  • AI connection types (8 types)

Tool Categories

  • Node Discovery (search_nodes, get_node with detail levels and modes)
  • 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: standard vs full detail (1-2KB vs 3-8KB)
  5. eval-005: Smart parameters (branch, case)

Key Features

✅ Tool Selection Guide: Which tool to use for each task ✅ Common Patterns: Most effective tool usage sequences ✅ Format Guidance: nodeType format differences explained ✅ Smart Parameters: Semantic branch/case routing for multi-output nodes ✅ Auto-Sanitization: Explains automatic validation fixes ✅ Comprehensive: Covers all 40+ MCP tools

Files

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

What You'll Learn

  • Correct nodeType formats (nodes-base.* for search tools)
  • When to use get_node vs get_node({detail: "full"})
  • How to use validation profiles effectively
  • Smart parameters for multi-output nodes (IF/Switch)
  • Common tool usage patterns and workflows

Last Updated

2025-10-20

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

Source: SKILL.md on GitHub

Third-party checks

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill provides a comprehensive configuration and usage guide for the n8n-mcp server tools. Analysis of the instructions and documentation found no security threats, malicious behavior, or policy violations.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    1/5 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 22ec220. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated last month

Topics

  • MCP
  • n8n
  • workflow-automation
  • node-discovery
  • workflow-validation
  • credential-management
  • workflow-generation
  • automation
  • integration

README badge

README badge for czlonkowski/n8n-skills/n8n-mcp-tools-expert

What it does

Guides AI agents through n8n-mcp MCP tools for workflow automation, including node discovery, configuration validation, and workflow management. Covers tool selection, correct parameter formats (nodeType prefixes, credential blocks), and common mistakes like using placeholder credential IDs or wrong validation profiles.

Generated from the current SKILL.md.

Frequently asked

What's the difference between nodeType and workflowNodeType formats?
Search and validation tools use the short prefix format (nodes-base.slack), while workflow creation and editing tools use the full prefix format (n8n-nodes-base.slack). The skill includes conversion guidance to avoid 'node not found' errors.
When should I use detail='full' vs the default detail='standard'?
Use detail='standard' (the default) for 95% of cases — it covers operations and properties in 1-2K tokens. Use detail='full' only when debugging complex configurations or exploring advanced features, as it returns 3-8K tokens.
What happens if I include a placeholder credential ID in node JSON?
The credential selector renders permanently disabled in the n8n UI and the user must recreate the node. Omit the credentials block entirely if you don't know the real ID; an absent block shows a normal dropdown. Use n8n_manage_credentials to discover real credential IDs first.
Does this skill cover all n8n-mcp tools or just the main ones?
This skill covers tool selection, parameter formats, and common patterns for all n8n-mcp categories: node discovery, workflow management, templates, credentials, data tables, and security auditing. It includes linked guides (SEARCH_GUIDE.md, VALIDATION_GUIDE.md, WORKFLOW_GUIDE.md) for deeper reference.
What are the most common mistakes when using n8n-mcp tools?
The skill documents eight critical mistakes: wrong nodeType format, overusing detail='full', ignoring validation profiles, not understanding auto-sanitization behavior, missing smart parameters (branch/case), using the wrong parameter name (parameters vs updates), incorrect credential format, and omitting the intent parameter for better responses.

Generated from the current SKILL.md. These answers refresh after source changes.