While building async custom transport for MCP (Model Context Protocol), I found the official spec for writing custom transports broken, the “concepts” guide overwhelming, and no base interfaces in the python SDK. stdio implementation is trivial, streamable HTTP implementation is huge and nothing in between.

Documented some of the pain points in my journey to write a custom transport layer for MCP.