π The fast, Pythonic way to build MCP servers and clients.
refactor: replace auth provider registry with ImportString (#1710)
Jeremiah Lowindeff09fe077c
diff --git a/docs/docs.json b/docs/docs.jsonindex e2bc06e02..88a56866b 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -338,8 +338,7 @@"python-sdk/fastmcp-server-auth-providers-workos"]},- "python-sdk/fastmcp-server-auth-redirect_validation",- "python-sdk/fastmcp-server-auth-registry"+ "python-sdk/fastmcp-server-auth-redirect_validation"]},"python-sdk/fastmcp-server-context",diff --git a/docs/integrations/authkit.mdx b/docs/integrations/authkit.mdxindex c04a414e3..51552781d 100644--- a/docs/integrations/authkit.mdx+++ b/docs/integrations/authkit.mdx@@ -80,24 +80,54 @@ if __name__ == "__main__":## Environment Variables-You can use environment variables to configure an AuthKit provider without instantiating the provider in your code.+<VersionBadge version="2.12.1" />-To do so, set the following environment variables:+For production deployments, use environment variables instead of hardcoding credentials.+### Provider Selection++Setting this environment variable allows the AuthKit provider to be used automatically without explicitly instantiating it in code.++<Card>+<ParamField path="FASTMCP_SERVER_AUTH" default="Not set">+Set to `fastmcp.server.auth.providers.workos.AuthKitProvider` to use AuthKit authentication.+</ParamField>+</Card>++### AuthKit-Specific Configuration++These environment variables provide default values for the AuthKit provider, whether it's instantiated manually or configured via `FASTMCP_SERVER_AUTH`.++<Card>+<ParamField path="FASTMCP_SERVER_AUTH_AUTHKITPROVIDER_AUTHKIT_DOMAIN" required>+Your AuthKit domain (e.g., `https://your-project-12345.authkit.app`)+</ParamField>++<ParamField path="FASTMCP_SERVER_AUTH_AUTHKITPROVIDER_BASE_URL" required>+Public URL of your FastMCP server (e.g., `https://your-server.com` or `http://localhost:8000` for development)+</ParamField>++<ParamField path="FASTMCP_SERVER_AUTH_AUTHKITPROVIDER_REQUIRED_SCOPES" default="[]">+Comma-, space-, or JSON-separated list of required OAuth scopes (e.g., `openid profile email` or `["openid", "profile", "email"]`)+</ParamField>+</Card>++Example `.env` file:```bash-# instruct FastMCP to use the AuthKit provider-FASTMCP_SERVER_AUTH=AUTHKIT+# Use the AuthKit provider+FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.workos.AuthKitProvider-# configure the AuthKit provider-FASTMCP_SERVER_AUTH_AUTHKITPROVIDER_AUTHKIT_DOMAIN="https://your-project-12345.authkit.app"-FASTMCP_SERVER_AUTH_AUTHKITPROVIDER_BASE_URL="http://localhost:8000"+# AuthKit configuration+FASTMCP_SERVER_AUTH_AUTHKITPROVIDER_AUTHKIT_DOMAIN=https://your-project-12345.authkit.app+FASTMCP_SERVER_AUTH_AUTHKITPROVIDER_BASE_URL=https://your-server.com+FASTMCP_SERVER_AUTH_AUTHKITPROVIDER_REQUIRED_SCOPES=openid,profile,email```-For clarity, you do **not** need to instantiate an auth provider when using environment variables:+With environment variables set, your server code simplifies to:```python server.pyfrom fastmcp import FastMCP-# FastMCP automatically creates the AuthKitProvider from environment variables-mcp = FastMCP(name="WorkOS Secured App")+# Authentication is automatically configured from environment+mcp = FastMCP(name="AuthKit Secured App")```\ No newline at end of filediff --git a/docs/integrations/azure.mdx b/docs/integrations/azure.mdxindex 890e648e3..2ceefe482 100644--- a/docs/integrations/azure.mdx+++ b/docs/integrations/azure.mdx@@ -172,20 +172,24 @@ The client caches tokens locally, so you won't need to re-authenticate for subse## Environment Variables-For production deployments, use environment variables instead of hardcoding credentials.+<VersionBadge version="2.12.1" />-<Info>-To use the registered Azure provider, you must set `FASTMCP_SERVER_AUTH=AZURE`. Learn more about [registered providers](/servers/auth/authentication#registered-providers).-</Info>+For production deployments, use environment variables instead of hardcoding credentials.### Provider Selection-<ParamField path="FASTMCP_SERVER_AUTH" default="Not set" required>-Set to `AZURE` to use the registered AzureProvider with default configuration.+Setting this environment variable allows the Azure provider to be used automatically without explicitly instantiating it in code.++<Card>+<ParamField path="FASTMCP_SERVER_AUTH" default="Not set">+Set to `fastmcp.server.auth.providers.azure.AzureProvider` to use Azure authentication.</ParamField>+</Card>### Azure-Specific Configuration+These environment variables provide default values for the Azure provider, whether it's instantiated manually or configured via `FASTMCP_SERVER_AUTH`.+<Card><ParamField path="FASTMCP_SERVER_AUTH_AZURE_CLIENT_ID" required>Your Azure App registration Client ID (e.g., `835f09b6-0f0f-40cc-85cb-f32c5829a149`)@@ -222,8 +226,8 @@ HTTP request timeout for Microsoft Graph API callsExample `.env` file:```bash-# Use the registered Azure provider-FASTMCP_SERVER_AUTH=AZURE+# Use the Azure provider+FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.azure.AzureProvider# Azure OAuth credentialsFASTMCP_SERVER_AUTH_AZURE_CLIENT_ID=835f09b6-0f0f-40cc-85cb-f32c5829a149diff --git a/docs/integrations/github.mdx b/docs/integrations/github.mdxindex 0d05126f7..2414dd253 100644--- a/docs/integrations/github.mdx+++ b/docs/integrations/github.mdx@@ -137,20 +137,24 @@ The client caches tokens locally, so you won't need to re-authenticate for subse## Environment Variables-For production deployments, use environment variables instead of hardcoding credentials.+<VersionBadge version="2.12.1" />-<Info>-To use the registered GitHub provider, you must set `FASTMCP_SERVER_AUTH=GITHUB`. Learn more about [registered providers](/servers/auth/authentication#registered-providers).-</Info>+For production deployments, use environment variables instead of hardcoding credentials.### Provider Selection-<ParamField path="FASTMCP_SERVER_AUTH" default="Not set" required>-Set to `GITHUB` to use the registered GitHubProvider with default configuration.+Setting this environment variable allows the GitHub provider to be used automatically without explicitly instantiating it in code.++<Card>+<ParamField path="FASTMCP_SERVER_AUTH" default="Not set">+Set to `fastmcp.server.auth.providers.github.GitHubProvider` to use GitHub authentication.</ParamField>+</Card>### GitHub-Specific Configuration+These environment variables provide default values for the GitHub provider, whether it's instantiated manually or configured via `FASTMCP_SERVER_AUTH`.+<Card><ParamField path="FASTMCP_SERVER_AUTH_GITHUB_CLIENT_ID" required>Your GitHub OAuth App Client ID (e.g., `Ov23liAbcDefGhiJkLmN`)@@ -179,8 +183,8 @@ HTTP request timeout for GitHub API callsExample `.env` file:```bash-# Use the registered GitHub provider-FASTMCP_SERVER_AUTH=GITHUB+# Use the GitHub provider+FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.github.GitHubProvider# GitHub OAuth credentialsFASTMCP_SERVER_AUTH_GITHUB_CLIENT_ID=Ov23liAbcDefGhiJkLmNdiff --git a/docs/integrations/google.mdx b/docs/integrations/google.mdxindex ba65406e0..9e3cf8bab 100644--- a/docs/integrations/google.mdx+++ b/docs/integrations/google.mdx@@ -150,20 +150,24 @@ The client caches tokens locally, so you won't need to re-authenticate for subse## Environment Variables-For production deployments, use environment variables instead of hardcoding credentials.+<VersionBadge version="2.12.1" />-<Info>-To use the registered Google provider, you must set `FASTMCP_SERVER_AUTH=GOOGLE`. Learn more about [registered providers](/servers/auth/authentication#registered-providers).-</Info>+For production deployments, use environment variables instead of hardcoding credentials.### Provider Selection-<ParamField path="FASTMCP_SERVER_AUTH" default="Not set" required>-Set to `GOOGLE` to use the registered GoogleProvider with default configuration.+Setting this environment variable allows the Google provider to be used automatically without explicitly instantiating it in code.++<Card>+<ParamField path="FASTMCP_SERVER_AUTH" default="Not set">+Set to `fastmcp.server.auth.providers.google.GoogleProvider` to use Google authentication.</ParamField>+</Card>### Google-Specific Configuration+These environment variables provide default values for the Google provider, whether it's instantiated manually or configured via `FASTMCP_SERVER_AUTH`.+<Card><ParamField path="FASTMCP_SERVER_AUTH_GOOGLE_CLIENT_ID" required>Your Google OAuth 2.0 Client ID (e.g., `123456789.apps.googleusercontent.com`)@@ -192,8 +196,8 @@ HTTP request timeout for Google API callsExample `.env` file:```bash-# Use the registered Google provider-FASTMCP_SERVER_AUTH=GOOGLE+# Use the Google provider+FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.google.GoogleProvider# Google OAuth credentialsFASTMCP_SERVER_AUTH_GOOGLE_CLIENT_ID=123456789.apps.googleusercontent.comdiff --git a/docs/integrations/workos-oauth.mdx b/docs/integrations/workos-oauth.mdxindex fee2b1c46..98aa6999e 100644--- a/docs/integrations/workos-oauth.mdx+++ b/docs/integrations/workos-oauth.mdx@@ -128,22 +128,24 @@ The client caches tokens locally, so you won't need to re-authenticate for subse## Environment Variables-For production deployments, use environment variables instead of hardcoding credentials. These variables provide default values when instantiating `WorkOSProvider()`.+<VersionBadge version="2.12.1" />-<Info>-Setting `FASTMCP_SERVER_AUTH=WORKOS` automatically provisions WorkOS as the default auth provider for all FastMCP servers. This is optional - you can still manually instantiate `WorkOSProvider()` without it. Learn more about [registered providers](/servers/auth/authentication#registered-providers).-</Info>+For production deployments, use environment variables instead of hardcoding credentials.-### Automatic Provider Selection (Optional)+### Provider Selection++Setting this environment variable allows the WorkOS provider to be used automatically without explicitly instantiating it in code.<Card><ParamField path="FASTMCP_SERVER_AUTH" default="Not set">-Set to `WORKOS` to automatically provision WorkOS authentication for FastMCP servers without explicitly passing an auth parameter.+Set to `fastmcp.server.auth.providers.workos.WorkOSProvider` to use WorkOS authentication.</ParamField></Card>### WorkOS-Specific Configuration+These environment variables provide default values for the WorkOS provider, whether it's instantiated manually or configured via `FASTMCP_SERVER_AUTH`.+<Card><ParamField path="FASTMCP_SERVER_AUTH_WORKOS_CLIENT_ID" required>Your WorkOS OAuth App Client ID (e.g., `client_01K33Y6GGS7T3AWMPJWKW42Y3Q`)@@ -184,7 +186,7 @@ FASTMCP_SERVER_AUTH_WORKOS_BASE_URL=https://your-server.comFASTMCP_SERVER_AUTH_WORKOS_REQUIRED_SCOPES=["openid","profile","email"]# Optional: Automatically provision WorkOS auth for all servers-FASTMCP_SERVER_AUTH=WORKOS+FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.workos.WorkOSProvider```With environment variables set, you can either:@@ -199,7 +201,7 @@ auth = WorkOSProvider() # Uses env var defaultsmcp = FastMCP(name="WorkOS Protected Server", auth=auth)```-**Option 2: Automatic provisioning (requires FASTMCP_SERVER_AUTH=WORKOS)**+**Option 2: Automatic provisioning (requires FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.workos.WorkOSProvider)**```python server.pyfrom fastmcp import FastMCPdiff --git a/docs/python-sdk/fastmcp-client-elicitation.mdx b/docs/python-sdk/fastmcp-client-elicitation.mdxindex 5e8957f32..838f6314d 100644--- a/docs/python-sdk/fastmcp-client-elicitation.mdx+++ b/docs/python-sdk/fastmcp-client-elicitation.mdx@@ -7,7 +7,7 @@ sidebarTitle: elicitation## Functions-### `create_elicitation_callback` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/elicitation.py#L36" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `create_elicitation_callback` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/elicitation.py#L37" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythoncreate_elicitation_callback(elicitation_handler: ElicitationHandler) -> ElicitationFnT@@ -15,4 +15,4 @@ create_elicitation_callback(elicitation_handler: ElicitationHandler) -> Elicitat## Classes-### `ElicitResult` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/elicitation.py#L21" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ElicitResult` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/client/elicitation.py#L22" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>diff --git a/docs/python-sdk/fastmcp-server-auth-oauth_proxy.mdx b/docs/python-sdk/fastmcp-server-auth-oauth_proxy.mdxindex 6d261e0a4..0d61f5e25 100644--- a/docs/python-sdk/fastmcp-server-auth-oauth_proxy.mdx+++ b/docs/python-sdk/fastmcp-server-auth-oauth_proxy.mdx@@ -182,7 +182,7 @@ Handles provider-specific requirements:**Methods:**-#### `get_client` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L330" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_client` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L328" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_client(self, client_id: str) -> OAuthClientInformationFull | None@@ -199,7 +199,7 @@ handles the case where a client with cached tokens reconnectson a different port.-#### `register_client` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L363" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `register_client` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L361" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonregister_client(self, client_info: OAuthClientInformationFull) -> None@@ -226,7 +226,7 @@ The flow:4. When client reconnects with a different port, ProxyDCRClient accepts it-#### `authorize` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L422" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `authorize` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L420" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonauthorize(self, client: OAuthClientInformationFull, params: AuthorizationParams) -> str@@ -240,7 +240,7 @@ This implements the DCR-compliant proxy pattern:3. Redirect to IdP with our fixed callback URL-#### `load_authorization_code` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L478" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `load_authorization_code` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L476" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonload_authorization_code(self, client: OAuthClientInformationFull, authorization_code: str) -> AuthorizationCode | None@@ -252,7 +252,7 @@ Look up our client code and return authorization code objectwith PKCE challenge for validation.-#### `exchange_authorization_code` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L520" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `exchange_authorization_code` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L518" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonexchange_authorization_code(self, client: OAuthClientInformationFull, authorization_code: AuthorizationCode) -> OAuthToken@@ -264,7 +264,7 @@ For the DCR-compliant proxy flow, we return the IdP tokens that were obtainedduring the IdP callback exchange. PKCE validation is handled by the MCP framework.-#### `load_refresh_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L587" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `load_refresh_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L585" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonload_refresh_token(self, client: OAuthClientInformationFull, refresh_token: str) -> RefreshToken | None@@ -273,7 +273,7 @@ load_refresh_token(self, client: OAuthClientInformationFull, refresh_token: str)Load refresh token from local storage.-#### `exchange_refresh_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L595" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `exchange_refresh_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L593" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonexchange_refresh_token(self, client: OAuthClientInformationFull, refresh_token: RefreshToken, scopes: list[str]) -> OAuthToken@@ -282,7 +282,7 @@ exchange_refresh_token(self, client: OAuthClientInformationFull, refresh_token:Exchange refresh token for new access token using authlib.-#### `load_access_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L670" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `load_access_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L668" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonload_access_token(self, token: str) -> AccessToken | None@@ -294,7 +294,7 @@ Delegates to the JWT verifier which handles signature validation,expiration checking, and claims validation using the upstream JWKS.-#### `revoke_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L687" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `revoke_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L685" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrevoke_token(self, token: AccessToken | RefreshToken) -> None@@ -306,7 +306,7 @@ Removes tokens from local storage and attempts to revoke them withthe upstream server if a revocation endpoint is configured.-#### `get_routes` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L880" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_routes` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/oauth_proxy.py#L878" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_routes(self) -> list[Route]diff --git a/docs/python-sdk/fastmcp-server-auth-providers-azure.mdx b/docs/python-sdk/fastmcp-server-auth-providers-azure.mdxindex 343128eba..5072d6189 100644--- a/docs/python-sdk/fastmcp-server-auth-providers-azure.mdx+++ b/docs/python-sdk/fastmcp-server-auth-providers-azure.mdx@@ -14,13 +14,13 @@ using the OAuth Proxy pattern for non-DCR OAuth flows.## Classes-### `AzureProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/azure.py#L23" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `AzureProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/azure.py#L22" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Settings for Azure OAuth provider.-### `AzureTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/azure.py#L48" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `AzureTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/azure.py#L47" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Token verifier for Azure OAuth tokens.@@ -31,7 +31,7 @@ to get user information and validate the token.**Methods:**-#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/azure.py#L70" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/azure.py#L69" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonverify_token(self, token: str) -> AccessToken | None@@ -40,7 +40,7 @@ verify_token(self, token: str) -> AccessToken | NoneVerify Azure OAuth token by calling Microsoft Graph API.-### `AzureProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/azure.py#L120" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `AzureProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/azure.py#L118" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Azure (Microsoft Entra) OAuth provider for FastMCP.diff --git a/docs/python-sdk/fastmcp-server-auth-providers-github.mdx b/docs/python-sdk/fastmcp-server-auth-providers-github.mdxindex 91d86fa87..2243d19a4 100644--- a/docs/python-sdk/fastmcp-server-auth-providers-github.mdx+++ b/docs/python-sdk/fastmcp-server-auth-providers-github.mdx@@ -29,13 +29,13 @@ Example:## Classes-### `GitHubProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/github.py#L39" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GitHubProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/github.py#L38" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Settings for GitHub OAuth provider.-### `GitHubTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/github.py#L63" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GitHubTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/github.py#L62" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Token verifier for GitHub OAuth tokens.@@ -46,7 +46,7 @@ by calling GitHub's API to check if they're valid and get user info.**Methods:**-#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/github.py#L85" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/github.py#L84" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonverify_token(self, token: str) -> AccessToken | None@@ -55,7 +55,7 @@ verify_token(self, token: str) -> AccessToken | NoneVerify GitHub OAuth token by calling GitHub API.-### `GitHubProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/github.py#L169" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GitHubProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/github.py#L167" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Complete GitHub OAuth provider for FastMCP.diff --git a/docs/python-sdk/fastmcp-server-auth-providers-google.mdx b/docs/python-sdk/fastmcp-server-auth-providers-google.mdxindex 2eaf874cc..01f9a94d2 100644--- a/docs/python-sdk/fastmcp-server-auth-providers-google.mdx+++ b/docs/python-sdk/fastmcp-server-auth-providers-google.mdx@@ -29,13 +29,13 @@ Example:## Classes-### `GoogleProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/google.py#L41" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GoogleProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/google.py#L40" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Settings for Google OAuth provider.-### `GoogleTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/google.py#L65" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GoogleTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/google.py#L64" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Token verifier for Google OAuth tokens.@@ -46,7 +46,7 @@ by calling Google's tokeninfo API to check if they're valid and get user info.**Methods:**-#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/google.py#L87" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/google.py#L86" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonverify_token(self, token: str) -> AccessToken | None@@ -55,7 +55,7 @@ verify_token(self, token: str) -> AccessToken | NoneVerify Google OAuth token by calling Google's tokeninfo API.-### `GoogleProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/google.py#L185" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `GoogleProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/google.py#L183" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Complete Google OAuth provider for FastMCP.diff --git a/docs/python-sdk/fastmcp-server-auth-providers-jwt.mdx b/docs/python-sdk/fastmcp-server-auth-providers-jwt.mdxindex 1c7224bd0..e46059402 100644--- a/docs/python-sdk/fastmcp-server-auth-providers-jwt.mdx+++ b/docs/python-sdk/fastmcp-server-auth-providers-jwt.mdx@@ -10,19 +10,19 @@ TokenVerifier implementations for FastMCP.## Classes-### `JWKData` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L27" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `JWKData` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L26" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>JSON Web Key data structure.-### `JWKSData` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L40" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `JWKSData` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L39" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>JSON Web Key Set data structure.-### `RSAKeyPair` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L47" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `RSAKeyPair` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L46" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>RSA key pair for JWT testing.@@ -30,7 +30,7 @@ RSA key pair for JWT testing.**Methods:**-#### `generate` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L54" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `generate` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L53" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythongenerate(cls) -> RSAKeyPair@@ -42,7 +42,7 @@ Generate an RSA key pair for testing.- Generated key pair-#### `create_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L89" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `create_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L88" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythoncreate_token(self, subject: str = 'fastmcp-user', issuer: str = 'https://fastmcp.example.com', audience: str | list[str] | None = None, scopes: list[str] | None = None, expires_in_seconds: int = 3600, additional_claims: dict[str, Any] | None = None, kid: str | None = None) -> str@@ -60,13 +60,13 @@ Generate a test JWT token for testing purposes.- `kid`: Key ID to include in header-### `JWTVerifierSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L142" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `JWTVerifierSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L141" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Settings for JWT token verification.-### `JWTVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L166" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `JWTVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L164" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>JWT token verifier supporting both asymmetric (RSA/ECDSA) and symmetric (HMAC) algorithms.@@ -88,7 +88,7 @@ Use this when:**Methods:**-#### `load_access_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L368" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `load_access_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L366" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonload_access_token(self, token: str) -> AccessToken | None@@ -103,7 +103,7 @@ Validates the provided JWT bearer token.- AccessToken object if valid, None if invalid or expired-#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L470" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L468" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonverify_token(self, token: str) -> AccessToken | None@@ -121,7 +121,7 @@ to our existing load_access_token method.- AccessToken object if valid, None if invalid or expired-### `StaticTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L486" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `StaticTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L484" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Simple static token verifier for testing and development.@@ -142,7 +142,7 @@ WARNING: Never use this in production - tokens are stored in plain text!**Methods:**-#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L520" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/jwt.py#L518" 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-auth-providers-workos.mdx b/docs/python-sdk/fastmcp-server-auth-providers-workos.mdxindex fdacdf859..fa3840599 100644--- a/docs/python-sdk/fastmcp-server-auth-providers-workos.mdx+++ b/docs/python-sdk/fastmcp-server-auth-providers-workos.mdx@@ -18,13 +18,13 @@ Choose based on your WorkOS setup and authentication requirements.## Classes-### `WorkOSProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L30" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `WorkOSProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L29" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Settings for WorkOS OAuth provider.-### `WorkOSTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L55" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `WorkOSTokenVerifier` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L54" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Token verifier for WorkOS OAuth tokens.@@ -35,7 +35,7 @@ the /oauth2/userinfo endpoint to check validity and get user info.**Methods:**-#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L80" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `verify_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L79" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonverify_token(self, token: str) -> AccessToken | None@@ -44,7 +44,7 @@ verify_token(self, token: str) -> AccessToken | NoneVerify WorkOS OAuth token by calling userinfo endpoint.-### `WorkOSProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L128" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `WorkOSProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L126" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Complete WorkOS OAuth provider for FastMCP.@@ -65,9 +65,9 @@ Setup Requirements:4. Note your Client ID and Client Secret-### `AuthKitProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L267" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `AuthKitProviderSettings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L265" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>-### `AuthKitProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L285" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `AuthKitProvider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L282" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>AuthKit metadata provider for DCR (Dynamic Client Registration).@@ -93,7 +93,7 @@ https://workos.com/docs/authkit/mcp/integrating/token-verification**Methods:**-#### `get_routes` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L368" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_routes` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/providers/workos.py#L365" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_routes(self) -> list[Route]diff --git a/docs/python-sdk/fastmcp-server-auth-registry.mdx b/docs/python-sdk/fastmcp-server-auth-registry.mdxdeleted file mode 100644index 8815d4b55..000000000--- a/docs/python-sdk/fastmcp-server-auth-registry.mdx+++ /dev/null@@ -1,43 +0,0 @@-----title: registry-sidebarTitle: registry------# `fastmcp.server.auth.registry`---Provider registry for FastMCP auth providers.--## Functions--### `register_provider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/registry.py#L19" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>--```python-register_provider(name: str) -> Callable[[type[T]], type[T]]-```---Decorator to register an auth provider with a given name.--**Args:**-- `name`: The name to register the provider under (e.g., 'AUTHKIT')--**Returns:**-- The decorated class---### `get_registered_provider` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/auth/registry.py#L41" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>--```python-get_registered_provider(name: str) -> type[AuthProvider]-```---Get a registered provider by name.--**Args:**-- `name`: The provider name (case-insensitive)--**Returns:**-- The provider class if found, None otherwise-diff --git a/docs/python-sdk/fastmcp-server-context.mdx b/docs/python-sdk/fastmcp-server-context.mdxindex 8dbe81a99..bbc14d0ee 100644--- a/docs/python-sdk/fastmcp-server-context.mdx+++ b/docs/python-sdk/fastmcp-server-context.mdx@@ -7,7 +7,7 @@ sidebarTitle: context## Functions-### `set_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L68" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `set_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L69" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonset_context(context: Context) -> Generator[Context, None, None]@@ -15,7 +15,7 @@ set_context(context: Context) -> Generator[Context, None, None]## Classes-### `LogData` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L56" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `LogData` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L57" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Data object for passing log arguments to client-side handlers.@@ -24,7 +24,7 @@ This provides an interface to match the Python standard library logging,for compatibility with structured logging.-### `Context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L77" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `Context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L78" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Context object providing access to MCP capabilities.@@ -72,7 +72,7 @@ The context is optional - tools that don't need it can omit the parameter.**Methods:**-#### `fastmcp` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L129" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `fastmcp` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L130" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonfastmcp(self) -> FastMCP@@ -81,7 +81,7 @@ fastmcp(self) -> FastMCPGet the FastMCP instance.-#### `request_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L158" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `request_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L159" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrequest_context(self) -> RequestContext[ServerSession, Any, Request]@@ -92,7 +92,7 @@ Access to the underlying request context.If called outside of a request context, this will raise a ValueError.-#### `report_progress` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L168" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `report_progress` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L169" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonreport_progress(self, progress: float, total: float | None = None, message: str | None = None) -> None@@ -105,7 +105,7 @@ Report progress for the current operation.- `total`: Optional total value e.g. 100-#### `read_resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L195" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `read_resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L196" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonread_resource(self, uri: str | AnyUrl) -> list[ReadResourceContents]@@ -120,7 +120,7 @@ Read a resource by URI.- The resource content as either text or bytes-#### `log` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L208" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `log` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L209" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonlog(self, message: str, level: LoggingLevel | None = None, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None@@ -136,7 +136,7 @@ Send a log message to the client.- `extra`: Optional mapping for additional arguments-#### `client_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L235" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `client_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L236" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonclient_id(self) -> str | None@@ -145,7 +145,7 @@ client_id(self) -> str | NoneGet the client ID if available.-#### `request_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L244" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `request_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L245" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrequest_id(self) -> str@@ -154,7 +154,7 @@ request_id(self) -> strGet the unique ID for this request.-#### `session_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L249" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `session_id` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L250" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonsession_id(self) -> str@@ -171,7 +171,7 @@ the same client session.- for other transports.-#### `session` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L293" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `session` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L294" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonsession(self) -> ServerSession@@ -180,7 +180,7 @@ session(self) -> ServerSessionAccess to the underlying session for advanced usage.-#### `debug` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L298" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `debug` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L299" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythondebug(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None@@ -189,7 +189,7 @@ debug(self, message: str, logger_name: str | None = None, extra: Mapping[str, AnSend a debug log message.-#### `info` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L309" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `info` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L310" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythoninfo(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None@@ -198,7 +198,7 @@ info(self, message: str, logger_name: str | None = None, extra: Mapping[str, AnySend an info log message.-#### `warning` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L320" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `warning` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L321" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonwarning(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None@@ -207,7 +207,7 @@ warning(self, message: str, logger_name: str | None = None, extra: Mapping[str,Send a warning log message.-#### `error` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L331" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `error` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L332" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonerror(self, message: str, logger_name: str | None = None, extra: Mapping[str, Any] | None = None) -> None@@ -216,7 +216,7 @@ error(self, message: str, logger_name: str | None = None, extra: Mapping[str, AnSend an error log message.-#### `list_roots` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L342" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `list_roots` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L343" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonlist_roots(self) -> list[Root]@@ -225,7 +225,7 @@ list_roots(self) -> list[Root]List the roots available to the server, as indicated by the client.-#### `send_tool_list_changed` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L347" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `send_tool_list_changed` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L348" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonsend_tool_list_changed(self) -> None@@ -234,7 +234,7 @@ send_tool_list_changed(self) -> NoneSend a tool list changed notification to the client.-#### `send_resource_list_changed` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L351" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `send_resource_list_changed` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L352" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonsend_resource_list_changed(self) -> None@@ -243,7 +243,7 @@ send_resource_list_changed(self) -> NoneSend a resource list changed notification to the client.-#### `send_prompt_list_changed` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L355" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `send_prompt_list_changed` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L356" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonsend_prompt_list_changed(self) -> None@@ -252,7 +252,7 @@ send_prompt_list_changed(self) -> NoneSend a prompt list changed notification to the client.-#### `sample` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L359" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `sample` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L360" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonsample(self, messages: str | list[str | SamplingMessage], system_prompt: str | None = None, include_context: IncludeContext | None = None, temperature: float | None = None, max_tokens: int | None = None, model_preferences: ModelPreferences | str | list[str] | None = None) -> ContentBlock@@ -265,25 +265,25 @@ completion from the client. The client must be appropriately configured,or the request will error.-#### `elicit` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L443" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `elicit` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L444" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonelicit(self, message: str, response_type: None) -> AcceptedElicitation[dict[str, Any]] | DeclinedElicitation | CancelledElicitation```-#### `elicit` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L455" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `elicit` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L456" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonelicit(self, message: str, response_type: type[T]) -> AcceptedElicitation[T] | DeclinedElicitation | CancelledElicitation```-#### `elicit` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L465" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `elicit` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L466" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonelicit(self, message: str, response_type: list[str]) -> AcceptedElicitation[str] | DeclinedElicitation | CancelledElicitation```-#### `elicit` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L474" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `elicit` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L475" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonelicit(self, message: str, response_type: type[T] | list[str] | None = None) -> AcceptedElicitation[T] | AcceptedElicitation[dict[str, Any]] | AcceptedElicitation[str] | DeclinedElicitation | CancelledElicitation@@ -312,7 +312,7 @@ type or dataclass or BaseModel. If it is a primitive type, anobject schema with a single "value" field will be generated.-#### `get_http_request` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L567" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_http_request` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L568" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_http_request(self) -> Request@@ -321,7 +321,7 @@ get_http_request(self) -> RequestGet the active starlette request.-#### `set_state` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L582" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `set_state` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L583" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonset_state(self, key: str, value: Any) -> None@@ -330,7 +330,7 @@ set_state(self, key: str, value: Any) -> NoneSet a value in the context state.-#### `get_state` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L586" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_state` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/context.py#L587" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_state(self, key: str) -> Anydiff --git a/docs/python-sdk/fastmcp-server-dependencies.mdx b/docs/python-sdk/fastmcp-server-dependencies.mdxindex d9a6d6bed..44af946f1 100644--- a/docs/python-sdk/fastmcp-server-dependencies.mdx+++ b/docs/python-sdk/fastmcp-server-dependencies.mdx@@ -7,19 +7,19 @@ sidebarTitle: dependencies## Functions-### `get_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L30" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `get_context` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L27" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_context() -> Context```-### `get_http_request` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L42" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `get_http_request` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L39" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_http_request() -> Request```-### `get_http_headers` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L56" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `get_http_headers` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L53" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_http_headers(include_all: bool = False) -> dict[str, str]@@ -35,7 +35,7 @@ By default, strips problematic headers like `content-length` that cause issues iIf `include_all` is True, all headers are returned.-### `get_access_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L105" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `get_access_token` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/dependencies.py#L102" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_access_token() -> AccessToken | Nonediff --git a/docs/python-sdk/fastmcp-server-elicitation.mdx b/docs/python-sdk/fastmcp-server-elicitation.mdxindex b836cf49a..c21fc533d 100644--- a/docs/python-sdk/fastmcp-server-elicitation.mdx+++ b/docs/python-sdk/fastmcp-server-elicitation.mdx@@ -7,7 +7,7 @@ sidebarTitle: elicitation## Functions-### `get_elicitation_schema` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L98" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `get_elicitation_schema` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L99" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_elicitation_schema(response_type: type[T]) -> dict[str, Any]@@ -20,7 +20,7 @@ Get the schema for an elicitation response.- `response_type`: The type of the response-### `validate_elicitation_json_schema` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L117" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `validate_elicitation_json_schema` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L118" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonvalidate_elicitation_json_schema(schema: dict[str, Any]) -> None@@ -45,7 +45,7 @@ This ensures the schema is compatible with MCP elicitation requirements:## Classes-### `ElicitationJsonSchema` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L31" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ElicitationJsonSchema` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L32" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Custom JSON schema generator for MCP elicitation that always inlines enums.@@ -57,7 +57,7 @@ Optionally adds enumNames for better UI display when available.**Methods:**-#### `generate_inner` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L39" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `generate_inner` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L40" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythongenerate_inner(self, schema: core_schema.CoreSchema) -> JsonSchemaValue@@ -66,7 +66,7 @@ generate_inner(self, schema: core_schema.CoreSchema) -> JsonSchemaValueOverride to prevent ref generation for enums.-#### `enum_schema` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L49" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `enum_schema` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L50" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonenum_schema(self, schema: core_schema.EnumSchema) -> JsonSchemaValue@@ -78,10 +78,10 @@ If enum members have a _display_name_ attribute or custom __str__,we'll include enumNames for better UI representation.-### `AcceptedElicitation` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L86" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `AcceptedElicitation` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L87" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>Result when user accepts the elicitation.-### `ScalarElicitationType` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L94" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `ScalarElicitationType` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/elicitation.py#L95" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>diff --git a/docs/python-sdk/fastmcp-server-server.mdx b/docs/python-sdk/fastmcp-server-server.mdxindex 372661303..f2ff07a8e 100644--- a/docs/python-sdk/fastmcp-server-server.mdx+++ b/docs/python-sdk/fastmcp-server-server.mdx@@ -10,7 +10,7 @@ FastMCP - A more ergonomic interface for MCP servers.## Functions-### `default_lifespan` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L99" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `default_lifespan` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L98" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythondefault_lifespan(server: FastMCP[LifespanResultT]) -> AsyncIterator[Any]@@ -26,7 +26,7 @@ Default lifespan context manager that does nothing.- An empty context object-### `add_resource_prefix` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2223" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `add_resource_prefix` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2222" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonadd_resource_prefix(uri: str, prefix: str, prefix_format: Literal['protocol', 'path'] | None = None) -> str@@ -64,7 +64,7 @@ add_resource_prefix("resource:///absolute/path", "prefix")- `ValueError`: If the URI doesn't match the expected protocol\://path format-### `remove_resource_prefix` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2283" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `remove_resource_prefix` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2282" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonremove_resource_prefix(uri: str, prefix: str, prefix_format: Literal['protocol', 'path'] | None = None) -> str@@ -103,7 +103,7 @@ remove_resource_prefix("resource://prefix//absolute/path", "prefix")- `ValueError`: If the URI doesn't match the expected protocol\://path format-### `has_resource_prefix` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2350" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `has_resource_prefix` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2349" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonhas_resource_prefix(uri: str, prefix: str, prefix_format: Literal['protocol', 'path'] | None = None) -> bool@@ -143,35 +143,35 @@ False## Classes-### `FastMCP` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L130" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `FastMCP` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L129" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>**Methods:**-#### `settings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L315" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `settings` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L314" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonsettings(self) -> Settings```-#### `name` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L326" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `name` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L325" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonname(self) -> str```-#### `instructions` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L330" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `instructions` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L329" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythoninstructions(self) -> str | None```-#### `version` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L334" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `version` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L333" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonversion(self) -> str | None```-#### `run_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L337" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `run_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L336" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrun_async(self, transport: Transport | None = None, show_banner: bool = True, **transport_kwargs: Any) -> None@@ -183,7 +183,7 @@ Run the FastMCP server asynchronously.- `transport`: Transport protocol to use ("stdio", "sse", or "streamable-http")-#### `run` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L367" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `run` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L366" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrun(self, transport: Transport | None = None, show_banner: bool = True, **transport_kwargs: Any) -> None@@ -195,13 +195,13 @@ Run the FastMCP server. Note this is a synchronous function.- `transport`: Transport protocol to use ("stdio", "sse", or "streamable-http")-#### `add_middleware` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L409" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `add_middleware` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L408" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonadd_middleware(self, middleware: Middleware) -> None```-#### `get_tools` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L412" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_tools` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L411" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_tools(self) -> dict[str, Tool]@@ -210,13 +210,13 @@ get_tools(self) -> dict[str, Tool]Get all registered tools, indexed by registered key.-#### `get_tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L416" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L415" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_tool(self, key: str) -> Tool```-#### `get_resources` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L422" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_resources` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L421" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_resources(self) -> dict[str, Resource]@@ -225,13 +225,13 @@ get_resources(self) -> dict[str, Resource]Get all registered resources, indexed by registered key.-#### `get_resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L426" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L425" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_resource(self, key: str) -> Resource```-#### `get_resource_templates` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L432" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_resource_templates` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L431" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_resource_templates(self) -> dict[str, ResourceTemplate]@@ -240,7 +240,7 @@ get_resource_templates(self) -> dict[str, ResourceTemplate]Get all registered resource templates, indexed by registered key.-#### `get_resource_template` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L436" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_resource_template` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L435" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_resource_template(self, key: str) -> ResourceTemplate@@ -249,7 +249,7 @@ get_resource_template(self, key: str) -> ResourceTemplateGet a registered resource template by key.-#### `get_prompts` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L443" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_prompts` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L442" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_prompts(self) -> dict[str, Prompt]@@ -258,13 +258,13 @@ get_prompts(self) -> dict[str, Prompt]List all available prompts.-#### `get_prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L449" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `get_prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L448" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonget_prompt(self, key: str) -> Prompt```-#### `custom_route` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L455" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `custom_route` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L454" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythoncustom_route(self, path: str, methods: list[str], name: str | None = None, include_in_schema: bool = True) -> Callable[[Callable[[Request], Awaitable[Response]]], Callable[[Request], Awaitable[Response]]]@@ -285,7 +285,7 @@ Starlette's reverse URL lookup feature)- `include_in_schema`: Whether to include in OpenAPI schema, defaults to True-#### `add_tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L857" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `add_tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L856" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonadd_tool(self, tool: Tool) -> Tool@@ -303,7 +303,7 @@ with the Context type annotation. See the @tool decorator for examples.- The tool instance that was added to the server.-#### `remove_tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L882" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `remove_tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L881" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonremove_tool(self, name: str) -> None@@ -318,7 +318,7 @@ Remove a tool from the server.- `NotFoundError`: If the tool is not found-#### `add_tool_transformation` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L902" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `add_tool_transformation` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L901" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonadd_tool_transformation(self, tool_name: str, transformation: ToolTransformConfig) -> None@@ -327,7 +327,7 @@ add_tool_transformation(self, tool_name: str, transformation: ToolTransformConfiAdd a tool transformation.-#### `remove_tool_transformation` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L908" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `remove_tool_transformation` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L907" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonremove_tool_transformation(self, tool_name: str) -> None@@ -336,19 +336,19 @@ remove_tool_transformation(self, tool_name: str) -> NoneRemove a tool transformation.-#### `tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L913" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L912" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythontool(self, name_or_fn: AnyFunction) -> FunctionTool```-#### `tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L929" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L928" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythontool(self, name_or_fn: str | None = None) -> Callable[[AnyFunction], FunctionTool]```-#### `tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L944" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `tool` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L943" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythontool(self, name_or_fn: str | AnyFunction | None = None) -> Callable[[AnyFunction], FunctionTool] | FunctionTool@@ -404,7 +404,7 @@ server.tool(my_function, name="custom_name")```-#### `add_resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1075" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `add_resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1074" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonadd_resource(self, resource: Resource) -> Resource@@ -419,7 +419,7 @@ Add a resource to the server.- The resource instance that was added to the server.-#### `add_template` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1097" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `add_template` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1096" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonadd_template(self, template: ResourceTemplate) -> ResourceTemplate@@ -434,7 +434,7 @@ Add a resource template to the server.- The template instance that was added to the server.-#### `add_resource_fn` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1119" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `add_resource_fn` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1118" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonadd_resource_fn(self, fn: AnyFunction, uri: str, name: str | None = None, description: str | None = None, mime_type: str | None = None, tags: set[str] | None = None) -> None@@ -454,7 +454,7 @@ has parameters, it will be registered as a template resource.- `tags`: Optional set of tags for categorizing the resource-#### `resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1157" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `resource` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1156" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonresource(self, uri: str) -> Callable[[AnyFunction], Resource | ResourceTemplate]@@ -514,7 +514,7 @@ async def get_weather(city: str) -> str:```-#### `add_prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1294" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `add_prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1293" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonadd_prompt(self, prompt: Prompt) -> Prompt@@ -529,19 +529,19 @@ Add a prompt to the server.- The prompt instance that was added to the server.-#### `prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1317" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1316" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonprompt(self, name_or_fn: AnyFunction) -> FunctionPrompt```-#### `prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1330" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1329" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonprompt(self, name_or_fn: str | None = None) -> Callable[[AnyFunction], FunctionPrompt]```-#### `prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1342" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `prompt` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1341" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonprompt(self, name_or_fn: str | AnyFunction | None = None) -> Callable[[AnyFunction], FunctionPrompt] | FunctionPrompt@@ -619,7 +619,7 @@ Decorator to register a prompt.```-#### `run_stdio_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1483" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `run_stdio_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1482" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrun_stdio_async(self, show_banner: bool = True) -> None@@ -628,7 +628,7 @@ run_stdio_async(self, show_banner: bool = True) -> NoneRun the server using stdio transport.-#### `run_http_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1503" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `run_http_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1502" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrun_http_async(self, show_banner: bool = True, transport: Literal['http', 'streamable-http', 'sse'] = 'http', host: str | None = None, port: int | None = None, log_level: str | None = None, path: str | None = None, uvicorn_config: dict[str, Any] | None = None, middleware: list[ASGIMiddleware] | None = None, stateless_http: bool | None = None) -> None@@ -647,7 +647,7 @@ Run the server using HTTP transport.- `stateless_http`: Whether to use stateless HTTP (defaults to settings.stateless_http)-#### `run_sse_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1577" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `run_sse_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1576" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrun_sse_async(self, host: str | None = None, port: int | None = None, log_level: str | None = None, path: str | None = None, uvicorn_config: dict[str, Any] | None = None) -> None@@ -656,7 +656,7 @@ run_sse_async(self, host: str | None = None, port: int | None = None, log_level:Run the server using SSE transport.-#### `sse_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1605" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `sse_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1604" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonsse_app(self, path: str | None = None, message_path: str | None = None, middleware: list[ASGIMiddleware] | None = None) -> StarletteWithLifespan@@ -670,7 +670,7 @@ Create a Starlette app for the SSE server.- `middleware`: A list of middleware to apply to the app-#### `streamable_http_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1636" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `streamable_http_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1635" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonstreamable_http_app(self, path: str | None = None, middleware: list[ASGIMiddleware] | None = None) -> StarletteWithLifespan@@ -683,7 +683,7 @@ Create a Starlette app for the StreamableHTTP server.- `middleware`: A list of middleware to apply to the app-#### `http_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1657" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `http_app` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1656" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonhttp_app(self, path: str | None = None, middleware: list[ASGIMiddleware] | None = None, json_response: bool | None = None, stateless_http: bool | None = None, transport: Literal['http', 'streamable-http', 'sse'] = 'http') -> StarletteWithLifespan@@ -700,13 +700,13 @@ Create a Starlette app using the specified HTTP transport.- A Starlette application configured with the specified transport-#### `run_streamable_http_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1706" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `run_streamable_http_async` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1705" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonrun_streamable_http_async(self, host: str | None = None, port: int | None = None, log_level: str | None = None, path: str | None = None, uvicorn_config: dict[str, Any] | None = None) -> None```-#### `mount` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1731" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `mount` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1730" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonmount(self, server: FastMCP[LifespanResultT], prefix: str | None = None, as_proxy: bool | None = None) -> None@@ -760,7 +760,7 @@ automatically determined based on whether the server has a custom lifespan- `prompt_separator`: Deprecated. Separator character for prompt names.-#### `import_server` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1853" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `import_server` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1852" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonimport_server(self, server: FastMCP[LifespanResultT], prefix: str | None = None, tool_separator: str | None = None, resource_separator: str | None = None, prompt_separator: str | None = None) -> None@@ -801,7 +801,7 @@ applied using the protocol\://prefix/path format- `prompt_separator`: Deprecated. Separator for prompt names.-#### `from_openapi` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1982" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `from_openapi` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L1981" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonfrom_openapi(cls, openapi_spec: dict[str, Any], client: httpx.AsyncClient, route_maps: list[RouteMap] | list[RouteMapNew] | None = None, route_map_fn: OpenAPIRouteMapFn | OpenAPIRouteMapFnNew | None = None, mcp_component_fn: OpenAPIComponentFn | OpenAPIComponentFnNew | None = None, mcp_names: dict[str, str] | None = None, tags: set[str] | None = None, **settings: Any) -> FastMCPOpenAPI | FastMCPOpenAPINew@@ -810,7 +810,7 @@ from_openapi(cls, openapi_spec: dict[str, Any], client: httpx.AsyncClient, routeCreate a FastMCP server from an OpenAPI specification.-#### `from_fastapi` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2031" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `from_fastapi` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2030" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonfrom_fastapi(cls, app: Any, name: str | None = None, route_maps: list[RouteMap] | list[RouteMapNew] | None = None, route_map_fn: OpenAPIRouteMapFn | OpenAPIRouteMapFnNew | None = None, mcp_component_fn: OpenAPIComponentFn | OpenAPIComponentFnNew | None = None, mcp_names: dict[str, str] | None = None, httpx_client_kwargs: dict[str, Any] | None = None, tags: set[str] | None = None, **settings: Any) -> FastMCPOpenAPI | FastMCPOpenAPINew@@ -819,7 +819,7 @@ from_fastapi(cls, app: Any, name: str | None = None, route_maps: list[RouteMap]Create a FastMCP server from a FastAPI application.-#### `as_proxy` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2094" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `as_proxy` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2093" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonas_proxy(cls, backend: Client[ClientTransportT] | ClientTransport | FastMCP[Any] | AnyUrl | Path | MCPConfig | dict[str, Any] | str, **settings: Any) -> FastMCPProxy@@ -833,7 +833,7 @@ instance or any value accepted as the `transport` argument of`fastmcp.client.Client` constructor.-#### `from_client` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2155" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `from_client` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2154" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythonfrom_client(cls, client: Client[ClientTransportT], **settings: Any) -> FastMCPProxy@@ -842,10 +842,10 @@ from_client(cls, client: Client[ClientTransportT], **settings: Any) -> FastMCPPrCreate a FastMCP proxy server from a FastMCP client.-#### `generate_name` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2207" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+#### `generate_name` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2206" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>```pythongenerate_name(cls, name: str | None = None) -> str```-### `MountedServer` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2217" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>+### `MountedServer` <sup><a href="https://github.com/jlowin/fastmcp/blob/main/src/fastmcp/server/server.py#L2216" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>diff --git a/docs/servers/auth/authentication.mdx b/docs/servers/auth/authentication.mdxindex c8a5b6380..9c75a776c 100644--- a/docs/servers/auth/authentication.mdx+++ b/docs/servers/auth/authentication.mdx@@ -191,46 +191,54 @@ Authentication providers are instantiated directly in your code with their requi### Environment Configuration+<VersionBadge version="2.12.1" />+Environment-based configuration separates authentication settings from application code, enabling the same codebase to work across different deployment environments without modification.FastMCP automatically detects authentication configuration from environment variables when no explicit `auth` parameter is provided. The configuration system supports all authentication providers and their various options.-#### Registered Providers+#### Provider Configuration-FastMCP includes pre-configured providers for popular OAuth services that can be activated with a single environment variable:+Authentication providers are configured by specifying the full module path to the provider class:<ParamField path="FASTMCP_SERVER_AUTH" type="string">-The authentication provider to use. Supported values:-- `GITHUB` - GitHub OAuth (requires additional GitHub-specific env vars)-- `GOOGLE` - Google OAuth (requires additional Google-specific env vars)-- `JWT` - JWT token verification-- `WORKOS` - WorkOS AuthKit-- Custom provider class names+The full module path to the authentication provider class. Examples:+- `fastmcp.server.auth.providers.github.GitHubProvider` - GitHub OAuth+- `fastmcp.server.auth.providers.google.GoogleProvider` - Google OAuth+- `fastmcp.server.auth.providers.jwt.JWTVerifier` - JWT token verification+- `fastmcp.server.auth.providers.workos.WorkOSProvider` - WorkOS OAuth+- `fastmcp.server.auth.providers.workos.AuthKitProvider` - WorkOS AuthKit+- `mycompany.auth.CustomProvider` - Your custom provider class</ParamField>-When using registered providers like GitHub or Google, you'll need to set provider-specific environment variables:+When using providers like GitHub or Google, you'll need to set provider-specific environment variables:```bash# GitHub OAuth-export FASTMCP_SERVER_AUTH=GITHUB+export FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.github.GitHubProviderexport FASTMCP_SERVER_AUTH_GITHUB_CLIENT_ID="Ov23li..."export FASTMCP_SERVER_AUTH_GITHUB_CLIENT_SECRET="github_pat_..."# Google OAuth-export FASTMCP_SERVER_AUTH=GOOGLE+export FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.google.GoogleProviderexport FASTMCP_SERVER_AUTH_GOOGLE_CLIENT_ID="123456.apps.googleusercontent.com"export FASTMCP_SERVER_AUTH_GOOGLE_CLIENT_SECRET="GOCSPX-..."```-#### Custom Provider Configuration+#### Provider-Specific Configuration-For providers that aren't pre-registered, specify the provider class and its configuration:+Each provider has its own configuration options set through environment variables:```bash-export FASTMCP_SERVER_AUTH=JWT+# JWT Token Verification+export FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.jwt.JWTVerifierexport FASTMCP_SERVER_AUTH_JWT_JWKS_URI="https://auth.example.com/jwks"export FASTMCP_SERVER_AUTH_JWT_ISSUER="https://auth.example.com"export FASTMCP_SERVER_AUTH_JWT_AUDIENCE="mcp-server"++# Custom Provider+export FASTMCP_SERVER_AUTH=mycompany.auth.CustomProvider+# Plus any environment variables your custom provider expects```With these environment variables set, creating an authenticated FastMCP server requires no additional configuration:diff --git a/docs/servers/auth/oauth-proxy.mdx b/docs/servers/auth/oauth-proxy.mdxindex fadf9b03c..15a07743e 100644--- a/docs/servers/auth/oauth-proxy.mdx+++ b/docs/servers/auth/oauth-proxy.mdx@@ -347,30 +347,26 @@ For providers without built-in support, implement a [`TokenVerifier`](/servers/a## Environment Configuration-OAuth Proxy supports environment-based configuration for production deployments:+<VersionBadge version="2.12.1" />-```bash-# Provider selection-export FASTMCP_SERVER_AUTH=OAUTH_PROXY--# OAuth endpoints-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_UPSTREAM_AUTHORIZATION_ENDPOINT="https://github.com/login/oauth/authorize"-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_UPSTREAM_TOKEN_ENDPOINT="https://github.com/login/oauth/access_token"--# Credentials (use secrets management in production)-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_UPSTREAM_CLIENT_ID="Ov23li..."-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_UPSTREAM_CLIENT_SECRET="abc123..."+OAuth Proxy-based providers support environment-based configuration for production deployments. Use the specific provider implementations rather than the base OAuth Proxy class:-# Token validation-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_TOKEN_VERIFIER="JWT"-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_JWKS_URI="https://provider.com/.well-known/jwks.json"-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_ISSUER="https://provider.com"-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_AUDIENCE="your-app-id"--# Server URL-export FASTMCP_SERVER_AUTH_OAUTH_PROXY_BASE_URL="https://your-server.com"+```bash+# Use a specific provider implementation+export FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.github.GitHubProvider+# or+export FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.google.GoogleProvider+# or your custom OAuth Proxy implementation+export FASTMCP_SERVER_AUTH=mycompany.auth.CustomOAuthProvider++# Provider-specific configuration (example for GitHub)+export FASTMCP_SERVER_AUTH_GITHUB_CLIENT_ID="Ov23li..."+export FASTMCP_SERVER_AUTH_GITHUB_CLIENT_SECRET="abc123..."+export FASTMCP_SERVER_AUTH_GITHUB_BASE_URL="https://your-server.com"```+For custom OAuth Proxy implementations, configure the environment variables based on your provider's settings class.+With environment variables configured, your code becomes:```pythondiff --git a/docs/servers/auth/token-verification.mdx b/docs/servers/auth/token-verification.mdxindex 6d6dd4903..d2523151c 100644--- a/docs/servers/auth/token-verification.mdx+++ b/docs/servers/auth/token-verification.mdx@@ -211,13 +211,15 @@ This pattern enables comprehensive testing of JWT validation logic without depen## Environment Configuration+<VersionBadge version="2.12.1" />+FastMCP supports both programmatic and environment-based configuration for token verification, enabling flexible deployment across different environments.Environment-based configuration separates authentication settings from application code, following twelve-factor app principles and simplifying deployment pipelines.```bash# Enable JWT verification-export FASTMCP_SERVER_AUTH=JWT+export FASTMCP_SERVER_AUTH=fastmcp.server.auth.providers.jwt.JWTVerifier# For asymmetric verification with JWKS endpoint:export FASTMCP_SERVER_AUTH_JWT_JWKS_URI="https://auth.company.com/.well-known/jwks.json"diff --git a/src/fastmcp/server/auth/providers/azure.py b/src/fastmcp/server/auth/providers/azure.pyindex 806dddf18..dfae3e66a 100644--- a/src/fastmcp/server/auth/providers/azure.py+++ b/src/fastmcp/server/auth/providers/azure.py@@ -12,7 +12,6 @@ from pydantic_settings import BaseSettings, SettingsConfigDictfrom fastmcp.server.auth import AccessToken, TokenVerifierfrom fastmcp.server.auth.oauth_proxy import OAuthProxy-from fastmcp.server.auth.registry import register_providerfrom fastmcp.utilities.auth import parse_scopesfrom fastmcp.utilities.logging import get_loggerfrom fastmcp.utilities.types import NotSet, NotSetT@@ -116,7 +115,6 @@ class AzureTokenVerifier(TokenVerifier):return None-@register_provider("AZURE")class AzureProvider(OAuthProxy):"""Azure (Microsoft Entra) OAuth provider for FastMCP.diff --git a/src/fastmcp/server/auth/providers/github.py b/src/fastmcp/server/auth/providers/github.pyindex 49613897a..730b28573 100644--- a/src/fastmcp/server/auth/providers/github.py+++ b/src/fastmcp/server/auth/providers/github.py@@ -28,7 +28,6 @@ from pydantic_settings import BaseSettings, SettingsConfigDictfrom fastmcp.server.auth import TokenVerifierfrom fastmcp.server.auth.auth import AccessTokenfrom fastmcp.server.auth.oauth_proxy import OAuthProxy-from fastmcp.server.auth.registry import register_providerfrom fastmcp.utilities.auth import parse_scopesfrom fastmcp.utilities.logging import get_loggerfrom fastmcp.utilities.types import NotSet, NotSetT@@ -165,7 +164,6 @@ class GitHubTokenVerifier(TokenVerifier):return None-@register_provider("GitHub")class GitHubProvider(OAuthProxy):"""Complete GitHub OAuth provider for FastMCP.diff --git a/src/fastmcp/server/auth/providers/google.py b/src/fastmcp/server/auth/providers/google.pyindex 337bf6157..27cebd85c 100644--- a/src/fastmcp/server/auth/providers/google.py+++ b/src/fastmcp/server/auth/providers/google.py@@ -30,7 +30,6 @@ from pydantic_settings import BaseSettings, SettingsConfigDictfrom fastmcp.server.auth import TokenVerifierfrom fastmcp.server.auth.auth import AccessTokenfrom fastmcp.server.auth.oauth_proxy import OAuthProxy-from fastmcp.server.auth.registry import register_providerfrom fastmcp.utilities.auth import parse_scopesfrom fastmcp.utilities.logging import get_loggerfrom fastmcp.utilities.types import NotSet, NotSetT@@ -181,7 +180,6 @@ class GoogleTokenVerifier(TokenVerifier):return None-@register_provider("Google")class GoogleProvider(OAuthProxy):"""Complete Google OAuth provider for FastMCP.diff --git a/src/fastmcp/server/auth/providers/jwt.py b/src/fastmcp/server/auth/providers/jwt.pyindex 19eac1bb2..0f16ba456 100644--- a/src/fastmcp/server/auth/providers/jwt.py+++ b/src/fastmcp/server/auth/providers/jwt.py@@ -16,7 +16,6 @@ from pydantic_settings import BaseSettings, SettingsConfigDictfrom typing_extensions import TypedDictfrom fastmcp.server.auth import AccessToken, TokenVerifier-from fastmcp.server.auth.registry import register_providerfrom fastmcp.utilities.auth import parse_scopesfrom fastmcp.utilities.logging import get_loggerfrom fastmcp.utilities.types import NotSet, NotSetT@@ -162,7 +161,6 @@ class JWTVerifierSettings(BaseSettings):return parse_scopes(v)-@register_provider("JWT")class JWTVerifier(TokenVerifier):"""JWT token verifier supporting both asymmetric (RSA/ECDSA) and symmetric (HMAC) algorithms.diff --git a/src/fastmcp/server/auth/providers/workos.py b/src/fastmcp/server/auth/providers/workos.pyindex 2c443eb64..4b76cd1b3 100644--- a/src/fastmcp/server/auth/providers/workos.py+++ b/src/fastmcp/server/auth/providers/workos.py@@ -19,7 +19,6 @@ from starlette.routing import Routefrom fastmcp.server.auth import AccessToken, RemoteAuthProvider, TokenVerifierfrom fastmcp.server.auth.oauth_proxy import OAuthProxyfrom fastmcp.server.auth.providers.jwt import JWTVerifier-from fastmcp.server.auth.registry import register_providerfrom fastmcp.utilities.auth import parse_scopesfrom fastmcp.utilities.logging import get_loggerfrom fastmcp.utilities.types import NotSet, NotSetT@@ -124,7 +123,6 @@ class WorkOSTokenVerifier(TokenVerifier):return None-@register_provider("WORKOS")class WorkOSProvider(OAuthProxy):"""Complete WorkOS OAuth provider for FastMCP.@@ -281,7 +279,6 @@ class AuthKitProviderSettings(BaseSettings):return parse_scopes(v)-@register_provider("AUTHKIT")class AuthKitProvider(RemoteAuthProvider):"""AuthKit metadata provider for DCR (Dynamic Client Registration).diff --git a/src/fastmcp/server/auth/registry.py b/src/fastmcp/server/auth/registry.pydeleted file mode 100644index 8eab2ab76..000000000--- a/src/fastmcp/server/auth/registry.py+++ /dev/null@@ -1,52 +0,0 @@-"""Provider registry for FastMCP auth providers."""--from __future__ import annotations--from collections.abc import Callable-from typing import TYPE_CHECKING, TypeVar--if TYPE_CHECKING:- from fastmcp.server.auth import AuthProvider--# Type variable for auth providers-T = TypeVar("T", bound="AuthProvider")---# Provider Registry-_PROVIDER_REGISTRY: dict[str, type[AuthProvider]] = {}---def register_provider(name: str) -> Callable[[type[T]], type[T]]:- """Decorator to register an auth provider with a given name.-- Args:- name: The name to register the provider under (e.g., 'AUTHKIT')-- Returns:- The decorated class-- Example:- @register_provider('AUTHKIT')- class AuthKitProvider(AuthProvider):- ...- """-- def decorator(cls: type[T]) -> type[T]:- _PROVIDER_REGISTRY[name.upper()] = cls- return cls-- return decorator---def get_registered_provider(name: str) -> type[AuthProvider]:- """Get a registered provider by name.-- Args:- name: The provider name (case-insensitive)-- Returns:- The provider class if found, None otherwise- """- if name.upper() in _PROVIDER_REGISTRY:- return _PROVIDER_REGISTRY[name.upper()]- raise ValueError(f"Provider {name!r} has not been registered.")diff --git a/src/fastmcp/server/server.py b/src/fastmcp/server/server.pyindex bc7788288..ed4ada427 100644--- a/src/fastmcp/server/server.py+++ b/src/fastmcp/server/server.py@@ -52,7 +52,6 @@ from fastmcp.prompts.prompt import FunctionPromptfrom fastmcp.resources import Resource, ResourceManagerfrom fastmcp.resources.template import ResourceTemplatefrom fastmcp.server.auth import AuthProvider-from fastmcp.server.auth.registry import get_registered_providerfrom fastmcp.server.http import (StarletteWithLifespan,create_sse_app,@@ -209,8 +208,8 @@ class FastMCP(Generic[LifespanResultT]):# if auth is `NotSet`, try to create a provider from the environmentif auth is NotSet:if fastmcp.settings.server_auth is not None:- provider_cls = get_registered_provider(fastmcp.settings.server_auth)- auth = provider_cls()+ # ImportString returns the class itself+ auth = fastmcp.settings.server_auth()else:auth = Noneself.auth = cast(AuthProvider | None, auth)diff --git a/src/fastmcp/settings.py b/src/fastmcp/settings.pyindex 91a0bb33b..746cabdfa 100644--- a/src/fastmcp/settings.py+++ b/src/fastmcp/settings.py@@ -5,7 +5,7 @@ import warningsfrom pathlib import Pathfrom typing import Annotated, Any, Literal-from pydantic import Field, field_validator+from pydantic import Field, ImportString, field_validatorfrom pydantic.fields import FieldInfofrom pydantic_settings import (BaseSettings,@@ -258,14 +258,17 @@ class Settings(BaseSettings):# Auth settingsserver_auth: Annotated[- str | None,+ ImportString | None,Field(description=inspect.cleandoc("""- Configure the authentication provider for the server. Auth- providers are registered with a specific key, and providing that- key here will cause the server to automatically configure the- provider from the environment.+ Configure the authentication provider for the server by specifying+ the full module path to an AuthProvider class (e.g.,+ 'fastmcp.server.auth.providers.google.GoogleProvider').++ The specified class will be imported and instantiated automatically.+ Any class that inherits from AuthProvider can be used, including+ custom implementations.If None, no automatic configuration will take place.@@ -274,6 +277,11 @@ class Settings(BaseSettings):Note that most auth providers require additional configurationthat must be provided via env vars.++ Examples:+ - fastmcp.server.auth.providers.google.GoogleProvider+ - fastmcp.server.auth.providers.jwt.JWTVerifier+ - mycompany.auth.CustomAuthProvider"""),),