n8n MCP Tools Expert
Master guide for using n8n-mcp MCP server tools to build, validate, deploy, and maintain n8n workflows.
Use this skill before calling any n8n MCP tool. The main job is to choose the right tool, use the right node type format, avoid high-token detail modes unless needed, and validate changes before deployment.
Fast Path
- For node discovery, read
SEARCH_GUIDE.md and ToolSelection.md.
- Before passing any
nodeType, read NodeTypeFormats.md.
- Before or after configuring nodes, read
VALIDATION_GUIDE.md.
- For workflow create/update/deploy operations, read
WORKFLOW_GUIDE.md.
- If an MCP call fails or looks suspicious, read
CommonMistakes.md.
Most Used Tools
| Tool |
Use when |
search_nodes |
Finding nodes by keyword |
get_node |
Understanding node operations; default to standard detail |
validate_node |
Checking node configuration |
validate_workflow |
Checking complete workflow structure |
n8n_create_workflow |
Creating workflows |
n8n_update_partial_workflow |
Editing workflows incrementally |
n8n_deploy_template |
Deploying a template workflow |
n8n_manage_datatable |
Managing data tables and rows |
n8n_manage_credentials |
Credential CRUD and schema discovery |
n8n_audit_instance |
Security and configuration audit |
n8n_autofix_workflow |
Auto-fixing validation errors |
Progressive Loading
Read only the file needed for the task:
| Request shape |
Read next |
| Choose MCP tools or find the right node |
ToolSelection.md, SEARCH_GUIDE.md |
| Convert between search/validation node types and workflow node types |
NodeTypeFormats.md |
| Avoid known failures, bad payloads, wrong parameter names, or inefficient calls |
CommonMistakes.md |
| Follow common discovery, validation, or workflow-editing loops |
UsagePatterns.md |
| Templates, data tables, credentials, or security audit |
TemplatesDataCredentialsSecurity.md |
| Tool docs, AI agent guide, health check, availability, unified tool reference, or performance |
SelfHelpAndReference.md |
| High-level do/don't rules and summary |
BestPractices.md |
| Detailed search guide |
SEARCH_GUIDE.md |
| Detailed validation guide |
VALIDATION_GUIDE.md |
| Detailed workflow-management guide |
WORKFLOW_GUIDE.md |
Core Rules
- Use
search_nodes before guessing node names.
- Use
get_node with standard detail by default; do not use full detail unless necessary.
- Use short node types such as
nodes-base.slack for search, docs, and validation tools.
- Use workflow node types such as
n8n-nodes-base.slack when creating or editing workflow nodes.
- Validate node configs and whole workflows before deployment.
- Prefer
n8n_update_partial_workflow for edits instead of replacing full workflows.
- Use validation profiles deliberately:
minimal, runtime, ai-friendly, or strict.
- Do not ignore auto-sanitization behavior after workflow updates.
- For credentials, inspect schemas and required fields before creating or attaching credentials.
- For security work, use
n8n_audit_instance and report real findings rather than generic advice.
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, managing credentials, auditing instance security, or using any n8n-mcp tool. Provides tool selection guidance, parameter formats, and common patterns. IMPORTANT — Always consult this skill before calling any n8n-mcp tool — it prevents common mistakes like wrong nodeType formats, incorrect parameter structures, and inefficient tool usage. If the user mentions n8n, workflows, nodes, or automation and you have n8n MCP tools available, use this skill first.4---56# n8n MCP Tools Expert78Master guide for using n8n-mcp MCP server tools to build, validate, deploy, and maintain n8n workflows.910Use this skill before calling any n8n MCP tool. The main job is to choose the right tool, use the right node type format, avoid high-token detail modes unless needed, and validate changes before deployment.1112## Fast Path13141. For node discovery, read [`SEARCH_GUIDE.md`](SEARCH_GUIDE.md) and [`ToolSelection.md`](ToolSelection.md).152. Before passing any `nodeType`, read [`NodeTypeFormats.md`](NodeTypeFormats.md).163. Before or after configuring nodes, read [`VALIDATION_GUIDE.md`](VALIDATION_GUIDE.md).174. For workflow create/update/deploy operations, read [`WORKFLOW_GUIDE.md`](WORKFLOW_GUIDE.md).185. If an MCP call fails or looks suspicious, read [`CommonMistakes.md`](CommonMistakes.md).1920## Most Used Tools2122| Tool | Use when |23|---|---|24| `search_nodes` | Finding nodes by keyword |25| `get_node` | Understanding node operations; default to standard detail |26| `validate_node` | Checking node configuration |27| `validate_workflow` | Checking complete workflow structure |28| `n8n_create_workflow` | Creating workflows |29| `n8n_update_partial_workflow` | Editing workflows incrementally |30| `n8n_deploy_template` | Deploying a template workflow |31| `n8n_manage_datatable` | Managing data tables and rows |32| `n8n_manage_credentials` | Credential CRUD and schema discovery |33| `n8n_audit_instance` | Security and configuration audit |34| `n8n_autofix_workflow` | Auto-fixing validation errors |3536## Progressive Loading3738Read only the file needed for the task:3940| Request shape | Read next |41|---|---|42| Choose MCP tools or find the right node | [`ToolSelection.md`](ToolSelection.md), [`SEARCH_GUIDE.md`](SEARCH_GUIDE.md) |43| Convert between search/validation node types and workflow node types | [`NodeTypeFormats.md`](NodeTypeFormats.md) |44| Avoid known failures, bad payloads, wrong parameter names, or inefficient calls | [`CommonMistakes.md`](CommonMistakes.md) |45| Follow common discovery, validation, or workflow-editing loops | [`UsagePatterns.md`](UsagePatterns.md) |46| Templates, data tables, credentials, or security audit | [`TemplatesDataCredentialsSecurity.md`](TemplatesDataCredentialsSecurity.md) |47| Tool docs, AI agent guide, health check, availability, unified tool reference, or performance | [`SelfHelpAndReference.md`](SelfHelpAndReference.md) |48| High-level do/don't rules and summary | [`BestPractices.md`](BestPractices.md) |49| Detailed search guide | [`SEARCH_GUIDE.md`](SEARCH_GUIDE.md) |50| Detailed validation guide | [`VALIDATION_GUIDE.md`](VALIDATION_GUIDE.md) |51| Detailed workflow-management guide | [`WORKFLOW_GUIDE.md`](WORKFLOW_GUIDE.md) |5253## Core Rules5455- Use `search_nodes` before guessing node names.56- Use `get_node` with standard detail by default; do not use full detail unless necessary.57- Use short node types such as `nodes-base.slack` for search, docs, and validation tools.58- Use workflow node types such as `n8n-nodes-base.slack` when creating or editing workflow nodes.59- Validate node configs and whole workflows before deployment.60- Prefer `n8n_update_partial_workflow` for edits instead of replacing full workflows.61- Use validation profiles deliberately: `minimal`, `runtime`, `ai-friendly`, or `strict`.62- Do not ignore auto-sanitization behavior after workflow updates.63- For credentials, inspect schemas and required fields before creating or attaching credentials.64- For security work, use `n8n_audit_instance` and report real findings rather than generic advice.
mj-deving