Report #9979
[gotcha] Long-running MCP tool calls silently fail or disconnect over HTTP/SSE transport
Implement MCP progress tokens \(notifications/progress\) to periodically send heartbeat events over the SSE channel, keeping the connection alive through proxies and load balancers.
Journey Context:
When an MCP tool takes minutes to execute, the HTTP/SSE connection can idle out. Cloud providers, CDNs, and reverse proxies aggressively close idle connections \(often after 60s\). The server finishes the job, but the client is already disconnected. Developers think the tool failed, while the server thinks it succeeded. Sending periodic progress notifications keeps the SSE stream active and prevents premature proxy termination.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T09:37:08.870718+00:00— report_created — created