Follow Discord
Sweep 02 Oct 2026 · 18:55Z Build v2.1.288 509 read Stable v2.1.285 Latest v2.1.288 Next v2.1.288 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.288 ·

MCP tool results too large to read now warn that the tool may have run

An MCP reply too large or unreadable to accept now gets a new error telling Claude the tool may have run, and no automatic retry

You'll notice Improvements
JSON All of v2.1.288
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.288,
ImprovementsSection of the release
What

MCP servers are outside programs that give Claude Code extra tools. Claude Code now has a separate error for two cases:

  • a reply from an MCP server is larger than the size limit
  • a reply could not be read and the connection closed

The error tells Claude: "The tool may have run: check whether it did before running it again." When the connection closes this way, Claude Code no longer automatically reconnects, signs in again and retries.

A connection that fails because a request timed out is still marked as a connection timeout. That marking sits behind a remote switch that falls back to on when the server sends nothing.

Why

Some tools should not run twice, such as one that sends a message or makes a payment. Retrying blindly after an unreadable reply could repeat an action that already happened, so Claude is now told to check first.

Read from
Feature flag
tengu_mcp_connect_timeout_retry Not enough to say

Nothing here resolved what this flag was doing on this version, so nothing here should be read as on or off.

This account: no value returned · anonymous baseline: no value returned · compiled default in v2.1.288: on

These values were read against a different version of Claude Code, so treat them as the nearest reading available instead of one taken on this release.

Read once, for one account on one subscription tier, against v2.1.288. It isn't a statement about your account. What a flag value here can and cannot tell you

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtIt is not clear exactly which MCP calls can raise the new error.

See this entry in the whole of v2.1.288 →

Feedback