n8n-mcp-tools-expert

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

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

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 update operations, and mistakes like wrong prefixes or missing profiles 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 for configuration details, and validate_node for pre-deployment checks. - Format and Profile Rules: Explains the nodes-base.* versus n8n-nodes-base.* nodeType formats and the minimal, runtime, ai-friendly, and strict validation profiles. - Workflow Management Patterns: Covers n8n_create_workflow, n8n_update_partial_workflow with 17 operation types, smart branch/case parameters, AI connection types, and template deployment. - Use Case: When adding a Slack node to a workflow, follow the documented search → get_node → validate_node → n8n_update_partial_workflow sequence to produce a validated, activated workflow. ## Quick Start Ask the AI to find a Slack node using n8n-mcp tools, validate its configuration with the runtime profile, and add it to an existing 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 search for n8n nodes using n8n-mcp tools?

Use search_nodes with a query keyword, optional mode (OR, AND, FUZZY), and limit. It returns both nodeType formats, then call get_node with the nodes-base.* type for configuration details.

What is the difference between nodes-base and n8n-nodes-base nodeType formats?

Search and validate 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 for conversion.

Which validation profile should I use in n8n-mcp?

Use the runtime profile for pre-deployment validation since it balances value and type checking. Use minimal for quick required-field checks, ai-friendly to reduce false positives, and strict for production.

When should I use get_node standard versus full detail?

Use the default standard detail (~1-2K tokens) for most cases since it covers operations and essential properties. Reserve full detail (~3-8K tokens) for debugging complex configurations or exploring complete schemas.

Why does my n8n-mcp tool call return node not found?

The nodeType is missing the required prefix or uses the wrong one. Pass nodes-base.slack to search and validate tools, not plain slack or the full n8n-nodes-base.slack format.

Can n8n-mcp tools work without an n8n API connection?

Yes, discovery and validation tools like search_nodes, get_node, validate_node, and search_templates work without API credentials. Workflow CRUD, deployment, testing, and execution tools require N8N_API_URL and N8N_API_KEY.