π The fast, Pythonic way to build MCP servers and clients.
fix(client): forward max_sse_event_size through StreamableHttpTransport (#6016)
PrathmeshPawareeb6e93bf899
diff --git a/docs/clients/transports.mdx b/docs/clients/transports.mdxindex ef6af90c9..1c026c927 100644--- a/docs/clients/transports.mdx+++ b/docs/clients/transports.mdx@@ -109,6 +109,23 @@ transport = StdioTransport(command="python", args=["server.py"], keep_alive=FalsHTTP transport connects to MCP servers running as web services. This is the recommended transport for production deployments.+Incoming SSE events are limited to 1 MiB by default. If a server returns larger+tool results or resources, set `max_sse_event_size` on `StreamableHttpTransport`+to a byte limit that accommodates them, or use `None` to disable the limit:++```python+from fastmcp import Client+from fastmcp.client.transports import StreamableHttpTransport++transport = StreamableHttpTransport(+ "https://api.example.com/mcp",+ max_sse_event_size=8 * 1024 * 1024,+)+client = Client(transport)+```++The same field is available as `max_sse_event_size` on an [MCP config](/integrations/mcp-json-configuration)'s remote server entry, which forwards it when building the transport. A client created from a bare URL (`Client("https://api.example.com/mcp")`) keeps the 1 MiB default; pass an explicit `StreamableHttpTransport` as above to raise or disable it.+```pythonfrom fastmcp import Clientfrom fastmcp.client.transports import StreamableHttpTransportdiff --git a/fastmcp_slim/fastmcp/client/transports/http.py b/fastmcp_slim/fastmcp/client/transports/http.pyindex c3cc62619..e4e008529 100644--- a/fastmcp_slim/fastmcp/client/transports/http.py+++ b/fastmcp_slim/fastmcp/client/transports/http.py@@ -38,6 +38,8 @@ class StreamableHttpTransport(ClientTransport):auth: httpx2.Auth | Literal["oauth"] | str | None = None,httpx_client_factory: McpHttpClientFactory | None = None,verify: ssl.SSLContext | bool | str | None = None,+ *,+ max_sse_event_size: int | None = 1024 * 1024,):"""Initialize a Streamable HTTP transport.@@ -54,6 +56,8 @@ class StreamableHttpTransport(ClientTransport):verification, a path to a CA bundle, or an ssl.SSLContextfor full control. None (default) uses httpx defaults (verificationenabled). Ignored when httpx_client_factory is provided.+ max_sse_event_size: Maximum size in bytes of an incoming SSE event.+ Defaults to 1 MiB. None disables the limit."""if isinstance(url, AnyUrl):url = str(url)@@ -67,6 +71,7 @@ class StreamableHttpTransport(ClientTransport):self.headers = headers or {}self.httpx_client_factory = httpx_client_factoryself.verify: ssl.SSLContext | bool | str | None = verify+ self.max_sse_event_size = max_sse_event_sizeif httpx_client_factory is not None and verify is not None:import warnings@@ -214,7 +219,11 @@ class StreamableHttpTransport(ClientTransport):# yields a 2-tuple (read, write); get_session_id is gone from the transport.async with (http_client,- streamable_http_client(self.url, http_client=http_client) as (+ streamable_http_client(+ self.url,+ http_client=http_client,+ max_sse_event_size=self.max_sse_event_size,+ ) as (read_stream,write_stream,),diff --git a/fastmcp_slim/fastmcp/mcp_config.py b/fastmcp_slim/fastmcp/mcp_config.pyindex 786afc448..c311da00d 100644--- a/fastmcp_slim/fastmcp/mcp_config.py+++ b/fastmcp_slim/fastmcp/mcp_config.py@@ -259,6 +259,12 @@ class RemoteMCPServer(BaseModel):sse_read_timeout: datetime.timedelta | int | float | None = Nonetimeout: int | None = None # Maximum response time in milliseconds+ # Streamable HTTP configuration+ max_sse_event_size: int | None = 1024 * 1024+ """Maximum size in bytes of an incoming SSE event on the streamable HTTP+ transport. Defaults to 1 MiB. None disables the limit. Ignored for SSE+ transport."""+# Metadatadescription: str | None = None # Human-readable server descriptionicon: str | None = None # Icon path or URL for UI display@@ -296,6 +302,7 @@ class RemoteMCPServer(BaseModel):self.url,headers=self.headers,auth=self.auth,+ max_sse_event_size=self.max_sse_event_size,)diff --git a/fastmcp_slim/pyproject.toml b/fastmcp_slim/pyproject.tomlindex bb0ccf7c2..405e5aa15 100644--- a/fastmcp_slim/pyproject.toml+++ b/fastmcp_slim/pyproject.toml@@ -86,7 +86,7 @@ mcp = [# client auth) requires it, and all FastMCP-owned HTTP (server auth provider# upstream calls, OpenAPI provider, version check, etc.) uses it too."httpx2>=2.5.0",- "mcp>=2.2.0,<3.0.0",+ "mcp>=2.3.0,<3.0.0","opentelemetry-api>=1.28.0",# starlette floor: transitive via mcp (which only requires >=0.27).# Pin past CVE-2026-48710, which was patched in 1.0.1.diff --git a/tests/client/transports/test_sse_event_size.py b/tests/client/transports/test_sse_event_size.pynew file mode 100644index 000000000..6deca708f--- /dev/null+++ b/tests/client/transports/test_sse_event_size.py@@ -0,0 +1,47 @@+import pytest+from mcp import MCPError+from mcp_types import TextResourceContents++from fastmcp import Client, FastMCP+from fastmcp.client.transports import StreamableHttpTransport+from fastmcp.utilities.tests import asgi_server++[email protected]("limit", [None, 4 * 1024 * 1024])+async def test_large_sse_tool_and_resource_results(limit: int | None):+ server = FastMCP("large-results")+ payload = "x" * (1024 * 1024 + 1)++ @server.tool+ def large_result() -> str:+ return payload++ @server.resource("data://large")+ def large_resource() -> str:+ return payload++ async with asgi_server(server, json_response=False) as running:+ transport = StreamableHttpTransport(+ running.url,+ httpx_client_factory=running.http_client,+ max_sse_event_size=limit,+ )+ async with Client(transport, mode="legacy") as client:+ result = await client.call_tool("large_result")+ assert result.data == payload+ resource = await client.read_resource("data://large")+ assert isinstance(resource[0], TextResourceContents)+ assert resource[0].text == payload+++async def test_default_sse_event_size_still_rejects_large_results():+ server = FastMCP("large-results")++ @server.tool+ def large_result() -> str:+ return "x" * (1024 * 1024 + 1)++ async with asgi_server(server, json_response=False) as running:+ async with Client(running.transport(), mode="legacy") as client:+ with pytest.raises(MCPError, match="exceeded"):+ await client.call_tool("large_result")diff --git a/tests/test_mcp_config.py b/tests/test_mcp_config.pyindex 69ab1e59e..9da72bf1f 100644--- a/tests/test_mcp_config.py+++ b/tests/test_mcp_config.py@@ -580,6 +580,39 @@ def test_parse_single_remote_config():assert transport.url == "http://localhost:8000"+def test_parse_single_remote_config_default_sse_event_size():+ config = {+ "mcpServers": {+ "test_server": {+ "url": "http://localhost:8000",+ }+ }+ }+ mcp_config = MCPConfig.from_dict(config)+ server = mcp_config.mcpServers["test_server"]+ assert isinstance(server, RemoteMCPServer)+ assert server.max_sse_event_size == 1024 * 1024+ transport = server.to_transport()+ assert isinstance(transport, StreamableHttpTransport)+ assert transport.max_sse_event_size == 1024 * 1024+++def test_remote_config_max_sse_event_size_passthrough():+ """max_sse_event_size is forwarded from RemoteMCPServer to StreamableHttpTransport."""+ server = RemoteMCPServer(url="http://localhost:8000", max_sse_event_size=None)+ assert server.max_sse_event_size is None+ transport = server.to_transport()+ assert isinstance(transport, StreamableHttpTransport)+ assert transport.max_sse_event_size is None++ server = RemoteMCPServer(+ url="http://localhost:8000", max_sse_event_size=4 * 1024 * 1024+ )+ transport = server.to_transport()+ assert isinstance(transport, StreamableHttpTransport)+ assert transport.max_sse_event_size == 4 * 1024 * 1024++def test_parse_remote_config_with_transport():config = {"mcpServers": {diff --git a/uv.lock b/uv.lockindex 75242471a..b035e84bf 100644--- a/uv.lock+++ b/uv.lock@@ -1,5 +1,5 @@version = 1-revision = 3+revision = 5requires-python = ">=3.10"resolution-markers = ["python_full_version >= '3.15' and sys_platform == 'win32'",@@ -20,18 +20,18 @@ exclude-newer = "0001-01-01T00:00:00Z" # This has no effect and is included forexclude-newer-span = "P1W"[options.exclude-newer-package]-mcp-types = false-prefab-ui = false-pydocket = false-pydantic-monty-runtime = false-pydantic-monty-client = false-uncalled-for = falsecertifi = falsefastmcp = false-mcp = false-pydantic-monty = falsefastmcp-remote = falsefastmcp-slim = false+mcp = false+mcp-types = false+prefab-ui = false+pydantic-monty = false+pydantic-monty-client = false+pydantic-monty-runtime = false+pydocket = false+uncalled-for = false[manifest]members = [@@ -1105,9 +1105,9 @@ requires-dist = [{ name = "jsonref", marker = "extra == 'gemini'", specifier = ">=1.1.0" },{ name = "jsonref", marker = "extra == 'server'", specifier = ">=1.1.0" },{ name = "jsonschema-path", marker = "extra == 'server'", specifier = ">=0.3.4" },- { name = "mcp", marker = "extra == 'client'", specifier = ">=2.2.0,<3.0.0" },- { name = "mcp", marker = "extra == 'mcp'", specifier = ">=2.2.0,<3.0.0" },- { name = "mcp", marker = "extra == 'server'", specifier = ">=2.2.0,<3.0.0" },+ { name = "mcp", marker = "extra == 'client'", specifier = ">=2.3.0,<3.0.0" },+ { name = "mcp", marker = "extra == 'mcp'", specifier = ">=2.3.0,<3.0.0" },+ { name = "mcp", marker = "extra == 'server'", specifier = ">=2.3.0,<3.0.0" },{ name = "mcp-types", specifier = ">=2.0.0,<3.0.0" },{ name = "openai", marker = "extra == 'openai'", specifier = ">=1.102.0" },{ name = "openapi-pydantic", marker = "extra == 'server'", specifier = ">=0.6.0" },@@ -1693,7 +1693,7 @@ wheels = [[[package]]name = "mcp"-version = "2.2.0"+version = "2.3.0"source = { registry = "https://pypi.org/simple" }dependencies = [{ name = "anyio" },@@ -1711,22 +1711,22 @@ dependencies = [{ name = "typing-inspection" },{ name = "uvicorn", marker = "sys_platform != 'emscripten'" },]-sdist = { url = "https://files.pythonhosted.org/packages/76/31/ac54fb0fdd5b37de704486e288bba4fbbb463f24cfcfedbede407b854513/mcp-2.2.0.tar.gz", hash = "sha256:2dc37ecb1974becdcebdbf7561e7c15a07dbbf20ba21ba16c3593b3038b3afbd", size = 4084129, upload-time = "2026-09-07T16:06:23.439Z" }+sdist = { url = "https://files.pythonhosted.org/packages/9d/8d/e0d339616f4810e9051d4aba6887afab289ab1f81875fe908b606cdfd0e3/mcp-2.3.0.tar.gz", hash = "sha256:8b147a50441cf059dc88c684e0aeed3687f0aa0f39c6cde7b90330effd2b34d8", size = 4171955, upload-time = "2026-10-02T22:06:56.091Z" }wheels = [- { url = "https://files.pythonhosted.org/packages/1b/ff/8e7eade68b8a28f7da0ed1085544341b51f9c935dbf6b95c76b7edfea6a0/mcp-2.2.0-py3-none-any.whl", hash = "sha256:bde982589473a060ae145e3406e9a5333fe538c97229ba841f5a7f92be004f81", size = 365656, upload-time = "2026-09-07T16:06:19.711Z" },+ { url = "https://files.pythonhosted.org/packages/20/d7/4a2878f128df729db3ca04e71bfce26405cc2e0c9ebe19c592feeb4c61b9/mcp-2.3.0-py3-none-any.whl", hash = "sha256:dd0c44c089d16453e8ae31a3877a0054d7a2314caaa81f5e0541b9b1734b2377", size = 368664, upload-time = "2026-10-02T22:06:52.119Z" },][[package]]name = "mcp-types"-version = "2.2.0"+version = "2.3.0"source = { registry = "https://pypi.org/simple" }dependencies = [{ name = "pydantic" },{ name = "typing-extensions" },]-sdist = { url = "https://files.pythonhosted.org/packages/ae/91/762d7755d971aff8a28d75f7961656148edf27875c8026e6385aaab08ae7/mcp_types-2.2.0.tar.gz", hash = "sha256:d3ed53703ddd10d9c6399f29d322bb66f3f67ab41348ac8556ba23e07fedefad", size = 65892, upload-time = "2026-09-07T16:06:25.187Z" }+sdist = { url = "https://files.pythonhosted.org/packages/9e/2d/7c251e34207f6c51000312fc8839111ac45cfe02023f90b44e7f1051dd8e/mcp_types-2.3.0.tar.gz", hash = "sha256:d1e46549edb35ee19a94940fcee6d1addd7e589ab7ea92dda83f5d84781fc362", size = 65898, upload-time = "2026-10-02T22:06:57.863Z" }wheels = [- { url = "https://files.pythonhosted.org/packages/8f/d7/6ffba5d8cd5dd9b8a19478875c50e04945314ba5074e84d749283f27f62d/mcp_types-2.2.0-py3-none-any.whl", hash = "sha256:ea476b73ee86709ab5abc9452385ed36cc05907e582355622e294595c9a04f13", size = 69106, upload-time = "2026-09-07T16:06:21.461Z" },+ { url = "https://files.pythonhosted.org/packages/ce/48/32583066b155bb5d4507e7887dc88ee23118cc4de8e2a12870c49719e2a8/mcp_types-2.3.0-py3-none-any.whl", hash = "sha256:968efdbdaedfab06adae40d378a34395f1090c5921d4be3c9cde283aaf76d91d", size = 69108, upload-time = "2026-10-02T22:06:54.099Z" },][[package]]