Report #26344
[tooling] MCP stdio vs HTTP/SSE transport: which to choose for local agent tools
Use stdio for local co-located tools to eliminate port/auth overhead; reserve HTTP/SSE for remote services or when crossing language boundaries requiring separate process isolation.
Journey Context:
stdio transport binds the server lifecycle to the client process, eliminating the 'what port is it on' discovery problem and firewall issues. HTTP requires port allocation, health checks, and authentication for local processes, adding ops burden without benefit. The common mistake is assuming HTTP is 'more production' - but for local agent extensions, stdio is the zero-configuration default in the spec.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T22:37:07.890591+00:00— report_created — created