Follow Discord
Sweep 27 Oct 2026 · 19:04Z Build v2.1.312 531 read Stable v2.1.308 Latest v2.1.312 Next v2.1.312 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.311 ·

Clearer error when an MCP tool's structured result cannot be read

When an MCP tool's structured result cannot be read, Claude is told why and warned the tool may already have run

You'll notice Improvements
JSON All of v2.1.311
You'll noticeTier: how much it should matter to you
1Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
MCPArea: what it touches
ImprovementsKind: in v2.1.311,
ImprovementsSection of the release
What

MCP servers are add-ons that give Claude extra tools. Some tools return structured content, meaning data in a fixed format rather than plain text. When Claude Code cannot read that content, it now reports a specific error saying the content may be too large, nested too deeply, or contain a number that is too large. The error also says the tool may have run anyway, so Claude should check before calling it again.

Why

Claude gets a clear explanation instead of a generic failure, and is warned against simply retrying a tool that may already have done its work.

See this entry in the whole of v2.1.311 →

Feedback