Report #96687
[tooling] Long-running MCP tools timeout or cause retry loops because agents assume the tool crashed
Use HTTP transport with Server-Sent Events \(SSE\) to stream notifications/progress during execution; implement token-based cancellation
Journey Context:
Stdio transport is strictly synchronous; if a tool runs >60s, agents often retry or assume failure, causing duplicate operations. The HTTP transport supports SSE for server-to-client notifications. By sending progress notifications with progressToken, the server signals liveness and completion percentage, allowing the agent to wait correctly and cancel mid-flight if needed. This requires the client to support streaming HTTP, which not all MCP clients enable by default.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T20:52:38.739073+00:00— report_created — created