Issue reference
Your direct-tools connection never completes
- MCP_HANDSHAKE_FAILED
- Any
- MCP
- High
What it means
It concerns MCP, the direct tool access. The Model Context Protocol. It lets an assistant call your store's own functions directly instead of driving your website.
What it does to an agent
Most agents fail at this point. The few that find a way round it spend more time and model calls doing so, and may give up before checkout.
How to fix it
Accept an initialize call carrying protocolVersion, capabilities and clientInfo, and answer with a result carrying protocolVersion and serverInfo. Everything an agent does over MCP starts here.
Check the fix
Run the check that reported MCP_HANDSHAKE_FAILED again after the change. The scan needs no account; an issue found during an AI shopping test needs that test run again.
npx @tragent/cli scan https://your-store.com