Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

Add note about output_schema incongruity when responses are truncated (#3099)

Jeremiah Lowin32c6826e1340
diff --git a/docs/servers/middleware.mdx b/docs/servers/middleware.mdx
index ddf283fb9..cea5d3c27 100644
--- a/docs/servers/middleware.mdx
+++ b/docs/servers/middleware.mdx
@@ -585,6 +585,10 @@ def search(query: str) -> str:
When a response exceeds the limit, the middleware extracts all text content, joins it together, truncates to fit within the limit, and returns a single `TextContent` block. For non-text responses, the serialized JSON is used as the text source.
+<Note>
+If a tool defines an `output_schema`, truncated responses will no longer conform to that schema β€” the client will receive a plain `TextContent` block instead of the expected structured output. Keep this in mind when setting size limits for tools with structured responses.
+</Note>
+
```python
# Limit only specific tools
mcp.add_middleware(ResponseLimitingMiddleware(