π 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.mdxindex 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 toolsmcp.add_middleware(ResponseLimitingMiddleware(