Skip to main content Accueil Créateurs beko2210 firstbrain n8n-mcp-tools-expert
n8n-mcp-tools-expert Expert guide for using n8n-mcp MCP tools effectively. Use when searching for nodes, validating configurations, accessing templates, managing workflows, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns.
Aller à l'installation Skills Marketplace Découvrez et explorez les compétences IA créées par la communauté.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Afficher les détails du prompt Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
npx skills add https://github.com/BEKO2210/Firstbrain --skill n8n-mcp-tools-expertLa commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.
Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.
Télécharger Zip Téléchargement... Métiers associés SOC
Basé sur la classification professionnelle SOC
name n8n-mcp-tools-expert description Expert guide for using n8n-mcp MCP tools effectively. Use when searching for nodes, validating configurations, accessing templates, managing workflows, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns. type skill created 2026-02-27T00:00:00.000Z domain productivity category developer-experience risk unknown source community tags ["skill","productivity","developer-experience","n8n","mcp"]
n8n MCP Tools Expert
Master guide for using n8n-mcp MCP server tools to build workflows.
When to Use
You are using the n8n-mcp toolset to discover nodes, validate configs, or manage workflows.
The task involves choosing the right MCP tool or understanding its expected parameters and usage pattern.
You need guidance on workflow creation or editing through n8n MCP rather than through the n8n UI alone.
Tool Categories
n8n-mcp provides tools organized into categories:
Node Discovery → SEARCH_GUIDE.mdConfiguration Validation → VALIDATION_GUIDE.mdWorkflow Management → WORKFLOW_GUIDE.mdTemplate Library - Search and deploy 2,700+ real workflowsDocumentation & Guides - Tool docs, AI agent guide, Code node guides
Quick Reference
Most Used Tools (by success rate)
Tool Use When Speed search_nodesFinding nodes by keyword <20ms get_nodeUnderstanding node operations (detail="standard") <10ms validate_nodeChecking configurations (mode="full") <100ms n8n_create_workflowCreating workflows 100-500ms n8n_update_partial_workflowEditing workflows (MOST USED!) 50-200ms validate_workflowChecking complete workflow 100-500ms n8n_deploy_templateDeploy template to n8n instance 200-500ms
Tool Selection Guide
Finding the Right Node
Workflow :
1. search_nodes({query: "keyword"})
2. get_node({nodeType: "nodes-base.name"})
3. [Optional] get_node({nodeType: "nodes-base.name", mode: "docs"})
Example :
search_nodes
query
"slack"
get_node
nodeType
"nodes-base.slack"
get_node
nodeType
"nodes-base.slack"
mode
"docs"
Common pattern : search → get_node (18s average)
Validating Configuration 1. validate_node({nodeType, config: {}, mode: "minimal"}) - Check required fields
2. validate_node({nodeType, config, profile: "runtime"}) - Full validation
3. [Repeat] Fix errors, validate again
Common pattern : validate → fix → validate (23s thinking, 58s fixing per cycle)
Managing Workflows 1. n8n_create_workflow({name, nodes, connections})
2. n8n_validate_workflow({id})
3. n8n_update_partial_workflow({id, operations: [...]})
4. n8n_validate_workflow({id}) again
5. n8n_update_partial_workflow({id, operations: [{type: "activateWorkflow"}]})
Common pattern : iterative updates (56s average between edits)
Critical: nodeType Formats Two different formats for different tools!
Format 1: Search/Validate Tools
"nodes-base.slack"
"nodes-base.httpRequest"
"nodes-base.webhook"
"nodes-langchain.agent"
search_nodes (returns this format)
get_node
validate_node
validate_workflow
Format 2: Workflow Tools
"n8n-nodes-base.slack"
"n8n-nodes-base.httpRequest"
"n8n-nodes-base.webhook"
"@n8n/n8n-nodes-langchain.agent"
n8n_create_workflow
n8n_update_partial_workflow
Conversion
{
"nodeType" : "nodes-base.slack" ,
"workflowNodeType" : "n8n-nodes-base.slack"
}
Common Mistakes
Mistake 1: Wrong nodeType Format Problem : "Node not found" error
get_node ({nodeType : "slack" })
get_node ({nodeType : "n8n-nodes-base.slack" })
get_node ({nodeType : "nodes-base.slack" })
Mistake 2: Using detail="full" by Default Problem : Huge payload, slower response, token waste
get_node ({nodeType : "nodes-base.slack" , detail : "full" })
get_node ({nodeType : "nodes-base.slack" })
get_node ({nodeType : "nodes-base.slack" , detail : "standard" })
When to use detail="full" :
Debugging complex configuration issues
Need complete property schema with all nested options
Exploring advanced features
get_node({detail: "standard"}) - for operations list (default)get_node({mode: "docs"}) - for readable documentationget_node({mode: "search_properties", propertyQuery: "auth"}) - for specific property
Mistake 3: Not Using Validation Profiles Problem : Too many false positives OR missing real errors
minimal - Only required fields (fast, permissive)runtime - Values + types (recommended for pre-deployment)ai-friendly - Reduce false positives (for AI configuration)strict - Maximum validation (for production)
validate_node ({nodeType, config})
validate_node ({nodeType, config, profile : "runtime" })
Mistake 4: Ignoring Auto-Sanitization What happens : ALL nodes sanitized on ANY workflow update
Binary operators (equals, contains) → removes singleValue
Unary operators (isEmpty, isNotEmpty) → adds singleValue: true
IF/Switch nodes → adds missing metadata
Broken connections
Branch count mismatches
Paradoxical corrupt states
n8n_update_partial_workflow ({id, operations : [...]})
Mistake 5: Not Using Smart Parameters Problem : Complex sourceIndex calculations for multi-output nodes
{
type : "addConnection" ,
source : "IF" ,
target : "Handler" ,
sourceIndex : 0
}
New way (smart parameters):
{
type : "addConnection" ,
source : "IF" ,
target : "True Handler" ,
branch : "true"
}
{
type : "addConnection" ,
source : "IF" ,
target : "False Handler" ,
branch : "false"
}
{
type : "addConnection" ,
source : "Switch" ,
target : "Handler A" ,
case : 0
}
Mistake 6: Not Using intent Parameter Problem : Less helpful tool responses
n8n_update_partial_workflow ({
id : "abc" ,
operations : [{type : "addNode" , node : {...}}]
})
n8n_update_partial_workflow ({
id : "abc" ,
intent : "Add error handling for API failures" ,
operations : [{type : "addNode" , node : {...}}]
})
Tool Usage Patterns
Pattern 1: Node Discovery (Most Common) Common workflow : 18s average between steps
const results = await search_nodes ({
query : "slack" ,
mode : "OR" ,
limit : 20
});
const details = await get_node ({
nodeType : "nodes-base.slack" ,
includeExamples : true
});
Pattern 2: Validation Loop Typical cycle : 23s thinking, 58s fixing
const result = await validate_node ({
nodeType : "nodes-base.slack" ,
config : {
resource : "channel" ,
operation : "create"
},
profile : "runtime"
});
if (!result.valid ) {
console .log (result.errors );
}
config.name = "general" ;
await validate_node ({...});
Pattern 3: Workflow Editing Most used update tool : 99.0% success rate, 56s average between edits
await n8n_update_partial_workflow ({
id : "workflow-id" ,
intent : "Add webhook trigger" ,
operations : [{type : "addNode" , node : {...}}]
});
await n8n_update_partial_workflow ({
id : "workflow-id" ,
intent : "Connect webhook to processor" ,
operations : [{type : "addConnection" , source : "..." , target : "..." }]
});
await n8n_validate_workflow ({id : "workflow-id" });
await n8n_update_partial_workflow ({
id : "workflow-id" ,
intent : "Activate workflow for production" ,
operations : [{type : "activateWorkflow" }]
});
Detailed Guides
Node Discovery Tools
search_nodes
get_node with detail levels (minimal, standard, full)
get_node modes (info, docs, search_properties, versions)
Validation Tools See VALIDATION_GUIDE.md for:
Validation profiles explained
validate_node with modes (minimal, full)
validate_workflow complete structure
Auto-sanitization system
Handling validation errors
Workflow Management See WORKFLOW_GUIDE.md for:
n8n_create_workflow
n8n_update_partial_workflow (17 operation types!)
Smart parameters (branch, case)
AI connection types (8 types)
Workflow activation (activateWorkflow/deactivateWorkflow)
n8n_deploy_template
n8n_workflow_versions
Template Usage
Search Templates
search_templates ({
query : "webhook slack" ,
limit : 20
});
search_templates ({
searchMode : "by_nodes" ,
nodeTypes : ["n8n-nodes-base.httpRequest" , "n8n-nodes-base.slack" ]
});
search_templates ({
searchMode : "by_task" ,
task : "webhook_processing"
});
search_templates ({
searchMode : "by_metadata" ,
complexity : "simple" ,
maxSetupMinutes : 15
});
Get Template Details get_template ({
templateId : 2947 ,
mode : "structure"
});
get_template ({
templateId : 2947 ,
mode : "full"
});
Deploy Template Directly
n8n_deploy_template ({
templateId : 2947 ,
name : "My Weather to Slack" ,
autoFix : true ,
autoUpgradeVersions : true
});
Self-Help Tools
Get Tool Documentation
tools_documentation ()
tools_documentation ({
topic : "search_nodes" ,
depth : "full"
})
tools_documentation ({topic : "javascript_code_node_guide" , depth : "full" })
tools_documentation ({topic : "python_code_node_guide" , depth : "full" })
AI Agent Guide
Health Check
n8n_health_check ()
n8n_health_check ({mode : "diagnostic" })
Tool Availability Always Available (no n8n API needed):
search_nodes, get_node
validate_node, validate_workflow
search_templates, get_template
tools_documentation, ai_agents_guide
Requires n8n API (N8N_API_URL + N8N_API_KEY):
n8n_create_workflow
n8n_update_partial_workflow
n8n_validate_workflow (by ID)
n8n_list_workflows, n8n_get_workflow
n8n_test_workflow
n8n_executions
n8n_deploy_template
n8n_workflow_versions
n8n_autofix_workflow
If API tools unavailable, use templates and validation-only workflows.
Unified Tool Reference
get_node (Unified Node Information) Detail Levels (mode="info", default):
minimal (~200 tokens) - Basic metadata onlystandard (~1-2K tokens) - Essential properties + operations (RECOMMENDED)full (~3-8K tokens) - Complete schema (use sparingly)
info (default) - Node schema with detail leveldocs - Readable markdown documentationsearch_properties - Find specific properties (use with propertyQuery)versions - List all versions with breaking changescompare - Compare two versionsbreaking - Show only breaking changesmigrations - Show auto-migratable changes
get_node ({nodeType : "nodes-base.httpRequest" })
get_node ({nodeType : "nodes-base.webhook" , mode : "docs" })
get_node ({nodeType : "nodes-base.httpRequest" , mode : "search_properties" , propertyQuery : "auth" })
get_node ({nodeType : "nodes-base.executeWorkflow" , mode : "versions" })
validate_node (Unified Validation)
full (default) - Comprehensive validation with errors/warnings/suggestionsminimal - Quick required fields check only Profiles (for mode="full"):
minimal - Very lenientruntime - Standard (default, recommended)ai-friendly - Balanced for AI workflowsstrict - Most thorough (production)
validate_node ({nodeType : "nodes-base.slack" , config : {...}, profile : "runtime" })
validate_node ({nodeType : "nodes-base.webhook" , config : {}, mode : "minimal" })
Performance Characteristics Tool Response Time Payload Size search_nodes <20ms Small get_node (standard) <10ms ~1-2KB get_node (full) <100ms 3-8KB validate_node (minimal) <50ms Small validate_node (full) <100ms Medium validate_workflow 100-500ms Medium n8n_create_workflow 100-500ms Medium n8n_update_partial_workflow 50-200ms Small n8n_deploy_template 200-500ms Medium
Best Practices
Do
Use get_node({detail: "standard"}) for most use cases
Specify validation profile explicitly (profile: "runtime")
Use smart parameters (branch, case) for clarity
Include intent parameter in workflow updates
Follow search → get_node → validate workflow
Iterate workflows (avg 56s between edits)
Validate after every significant change
Use includeExamples: true for real configs
Use n8n_deploy_template for quick starts
Don't
Use detail: "full" unless necessary (wastes tokens)
Forget nodeType prefix (nodes-base.*)
Skip validation profiles
Try to build workflows in one shot (iterate!)
Ignore auto-sanitization behavior
Use full prefix (n8n-nodes-base.*) with search/validate tools
Forget to activate workflows after building
Summary
Use get_node with detail: "standard" (default) - covers 95% of use cases
nodeType formats differ: nodes-base.* (search/validate) vs n8n-nodes-base.* (workflows)
Specify validation profiles (runtime recommended)
Use smart parameters (branch="true", case=0)
Include intent parameter in workflow updates
Auto-sanitization runs on ALL nodes during updatesWorkflows can be activated via API (activateWorkflow operation)
Workflows are built iteratively (56s avg between edits)
search_nodes → find node
get_node → understand config
validate_node → check config
n8n_create_workflow → build
n8n_validate_workflow → verify
n8n_update_partial_workflow → iterate
activateWorkflow → go live!
SEARCH_GUIDE.md - Node discovery
VALIDATION_GUIDE.md - Configuration validation
WORKFLOW_GUIDE.md - Workflow management
n8n Expression Syntax - Write expressions in workflow fields
n8n Workflow Patterns - Architectural patterns from templates
n8n Validation Expert - Interpret validation errors
n8n Node Configuration - Operation-specific requirements
n8n Code JavaScript - Write JavaScript in Code nodes
n8n Code Python - Write Python in Code nodes
Connections
Domain: [[Produktivitaet & Werkzeuge]]Kategorie: [[Developer Experience]]Navigation: [[Skills Uebersicht]], [[Home]] 