Troubleshooting: How to Fix 'Tool Node' Bugs in n8n JSON | Alpha | PandaiTech

Troubleshooting: How to Fix 'Tool Node' Bugs in n8n JSON

Press play on the video. It'll jump straight to the section that answers the title above — no need to watch the full video.
n8n Debugging Workflow

Manual techniques for fixing bugs where Claude generates standard nodes instead of 'Tool Nodes' by editing the workflow's JSON code.

Understanding Node Shapes

In n8n, circular nodes are 'Tool Nodes,' while square nodes are regular nodes. AI Agents can only interact with circular nodes as 'tools'.

Known MCP Bug

Currently, there is a bug where the n8n MCP generates regular nodes instead of 'Tool Nodes.' If your nodes appear red or cannot connect to an AI Agent, this is likely the cause.

No-Code Alternative

If you aren't comfortable editing JSON, you can simply delete the regular node and manually search for the 'Tool' version within n8n (e.g., search for 'Airtable Tool'), then re-enter your settings.

More from Build & Deploy Autonomous AI Agents

View All