refactor: align protocol version header capitalization to lowercase (#911)

Author: felixweinberger

src/mcp/client/auth.py

@@ -17,7 +17,13 @@
 import anyio
 import httpx
 
-from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthMetadata, OAuthToken
+from mcp.client.streamable_http import MCP_PROTOCOL_VERSION
+from mcp.shared.auth import (
+    OAuthClientInformationFull,
+    OAuthClientMetadata,
+    OAuthMetadata,
+    OAuthToken,
+)
 from mcp.types import LATEST_PROTOCOL_VERSION
 
 logger = logging.getLogger(__name__)
@@ -121,7 +127,7 @@ async def _discover_oauth_metadata(self, server_url: str) -> OAuthMetadata | Non
         # Extract base URL per MCP spec
         auth_base_url = self._get_authorization_base_url(server_url)
         url = urljoin(auth_base_url, "/.well-known/oauth-authorization-server")
-        headers = {"MCP-Protocol-Version": LATEST_PROTOCOL_VERSION}
+        headers = {MCP_PROTOCOL_VERSION: LATEST_PROTOCOL_VERSION}
 
         async with httpx.AsyncClient() as client:
             try:

src/mcp/client/streamable_http.py

@@ -39,7 +39,7 @@
 GetSessionIdCallback = Callable[[], str | None]
 
 MCP_SESSION_ID = "mcp-session-id"
-MCP_PROTOCOL_VERSION = "MCP-Protocol-Version"
+MCP_PROTOCOL_VERSION = "mcp-protocol-version"
 LAST_EVENT_ID = "last-event-id"
 CONTENT_TYPE = "content-type"
 ACCEPT = "Accept"

src/mcp/server/auth/routes.py

@@ -16,6 +16,7 @@
 from mcp.server.auth.middleware.client_auth import ClientAuthenticator
 from mcp.server.auth.provider import OAuthAuthorizationServerProvider
 from mcp.server.auth.settings import ClientRegistrationOptions, RevocationOptions
+from mcp.server.streamable_http import MCP_PROTOCOL_VERSION_HEADER
 from mcp.shared.auth import OAuthMetadata
 
 
@@ -55,7 +56,7 @@ def cors_middleware(
         app=request_response(handler),
         allow_origins="*",
         allow_methods=allow_methods,
-        allow_headers=["mcp-protocol-version"],
+        allow_headers=[MCP_PROTOCOL_VERSION_HEADER],
     )
     return cors_app
 

src/mcp/server/streamable_http.py

@@ -46,7 +46,7 @@
 
 # Header names
 MCP_SESSION_ID_HEADER = "mcp-session-id"
-MCP_PROTOCOL_VERSION_HEADER = "MCP-Protocol-Version"
+MCP_PROTOCOL_VERSION_HEADER = "mcp-protocol-version"
 LAST_EVENT_ID_HEADER = "last-event-id"
 
 # Content types

tests/shared/test_streamable_http.py

@@ -1415,7 +1415,7 @@ async def test_streamablehttp_request_context_isolation(context_aware_server: No
 async def test_client_includes_protocol_version_header_after_init(
     context_aware_server, basic_server_url
 ):
-    """Test that client includes MCP-Protocol-Version header after initialization."""
+    """Test that client includes mcp-protocol-version header after initialization."""
     async with streamablehttp_client(f"{basic_server_url}/mcp") as (
         read_stream,
         write_stream,
@@ -1435,7 +1435,7 @@ async def test_client_includes_protocol_version_header_after_init(
 
             # Verify protocol version header is present
             assert "mcp-protocol-version" in headers_data
-            assert headers_data["mcp-protocol-version"] == negotiated_version
+            assert headers_data[MCP_PROTOCOL_VERSION_HEADER] == negotiated_version
 
 
 def test_server_validates_protocol_version_header(basic_server, basic_server_url):
@@ -1518,7 +1518,7 @@ def test_server_backwards_compatibility_no_protocol_version(
     assert init_response.status_code == 200
     session_id = init_response.headers.get(MCP_SESSION_ID_HEADER)
 
-    # Test request without MCP-Protocol-Version header (backwards compatibility)
+    # Test request without mcp-protocol-version header (backwards compatibility)
     response = requests.post(
         f"{basic_server_url}/mcp",
         headers={