n8n-mcp-tools-expert

Guide correct usage of n8n-mcp tools for node discovery, validation, and workflow edits.

Updated May 12, 2026
One-click install
npx skills add https://github.com/contenido-wq/aivi_core --skill n8n-mcp-tools-expert-contenido-wq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: n8n-mcp-tools-expert
Source: https://github.com/contenido-wq/aivi_core/tree/main/.github/skills/n8n-mcp-tools-expert
Command: npx skills add https://github.com/contenido-wq/aivi_core --skill n8n-mcp-tools-expert-contenido-wq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents common workflow-building failures when using n8n MCP tools by teaching the correct tool sequence, parameter conventions, and validation practices so your generated or edited workflows work on the first go.

Core Features & Use Cases

  • Tool selection & sequencing: Guides when to use node discovery, node retrieval, validation, template search/deploy, and workflow management tools.
  • nodeType format correctness: Explains and enforces the critical difference between search/validate prefixes (nodes-base.) and workflow prefixes (n8n-nodes-base.), including conversion.
  • Validation profiles & loops: Shows how to validate with minimal vs runtime vs ai-friendly vs strict profiles, and how to iterate validate → fix → validate.
  • Smart parameters for connections: Covers semantic branch/case connection parameters (branch, case) for IF/Switch multi-output nodes to avoid fragile sourceIndex wiring.
  • Auto-sanitization & recovery: Explains what gets automatically fixed on workflow updates and when to use remediation operations/tools like cleanStaleConnections or autofix workflows.
  • Template + workflow operations: Covers creating, partially updating, validating, activating, and deploying templates efficiently.

Quick Start

Ask the skill to "Find the correct n8n Slack node with search_nodes, fetch its operations with get_node using standard detail, validate a channel/create configuration with profile runtime, then show the correct nodeType format to use for building and wiring it into a workflow."

Frequently Asked Questions about n8n-mcp-tools-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate n8n workflow configurations correctly using MCP tools?

To validate n8n workflow configurations, use the appropriate validation profile (minimal, runtime, ai-friendly, or strict) and iterate through a validate, fix, and validate loop until the workflow passes. This ensures generated or edited workflows function correctly on the first deployment.

What is the correct nodeType prefix format for n8n workflow validation versus building?

For n8n workflow validation and search, the correct nodeType prefix format is nodes-base.*, while building and wiring workflows requires the n8n-nodes-base.* prefix. Converting between these two formats is necessary to prevent common workflow-building failures.

How do I manage multi-output connections for n8n IF and Switch nodes without fragile wiring?

To manage multi-output connections for n8n IF and Switch nodes, apply semantic branch and case connection parameters instead of manual sourceIndex wiring. This smart parameter approach avoids fragile connections and ensures stable workflow automation.

How do I deploy n8n templates and update workflows with auto-sanitization?

To deploy n8n templates and update workflows, use the template search and deploy tools, then apply partial updates. Auto-sanitization automatically fixes certain workflow issues during updates, while cleanStaleConnections or autofix operations handle remaining remediation tasks.

Can I use MCP tools to discover n8n nodes and fetch their operations?

Yes, you can use MCP tools to discover n8n nodes by running search_nodes, then fetch specific operations and parameters with get_node. This tool sequencing guides the correct node discovery and retrieval process for building n8n workflows.

Why do my generated n8n workflows fail on the first deployment attempt?

Generated n8n workflows often fail due to incorrect tool sequencing, wrong nodeType prefix formats, or missing validation profiles. Applying the correct parameter conventions, smart connections, and validation loops ensures workflows work on the first go.