n8n-mcp-tools-expert

Guides selection and usage of n8n-mcp tools for node discovery, validation, and workflow management.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/guestyorg/n8n-workflow-builder --skill n8n-mcp-tools-expert-guestyorg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: n8n-mcp-tools-expert
Source: https://github.com/guestyorg/n8n-workflow-builder/tree/main/n8n-skills/skills/n8n-mcp-tools-expert
Command: npx skills add https://github.com/guestyorg/n8n-workflow-builder --skill n8n-mcp-tools-expert-guestyorg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building n8n workflows through the n8n-mcp MCP server requires choosing among 40+ tools with different nodeType formats, validation profiles, and operation types, and mistakes like wrong prefixes or missing smart parameters cause failed searches and invalid configurations. ## Core Features & Use Cases - Tool Selection Guidance: Maps tasks to the right tools, such as search_nodes for discovery, get_node with detail levels for configuration, and validate_node with runtime profiles for pre-deployment checks. - Format and Parameter Rules: Explains the nodes-base.* versus n8n-nodes-base.* nodeType formats, smart branch/case parameters for IF and Switch nodes, and the 8 AI connection types. - Workflow Lifecycle Management: Covers iterative building with n8n_update_partial_workflow's 17 operation types, template deployment, version rollback, and activation via API. - Use Case: When adding a Slack node to a workflow, follow the documented pattern of searching for the node, retrieving standard-detail configuration with examples, validating with the runtime profile, then connecting it using semantic branch parameters. ## Quick Start Ask the AI to search for a Slack node, show its configuration options, and validate a message-posting setup using the n8n-mcp tools.

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 search for n8n nodes using n8n-mcp tools?

Use search_nodes with a query keyword, optional mode (OR, AND, or FUZZY), and a result limit. It returns both nodeType formats in under 20ms, then follow up with get_node at standard detail for configuration information.

What is the difference between nodes-base and n8n-nodes-base prefixes?

Search and validation tools like get_node and validate_node use the short nodes-base.* prefix, while workflow tools like n8n_create_workflow require the full n8n-nodes-base.* prefix. search_nodes returns both formats so you can pick the right one per tool.

Which validation profile should I use for n8n node configurations?

Use the runtime profile for pre-deployment validation since it balances value and type checking. The minimal profile suits quick required-field checks, ai-friendly reduces false positives for AI-generated configs, and strict fits production deployment.

When should I use get_node full detail versus standard?

Standard detail (~1-2K tokens) covers about 95% of use cases including operations and essential properties. Reserve full detail (~3-8K tokens) for debugging complex configurations, since it consumes significantly more tokens and responds slower.

How do I connect IF and Switch node outputs in n8n workflows?

Use smart parameters in n8n_update_partial_workflow: pass branch "true" or "false" for IF nodes and case numbers for Switch nodes instead of manual sourceIndex values. This makes connections semantic and avoids index calculation errors.

Do n8n-mcp workflow tools work without an n8n API key?

No. Tools like n8n_create_workflow, n8n_update_partial_workflow, and n8n_deploy_template require N8N_API_URL and N8N_API_KEY. Discovery, validation, and template search tools remain available without API access.