π The fast, Pythonic way to build MCP servers and clients.
chore: Update SDK documentation (#4945)
marvin-context-protocol[bot]f79bc8251bc0
diff --git a/docs/python-sdk/fastmcp-client-group.mdx b/docs/python-sdk/fastmcp-client-group.mdxindex 05d040cca..4c9ea3339 100644--- a/docs/python-sdk/fastmcp-client-group.mdx+++ b/docs/python-sdk/fastmcp-client-group.mdx@@ -25,13 +25,16 @@ Each client retains its own transport, session, capabilities, and protocolversion. The group only combines tool discovery and routes tool calls.Callers may manage the clients' connections themselves or use the group as-a convenience context manager. Entering an already-connected FastMCP client-is safe because client contexts are reference counted.+a convenience context manager. The group's context is reentrant in the+same way a client's is: entries are reference counted, the first entry+connects every client, and the last exit disconnects them. Entering an+already-connected FastMCP client is likewise safe because client contexts+are reference counted.**Methods:**-#### `clients` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L53" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `clients` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L58" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonclients(self) -> Mapping[str, Client[Any]]@@ -44,7 +47,7 @@ hold the client that advertised each tool and would silently go staleif the mapping were swapped underneath them.-#### `from_config` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L63" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `from_config` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L68" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonfrom_config(cls, config: MCPConfig | dict[str, Any]) -> ClientGroup@@ -56,13 +59,13 @@ A server entry may include a FastMCP-specific ``mode`` field. It appliesonly to that server; entries without one use ``default_mode``.-#### `protocol_versions` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L88" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `protocol_versions` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L93" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonprotocol_versions(self) -> dict[str, str | None]```-#### `list_tools` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L152" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `list_tools` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L161" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonlist_tools(self) -> list[mcp_types.Tool]@@ -77,7 +80,7 @@ what every server advertises now. Pass `cache_mode="use"` to allowcache hits when staleness within the server's hint is acceptable.-#### `resolve_tool` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L189" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `resolve_tool` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L198" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonresolve_tool(self, name: str) -> ToolRoute@@ -91,7 +94,7 @@ Loading the catalog (the first resolution, or after a refresh) stillrequires every client, since discovery queries them all.-#### `call_tool_mcp` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L224" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `call_tool_mcp` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L233" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythoncall_tool_mcp(self, name: str, arguments: dict[str, Any] | None = None) -> mcp_types.CallToolResult@@ -100,7 +103,7 @@ call_tool_mcp(self, name: str, arguments: dict[str, Any] | None = None) -> mcp_tCall a namespaced tool and return its raw MCP result.-#### `call_tool` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L243" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `call_tool` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/group.py#L252" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythoncall_tool(self, name: str, arguments: dict[str, Any] | None = None) -> CallToolResultdiff --git a/docs/python-sdk/fastmcp-client-transports-config.mdx b/docs/python-sdk/fastmcp-client-transports-config.mdxindex fa5e41146..ab6717769 100644--- a/docs/python-sdk/fastmcp-client-transports-config.mdx+++ b/docs/python-sdk/fastmcp-client-transports-config.mdx@@ -80,7 +80,7 @@ legacy backend moves every leg to the handshake era.connect_session(self, **session_kwargs: Unpack[SessionKwargs]) -> AsyncIterator[ClientSession]```-#### `close` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/transports/config.py#L329" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `close` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/transports/config.py#L393" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonclose(self)diff --git a/docs/python-sdk/fastmcp-client-transports-inference.mdx b/docs/python-sdk/fastmcp-client-transports-inference.mdxindex 674904a12..320387b2d 100644--- a/docs/python-sdk/fastmcp-client-transports-inference.mdx+++ b/docs/python-sdk/fastmcp-client-transports-inference.mdx@@ -7,7 +7,7 @@ sidebarTitle: inference## Functions-### `infer_transport` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/transports/inference.py#L65" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `infer_transport` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/client/transports/inference.py#L88" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythoninfer_transport(transport: ClientTransport | FastMCP | SDKServer | AnyUrl | Path | MCPConfig | dict[str, Any] | str) -> ClientTransport@@ -23,8 +23,10 @@ ClientTransport subclass.The function supports these input types:- ClientTransport: Used directly without modification- FastMCP or SDKServer: Creates an in-memory FastMCPTransport-- Path or str (file path): Creates PythonStdioTransport (.py) or NodeStdioTransport (.js)-- AnyUrl or str (URL): Creates StreamableHttpTransport (default) or SSETransport (for /sse endpoints)+- Path: Creates PythonStdioTransport (.py) or NodeStdioTransport (.js)+- AnyUrl or str (URL): Creates StreamableHttpTransport (default) or SSETransport (for /sse endpoints).+ A str naming an existing .py or .js file still infers a stdio transport but+ emits a FastMCPDeprecationWarning; pass a Path instead.- MCPConfig or dict: Creates MCPConfigTransport, potentially connecting to multiple serversFor HTTP URLs, they are assumed to be Streamable HTTP URLs unless they end in `/sse`.@@ -39,7 +41,7 @@ If the MCPConfig contains only one server, a direct connection is established wi```python# Connect to a local Python script-transport = infer_transport("my_script.py")+transport = infer_transport(Path("my_script.py"))# Connect to a remote server via HTTPtransport = infer_transport("http://example.com/mcp")diff --git a/docs/python-sdk/fastmcp-experimental-transforms-code_mode.mdx b/docs/python-sdk/fastmcp-experimental-transforms-code_mode.mdxindex 6d634b6ea..06daff0db 100644--- a/docs/python-sdk/fastmcp-experimental-transforms-code_mode.mdx+++ b/docs/python-sdk/fastmcp-experimental-transforms-code_mode.mdx@@ -7,7 +7,7 @@ sidebarTitle: code_mode## Classes-### `SandboxProvider` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L77" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `SandboxProvider` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L78" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Interface for executing LLM-generated Python code in a sandbox.@@ -20,13 +20,13 @@ sandbox β never with plain ``exec()``. Use ``MontySandboxProvider``**Methods:**-#### `run` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L86" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `run` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L87" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrun(self, code: str) -> Any```-### `MontySandboxProvider` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L114" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `MontySandboxProvider` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L115" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Sandbox provider backed by `pydantic-monty`.@@ -47,13 +47,13 @@ to set your own.**Methods:**-#### `run` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L143" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `run` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L144" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrun(self, code: str) -> Any```-### `Search` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L238" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `Search` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L269" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Discovery tool factory that searches the catalog by query.@@ -70,7 +70,7 @@ Defaults to BM25 ranking.The LLM can override this per call. ``None`` means no limit.-### `GetSchemas` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L320" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GetSchemas` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L351" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Discovery tool factory that returns schemas for tools by name.@@ -84,7 +84,7 @@ types, and required markers.``"full"`` returns the complete JSON schema.-### `GetTags` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L381" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GetTags` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L412" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Discovery tool factory that lists tool tags from the catalog.@@ -99,7 +99,7 @@ without tags appear under ``"untagged"``.``"full"`` lists all tools under each tag.-### `ListTools` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L448" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ListTools` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L479" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Discovery tool factory that lists all tools in the catalog.@@ -112,7 +112,7 @@ Discovery tool factory that lists all tools in the catalog.``"full"`` returns the complete JSON schema.-### `CodeMode` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L497" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `CodeMode` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L528" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Transform that collapses all tools into discovery + execute meta-tools.@@ -129,13 +129,13 @@ environment with ``call_tool(name, params)`` in scope.**Methods:**-#### `transform_tools` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L549" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `transform_tools` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L580" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythontransform_tools(self, tools: Sequence[Tool]) -> Sequence[Tool]```-#### `get_tool` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L552" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_tool` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/experimental/transforms/code_mode.py#L583" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_tool(self, name: str, call_next: GetToolNext) -> Tool | Nonediff --git a/docs/python-sdk/fastmcp-server-auth-providers-descope.mdx b/docs/python-sdk/fastmcp-server-auth-providers-descope.mdxindex 1cfb99266..acaba8c05 100644--- a/docs/python-sdk/fastmcp-server-auth-providers-descope.mdx+++ b/docs/python-sdk/fastmcp-server-auth-providers-descope.mdx@@ -15,7 +15,7 @@ for seamless MCP client authentication.## Classes-### `DescopeProvider` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/descope.py#L79" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `DescopeProvider` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/descope.py#L124" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Descope metadata provider for Dynamic Client Registration (DCR).@@ -23,7 +23,12 @@ Descope metadata provider for Dynamic Client Registration (DCR).The provider accepts either a resource-specific Descope MCP Server URL suchas `/v1/apps/agentic/P.../M.../.well-known/openid-configuration` or aproject-level inbound app URL such as-`/v1/apps/P.../.well-known/openid-configuration`.+`/v1/apps/P.../.well-known/openid-configuration`. The project-level URL is+the recommended configuration.++Tokens are accepted from any issuer the project mints: the project-level+issuer, the resource-scoped issuer of an MCP server, and the tenant-scoped+issuer used by cross-app access (XAA).When neither `scopes_supported` nor `required_scopes` is provided, advertisedscopes are discovered lazily from the OpenID configuration. Use@@ -36,7 +41,7 @@ for DCR setup instructions.**Methods:**-#### `get_routes` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/descope.py#L267" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_routes` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/descope.py#L324" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_routes(self, mcp_path: str | None = None) -> list[Route]diff --git a/docs/python-sdk/fastmcp-server-auth-providers-jwt.mdx b/docs/python-sdk/fastmcp-server-auth-providers-jwt.mdxindex 9e74180a2..794fc23d3 100644--- a/docs/python-sdk/fastmcp-server-auth-providers-jwt.mdx+++ b/docs/python-sdk/fastmcp-server-auth-providers-jwt.mdx@@ -83,7 +83,7 @@ Use this when:**Methods:**-#### `load_access_token` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/jwt.py#L485" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `load_access_token` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/jwt.py#L497" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonload_access_token(self, token: str) -> AccessToken | None@@ -98,7 +98,7 @@ Validate a JWT bearer token and return an AccessToken when the token is valid.- AccessToken | None: An AccessToken populated from token claims if the token is valid; `None` if the token is expired, has an invalid signature or format, fails issuer/audience/scope validation, or any other validation error occurs.-#### `verify_token` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/jwt.py#L628" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `verify_token` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/jwt.py#L631" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonverify_token(self, token: str) -> AccessToken | None@@ -116,7 +116,7 @@ to our existing load_access_token method.- AccessToken object if valid, None if invalid or expired-### `StaticTokenVerifier` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/jwt.py#L644" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `StaticTokenVerifier` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/jwt.py#L647" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Simple static token verifier for testing and development.@@ -137,7 +137,7 @@ WARNING: Never use this in production - tokens are stored in plain text!**Methods:**-#### `verify_token` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/jwt.py#L678" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `verify_token` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/auth/providers/jwt.py#L681" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonverify_token(self, token: str) -> AccessToken | Nonediff --git a/docs/python-sdk/fastmcp-server-middleware-caching.mdx b/docs/python-sdk/fastmcp-server-middleware-caching.mdxindex 62a21253f..9e5073942 100644--- a/docs/python-sdk/fastmcp-server-middleware-caching.mdx+++ b/docs/python-sdk/fastmcp-server-middleware-caching.mdx@@ -10,13 +10,13 @@ A middleware for response caching.## Classes-### `CacheableResourceContent` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L85" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `CacheableResourceContent` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L86" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>A wrapper for ResourceContent that can be cached.-### `CacheableResourceResult` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L93" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `CacheableResourceResult` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L94" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>A wrapper for ResourceResult that can be cached.@@ -24,47 +24,47 @@ A wrapper for ResourceResult that can be cached.**Methods:**-#### `get_size` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L99" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_size` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L100" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_size(self) -> int```-#### `wrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L103" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `wrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L104" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonwrap(cls, value: ResourceResult) -> Self```-#### `unwrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L114" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `unwrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L115" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonunwrap(self) -> ResourceResult```-### `CacheableToolResult` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L126" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `CacheableToolResult` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L127" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>**Methods:**-#### `wrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L133" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `wrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L134" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonwrap(cls, value: ToolResult) -> Self```-#### `unwrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L141" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `unwrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L142" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonunwrap(self) -> ToolResult```-### `CacheableMessage` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L150" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `CacheableMessage` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L151" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>A wrapper for Message that can be cached.-### `CacheablePromptResult` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L162" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `CacheablePromptResult` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L163" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>A wrapper for PromptResult that can be cached.@@ -72,69 +72,69 @@ A wrapper for PromptResult that can be cached.**Methods:**-#### `get_size` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L169" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_size` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L170" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_size(self) -> int```-#### `wrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L173" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `wrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L174" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonwrap(cls, value: PromptResult) -> Self```-#### `unwrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L182" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `unwrap` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L183" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonunwrap(self) -> PromptResult```-### `SharedMethodSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L193" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `SharedMethodSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L194" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Shared config for a cache method.-### `ListToolsSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L200" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ListToolsSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L201" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Configuration options for Tool-related caching.-### `ListResourcesSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L204" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ListResourcesSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L205" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Configuration options for Resource-related caching.-### `ListPromptsSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L208" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ListPromptsSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L209" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Configuration options for Prompt-related caching.-### `CallToolSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L212" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `CallToolSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L213" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Configuration options for Tool-related caching.-### `ReadResourceSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L219" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ReadResourceSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L220" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Configuration options for Resource-related caching.-### `GetPromptSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L223" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GetPromptSettings` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L224" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Configuration options for Prompt-related caching.-### `ResponseCachingStatistics` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L227" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ResponseCachingStatistics` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L228" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>-### `ResponseCachingMiddleware` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L236" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ResponseCachingMiddleware` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L237" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>The response caching middleware offers a simple way to cache responses to mcp methods. The Middleware@@ -146,16 +146,17 @@ this means that response caching may not be compatible with other middleware thaNotes:- Caches `tools/call`, `resources/read`, `prompts/get`, `tools/list`, `resources/list`, and `prompts/list` requests.-- Cache keys are derived from the method name, arguments, and the caller's- access token. Entries are partitioned per-token so that responses filtered- by per-component authorization (e.g. `auth=require_scopes(...)`) cannot- leak across users with different permissions. Unauthenticated callers- (including STDIO) share a single anonymous partition.+- Cache keys are derived from the method name, requested component version,+ arguments, and the caller's access token. Entries are partitioned per-token+ so that responses filtered by per-component authorization (e.g.+ `auth=require_scopes(...)`) cannot leak across users with different+ permissions. Unauthenticated callers (including STDIO) share a single+ anonymous partition.**Methods:**-#### `on_list_tools` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L346" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `on_list_tools` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L348" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonon_list_tools(self, context: MiddlewareContext[mcp_types.ListToolsRequest], call_next: CallNext[mcp_types.ListToolsRequest, Sequence[Tool]]) -> Sequence[Tool]@@ -165,7 +166,7 @@ List tools from the cache, if caching is enabled, and the result is in the cacheotherwise call the next middleware and store the result in the cache if caching is enabled.-#### `on_list_resources` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L379" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `on_list_resources` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L381" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonon_list_resources(self, context: MiddlewareContext[mcp_types.ListResourcesRequest], call_next: CallNext[mcp_types.ListResourcesRequest, Sequence[Resource]]) -> Sequence[Resource]@@ -175,7 +176,7 @@ List resources from the cache, if caching is enabled, and the result is in the cotherwise call the next middleware and store the result in the cache if caching is enabled.-#### `on_list_prompts` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L412" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `on_list_prompts` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L414" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonon_list_prompts(self, context: MiddlewareContext[mcp_types.ListPromptsRequest], call_next: CallNext[mcp_types.ListPromptsRequest, Sequence[Prompt]]) -> Sequence[Prompt]@@ -185,7 +186,7 @@ List prompts from the cache, if caching is enabled, and the result is in the cacotherwise call the next middleware and store the result in the cache if caching is enabled.-#### `on_call_tool` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L443" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `on_call_tool` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L445" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonon_call_tool(self, context: MiddlewareContext[mcp_types.CallToolRequestParams], call_next: CallNext[mcp_types.CallToolRequestParams, ToolResult]) -> ToolResult@@ -195,7 +196,7 @@ Call a tool from the cache, if caching is enabled, and the result is in the cachotherwise call the next middleware and store the result in the cache if caching is enabled.-#### `on_read_resource` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L507" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `on_read_resource` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L509" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonon_read_resource(self, context: MiddlewareContext[mcp_types.ReadResourceRequestParams], call_next: CallNext[mcp_types.ReadResourceRequestParams, ResourceResult]) -> ResourceResult@@ -205,7 +206,7 @@ Read a resource from the cache, if caching is enabled, and the result is in theotherwise call the next middleware and store the result in the cache if caching is enabled.-#### `on_get_prompt` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L548" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `on_get_prompt` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L550" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonon_get_prompt(self, context: MiddlewareContext[mcp_types.GetPromptRequestParams], call_next: CallNext[mcp_types.GetPromptRequestParams, PromptResult]) -> PromptResult@@ -215,7 +216,7 @@ Get a prompt from the cache, if caching is enabled, and the result is in the cacotherwise call the next middleware and store the result in the cache if caching is enabled.-#### `statistics` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L600" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `statistics` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/server/middleware/caching.py#L602" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonstatistics(self) -> ResponseCachingStatisticsdiff --git a/docs/python-sdk/fastmcp-server-providers-proxy.mdx b/docs/python-sdk/fastmcp-server-providers-proxy.mdxindex 2027c7883..8509c3a36 100644--- a/docs/python-sdk/fastmcp-server-providers-proxy.mdx+++ b/docs/python-sdk/fastmcp-server-providers-proxy.mdx@@ -28,7 +28,7 @@ A handshake-era backend can still issue `roots/list`, and the proxy is thatbackend's client, so it relays the request onto its own front session. Thisreaches the wire through the SDK session rather than a `Context` method:`ctx.list_roots()` is not part of FastMCP's server-authoring API, because-SEP-2577 removed server-initiated requests from the modern protocol. The+SEP-2322 removed server-initiated requests from the modern protocol. Therelay exists only for handshake-era interop on both legs.diff --git a/docs/python-sdk/fastmcp-tools-function_parsing.mdx b/docs/python-sdk/fastmcp-tools-function_parsing.mdxindex 24f314591..0e5cb88cb 100644--- a/docs/python-sdk/fastmcp-tools-function_parsing.mdx+++ b/docs/python-sdk/fastmcp-tools-function_parsing.mdx@@ -10,11 +10,11 @@ Function introspection and schema generation for FastMCP tools.## Classes-### `ParsedFunction` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/tools/function_parsing.py#L240" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ParsedFunction` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/tools/function_parsing.py#L268" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>**Methods:**-#### `from_function` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/tools/function_parsing.py#L249" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `from_function` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/tools/function_parsing.py#L277" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonfrom_function(cls, fn: Callable[..., Any], validate: bool = True, wrap_non_object_output_schema: bool = True) -> ParsedFunction