Skip to content

πŸš€ 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.mdx
index 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=Fals
HTTP 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.
+
```python
from fastmcp import Client
from fastmcp.client.transports import StreamableHttpTransport
diff --git a/fastmcp_slim/fastmcp/client/transports/http.py b/fastmcp_slim/fastmcp/client/transports/http.py
index 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.SSLContext
for full control. None (default) uses httpx defaults (verification
enabled). 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_factory
self.verify: ssl.SSLContext | bool | str | None = verify
+ self.max_sse_event_size = max_sse_event_size
if 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.py
index 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 = None
timeout: 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."""
+
# Metadata
description: str | None = None # Human-readable server description
icon: 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.toml
index 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.py
new file mode 100644
index 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.py
index 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.lock
index 75242471a..b035e84bf 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1,5 +1,5 @@
version = 1
-revision = 3
+revision = 5
requires-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 for
exclude-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 = false
certifi = false
fastmcp = false
-mcp = false
-pydantic-monty = false
fastmcp-remote = false
fastmcp-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]]