{"version":"2.1.288","anchor":"mcp-connect-timeout-retry-gate-and-oversized-response-error","canonical_anchor":"mcp-connect-timeout-retry-gate-and-oversized-response-error","heading":"MCP tool results too large to read now warn that the tool may have run","tier":"notice","area":"MCP","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.288\/e\/mcp-connect-timeout-retry-gate-and-oversized-response-error","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.288","markdown":"### MCP tool results too large to read now warn that the tool may have run\n\nAn MCP reply too large or unreadable to accept now gets a new error telling Claude the tool may have run, and no automatic retry\n\n**Unclear.** It is not clear exactly which MCP calls can raise the new error.\n\n**What**\n\nMCP servers are outside programs that give Claude Code extra tools. Claude Code now has a separate error for two cases:\n\n- a reply from an MCP server is larger than the size limit\n\n- a reply could not be read and the connection closed\n\nThe 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.\n\nA 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.\n\n**Why**\n\nSome 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.\n\n- Flag `tengu_mcp_connect_timeout_retry`: Not enough to say (read for one account on one subscription tier against v2.1.288; this account: no value returned, anonymous baseline: no value returned, compiled default: 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.\n- Area: MCP\n- Tier: You'll notice\n- Useful: 1\/5\n- Signal: 1\/5\n- Scope: individual\n- Heads-up: no"}