n8n MCP Tools Expert is a skill for Claude that explains how to call the n8n-mcp server’s tools without the usual mistakes. It groups the tools into node discovery, validation, workflow management, templates, data tables, folders, variables, credentials, security audits, persisted agents and an instance catalog.
It gives the search, get_node, validate, create and partial-update loop, the difference between the short nodeType form for search and validate tools and the full form for workflow tools, rules for node JSON, the test run methods, version history and which tools need an API key or an access token.
What You Get
- A tool selection guide for finding nodes, validating configuration and managing workflows
- The two nodeType formats and which tools take each
- A table of eight common mistakes with fixes, and node JSON rules on UUID ids, typeVersion and credentials blocks
- The test run methods auto, trigger, prepare, pinned and direct, with the pinData shape
- Notes on version history, data tables, folders, variables, credentials and security audits
- A tool availability list that separates tools needing no API from those needing an API key or an access token
Common Use Cases
- Searching for the right node and reading its configuration
- Building a workflow step by step and validating after each change
- Running a workflow with pinned data to test it
- Auditing an instance for hardcoded secrets and open webhooks
- Rotating or deleting a credential after checking where it is used
What Makes It Unique
It is the hub of the n8n skill set and holds the practical details of the n8n-mcp server: tool speeds, payload sizes, error codes and which features need extra tokens or n8n versions. It tells Claude to ask before running workflows that write data, to confirm before dropping a table column and to omit credentials blocks whose IDs it does not know.
Under The Hood
The skill is instructions and four reference markdown files, with no scripts. It tells Claude to call the n8n-mcp tools, which read node documentation offline and, with an API key, create, edit, activate, test and delete workflows, data tables, folders, variables and credentials on your n8n server and read its executions. Test runs execute workflow nodes for real, and the audit and credential tools read instance settings, so the skill asks Claude to confirm with you before runs that write anywhere and before destructive actions.