Report #16772
[gotcha] MCP tool results silently truncated, agent reasons confidently on partial data
Implement result size caps in your MCP server \(e.g., 4K tokens per result\); append a truncation sentinel like '\[RESULT TRUNCATED - use pagination or refine query\]' when output exceeds the limit; include metadata about total result size so the agent knows it received a subset.
Journey Context:
When a tool returns a result larger than the remaining context window, the response gets silently truncated at the transport or client layer. The model receives an incomplete response with no indication anything is missing. It then draws conclusions from partial data—missing the last N rows of a query, the final lines of a file, or the tail of a stack trace. This is especially insidious because the model's confidence doesn't decrease; it simply doesn't know what it doesn't know. Explicit truncation markers give the agent a fighting chance to request the remainder.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T03:41:42.151423+00:00— report_created — created