n8n MCP Tools Expert
Master guide for using n8n-mcp MCP server tools to build, validate, and manage n8n workflows.
Tool Categories
- Node discovery →
SEARCH_GUIDE.md
- Configuration validation →
VALIDATION_GUIDE.md
- Workflow management →
WORKFLOW_GUIDE.md
- Template library →
search_templates, get_template, n8n_deploy_template
- Data tables →
n8n_manage_datatable
- Documentation and guides →
tools_documentation, ai_agents_guide, Code node guides
Fast Path
- Search:
search_nodes({query: "keyword"})
- Inspect:
get_node({nodeType: "nodes-base.name"})
- Validate:
validate_node({nodeType, config, profile: "runtime"})
- Create or edit workflow.
- Validate workflow.
- Iterate with
n8n_update_partial_workflow.
- Activate only after validation passes.
Most Used Tools
| Tool |
Use When |
search_nodes |
Find nodes by keyword |
get_node |
Understand operations/properties; default detail="standard" |
validate_node |
Check one node config; use profile="runtime" |
n8n_create_workflow |
Create an initial workflow |
n8n_update_partial_workflow |
Iteratively edit workflows; preferred for changes |
validate_workflow / n8n_validate_workflow |
Check complete workflows |
n8n_deploy_template |
Deploy a template to an n8n instance |
n8n_manage_datatable |
CRUD for n8n data tables and rows |
n8n_autofix_workflow |
Auto-fix validation errors |
Critical nodeType Formats
Use short prefixes for search/inspect/validation tools:
"nodes-base.slack"
"nodes-base.httpRequest"
"nodes-langchain.agent"
Use full prefixes inside workflow JSON/tools:
"n8n-nodes-base.slack"
"n8n-nodes-base.httpRequest"
"@n8n/n8n-nodes-langchain.agent"
search_nodes returns both nodeType and workflowNodeType; use the correct one for the target tool.
Safety and Efficiency Rules
- Use
get_node with default/standard detail for most cases; detail="full" is a last resort.
- Always set validation profiles explicitly; prefer
profile="runtime" before deployment.
- Use smart connection parameters such as
branch and case instead of manual sourceIndex when available.
- Include an
intent on workflow updates so tool responses are more useful.
- Expect auto-sanitization on workflow updates; it can fix common node structure issues but not broken connections or paradoxical states.
- Build workflows iteratively rather than one large update.
- Validate after every meaningful change and before activation.
Tool Availability
Always available without n8n API credentials:
search_nodes, get_nodevalidate_node, validate_workflowsearch_templates, get_templatetools_documentation, ai_agents_guide
Requires N8N_API_URL and N8N_API_KEY:
- workflow create/update/list/get/delete/test/executions/version tools
n8n_validate_workflow by IDn8n_deploy_templaten8n_autofix_workflown8n_manage_datatable
If API tools are unavailable, use templates and validation-only workflows.
Detailed References
SEARCH_GUIDE.md — node discovery, detail levels, docs mode, property search, versions.VALIDATION_GUIDE.md — validation profiles, validation structure, auto-sanitization, error handling.WORKFLOW_GUIDE.md — create/update workflow operations, smart parameters, AI connections, activation, versions.references/tool-patterns.md — common mistakes, detailed examples, templates, data table management, self-help tools, unified tool reference, performance, and best practices.
Summary
Most successful n8n-mcp work follows this loop: search → inspect → validate node → create workflow → validate workflow → partial update → validate again → activate. Keep payloads small, use the correct nodeType format, and use references only when the task needs details.
Related Skills: n8n Expression Syntax, n8n Workflow Patterns, n8n Validation Expert, n8n Node Configuration, n8n Code JavaScript, and n8n Code Python.
1---2name: n8n-mcp-tools-expert3description: 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.4---5# n8n MCP Tools Expert67Master guide for using n8n-mcp MCP server tools to build, validate, and manage n8n workflows.89## Tool Categories10111. **Node discovery** → `SEARCH_GUIDE.md`122. **Configuration validation** → `VALIDATION_GUIDE.md`133. **Workflow management** → `WORKFLOW_GUIDE.md`144. **Template library** → `search_templates`, `get_template`, `n8n_deploy_template`155. **Data tables** → `n8n_manage_datatable`166. **Documentation and guides** → `tools_documentation`, `ai_agents_guide`, Code node guides1718## Fast Path19201. Search: `search_nodes({query: "keyword"})`212. Inspect: `get_node({nodeType: "nodes-base.name"})`223. Validate: `validate_node({nodeType, config, profile: "runtime"})`234. Create or edit workflow.245. Validate workflow.256. Iterate with `n8n_update_partial_workflow`.267. Activate only after validation passes.2728## Most Used Tools2930| Tool | Use When |31|---|---|32| `search_nodes` | Find nodes by keyword |33| `get_node` | Understand operations/properties; default `detail="standard"` |34| `validate_node` | Check one node config; use `profile="runtime"` |35| `n8n_create_workflow` | Create an initial workflow |36| `n8n_update_partial_workflow` | Iteratively edit workflows; preferred for changes |37| `validate_workflow` / `n8n_validate_workflow` | Check complete workflows |38| `n8n_deploy_template` | Deploy a template to an n8n instance |39| `n8n_manage_datatable` | CRUD for n8n data tables and rows |40| `n8n_autofix_workflow` | Auto-fix validation errors |4142## Critical nodeType Formats4344Use short prefixes for search/inspect/validation tools:4546```javascript47"nodes-base.slack"48"nodes-base.httpRequest"49"nodes-langchain.agent"50```5152Use full prefixes inside workflow JSON/tools:5354```javascript55"n8n-nodes-base.slack"56"n8n-nodes-base.httpRequest"57"@n8n/n8n-nodes-langchain.agent"58```5960`search_nodes` returns both `nodeType` and `workflowNodeType`; use the correct one for the target tool.6162## Safety and Efficiency Rules6364- Use `get_node` with default/standard detail for most cases; `detail="full"` is a last resort.65- Always set validation profiles explicitly; prefer `profile="runtime"` before deployment.66- Use smart connection parameters such as `branch` and `case` instead of manual `sourceIndex` when available.67- Include an `intent` on workflow updates so tool responses are more useful.68- Expect auto-sanitization on workflow updates; it can fix common node structure issues but not broken connections or paradoxical states.69- Build workflows iteratively rather than one large update.70- Validate after every meaningful change and before activation.7172## Tool Availability7374Always available without n8n API credentials:7576- `search_nodes`, `get_node`77- `validate_node`, `validate_workflow`78- `search_templates`, `get_template`79- `tools_documentation`, `ai_agents_guide`8081Requires `N8N_API_URL` and `N8N_API_KEY`:8283- workflow create/update/list/get/delete/test/executions/version tools84- `n8n_validate_workflow` by ID85- `n8n_deploy_template`86- `n8n_autofix_workflow`87- `n8n_manage_datatable`8889If API tools are unavailable, use templates and validation-only workflows.9091## Detailed References9293- `SEARCH_GUIDE.md` — node discovery, detail levels, docs mode, property search, versions.94- `VALIDATION_GUIDE.md` — validation profiles, validation structure, auto-sanitization, error handling.95- `WORKFLOW_GUIDE.md` — create/update workflow operations, smart parameters, AI connections, activation, versions.96- `references/tool-patterns.md` — common mistakes, detailed examples, templates, data table management, self-help tools, unified tool reference, performance, and best practices.9798## Summary99100Most successful n8n-mcp work follows this loop: search → inspect → validate node → create workflow → validate workflow → partial update → validate again → activate. Keep payloads small, use the correct nodeType format, and use references only when the task needs details.101102**Related Skills:** n8n Expression Syntax, n8n Workflow Patterns, n8n Validation Expert, n8n Node Configuration, n8n Code JavaScript, and n8n Code Python.
kmshihab7878