NewThe tragent CLI is on npm: npx @tragent/cli scan your-store.com

Issue reference

Your direct-tools connection never completes

Issue code
MCP_HANDSHAKE_FAILED
Stage
Any
Protocol
MCP
Severity
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.

Terminal
npx @tragent/cli scan https://your-store.com