From 79b36f66b114ab844199de5e55f22338c37fe0dd Mon Sep 17 00:00:00 2001
From: Jeremiah Lowin <153965+jlowin@users.noreply.github.com>
Date: Sat, 1 Nov 2025 13:01:00 -0700
Subject: [PATCH] Remove deprecated BearerAuthProvider module (#2341)

---
 docs/docs.json                                |  1 -
 .../fastmcp-server-auth-providers-bearer.mdx  | 13 ----------
 src/fastmcp/server/auth/__init__.py           |  9 -------
 src/fastmcp/server/auth/providers/bearer.py   | 25 -------------------
 tests/deprecated/test_bearer_auth_provider.py | 13 ----------
 5 files changed, 61 deletions(-)
 delete mode 100644 docs/python-sdk/fastmcp-server-auth-providers-bearer.mdx
 delete mode 100644 src/fastmcp/server/auth/providers/bearer.py
 delete mode 100644 tests/deprecated/test_bearer_auth_provider.py

diff --git a/docs/docs.json b/docs/docs.json
index 0308ae2db..cac05f32e 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -355,7 +355,6 @@
                           "python-sdk/fastmcp-server-auth-providers-auth0",
                           "python-sdk/fastmcp-server-auth-providers-aws",
                           "python-sdk/fastmcp-server-auth-providers-azure",
-                          "python-sdk/fastmcp-server-auth-providers-bearer",
                           "python-sdk/fastmcp-server-auth-providers-descope",
                           "python-sdk/fastmcp-server-auth-providers-github",
                           "python-sdk/fastmcp-server-auth-providers-google",
diff --git a/docs/python-sdk/fastmcp-server-auth-providers-bearer.mdx b/docs/python-sdk/fastmcp-server-auth-providers-bearer.mdx
deleted file mode 100644
index 3cfbf0239..000000000
--- a/docs/python-sdk/fastmcp-server-auth-providers-bearer.mdx
+++ /dev/null
@@ -1,13 +0,0 @@
----
-title: bearer
-sidebarTitle: bearer
----
-
-# `fastmcp.server.auth.providers.bearer`
-
-
-Backwards compatibility shim for BearerAuthProvider.
-
-The BearerAuthProvider class has been moved to fastmcp.server.auth.providers.jwt.JWTVerifier
-for better organization. This module provides a backwards-compatible import.
-
diff --git a/src/fastmcp/server/auth/__init__.py b/src/fastmcp/server/auth/__init__.py
index e33ad022a..43f2f3f2e 100644
--- a/src/fastmcp/server/auth/__init__.py
+++ b/src/fastmcp/server/auth/__init__.py
@@ -23,12 +23,3 @@ __all__ = [
     "StaticTokenVerifier",
     "TokenVerifier",
 ]
-
-
-def __getattr__(name: str):
-    # Defer import because it raises a deprecation warning
-    if name == "BearerAuthProvider":
-        from .providers.bearer import BearerAuthProvider
-
-        return BearerAuthProvider
-    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
diff --git a/src/fastmcp/server/auth/providers/bearer.py b/src/fastmcp/server/auth/providers/bearer.py
deleted file mode 100644
index 1482ab0f3..000000000
--- a/src/fastmcp/server/auth/providers/bearer.py
+++ /dev/null
@@ -1,25 +0,0 @@
-"""Backwards compatibility shim for BearerAuthProvider.
-
-The BearerAuthProvider class has been moved to fastmcp.server.auth.providers.jwt.JWTVerifier
-for better organization. This module provides a backwards-compatible import.
-"""
-
-import warnings
-
-import fastmcp
-from fastmcp.server.auth.providers.jwt import JWKData, JWKSData, RSAKeyPair
-from fastmcp.server.auth.providers.jwt import JWTVerifier as BearerAuthProvider
-
-# Re-export for backwards compatibility
-__all__ = ["BearerAuthProvider", "JWKData", "JWKSData", "RSAKeyPair"]
-
-# Deprecated in 2.11
-if fastmcp.settings.deprecation_warnings:
-    warnings.warn(
-        "The `fastmcp.server.auth.providers.bearer` module is deprecated "
-        "and will be removed in a future version. "
-        "Please use `fastmcp.server.auth.providers.jwt.JWTVerifier` "
-        "instead of this module's BearerAuthProvider.",
-        DeprecationWarning,
-        stacklevel=2,
-    )
diff --git a/tests/deprecated/test_bearer_auth_provider.py b/tests/deprecated/test_bearer_auth_provider.py
deleted file mode 100644
index 5e02677d1..000000000
--- a/tests/deprecated/test_bearer_auth_provider.py
+++ /dev/null
@@ -1,13 +0,0 @@
-import pytest
-
-# reset deprecation warnings for this module
-pytestmark = pytest.mark.filterwarnings("default::DeprecationWarning")
-
-
-def test_bearer_auth_provider_deprecated():
-    """Test that BearerAuthProvider import shows deprecation warning."""
-    with pytest.warns(
-        DeprecationWarning,
-        match="The `fastmcp.server.auth.providers.bearer` module is deprecated and will be removed in a future version. Please use `fastmcp.server.auth.providers.jwt.JWTVerifier` instead of this module's BearerAuthProvider.",
-    ):
-        from fastmcp.server.auth import BearerAuthProvider  # noqa: F401