Title: `Client(mode="auto")` falls back to legacy when interactive OAuth exceeds the fixed `server/discover` timeout · Issue #3601 · modelcontextprotocol/python-sdk · GitHub
Open Graph Title: `Client(mode="auto")` falls back to legacy when interactive OAuth exceeds the fixed `server/discover` timeout · Issue #3601 · modelcontextprotocol/python-sdk
X Title: `Client(mode="auto")` falls back to legacy when interactive OAuth exceeds the fixed `server/discover` timeout · Issue #3601 · modelcontextprotocol/python-sdk
Description: Initial Checks I confirm that I'm using the newest release of my line (the latest 2.x, or the latest 1.x if I'm still on v1) I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before openi...
Open Graph Description: Initial Checks I confirm that I'm using the newest release of my line (the latest 2.x, or the latest 1.x if I'm still on v1) I confirm that I searched for my issue in https://github.com/modelcontex...
X Description: Initial Checks I confirm that I'm using the newest release of my line (the latest 2.x, or the latest 1.x if I'm still on v1) I confirm that I searched for my issue in https://github.com/mod...
Opengraph URL: https://github.com/modelcontextprotocol/python-sdk/issues/3601
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"`Client(mode=\"auto\")` falls back to legacy when interactive OAuth exceeds the fixed `server/discover` timeout","articleBody":"### Initial Checks\n\n- [x] I confirm that I'm using the newest release of my line (the latest 2.x, or the latest 1.x if I'm still on v1)\n- [x] I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue\n\n### Release line\n\n2.x (current stable)\n\n### Description\n\n## What happens\n\n`Client(mode=\"auto\")` probes `server/discover` before falling back to the legacy `initialize` handshake.\n\n`ClientSession.send_discover()` applies a fixed internal timeout:\n\n```python\nDISCOVER_TIMEOUT_SECONDS = 10.0\n```\n\nWhen the first MCP request triggers an interactive OAuth authorization-code flow, that timeout includes the time spent waiting for the user to complete browser authorization.\n\nIf authorization takes longer than 10 seconds:\n\n1. The client sends a modern `server/discover` request.\n2. The server returns `401`, and the OAuth flow starts.\n3. The discovery request times out while waiting for the user callback.\n4. `mode=\"auto\"` falls back to legacy `initialize`.\n5. OAuth completes and correctly retries the original authenticated `server/discover`.\n6. The retry receives a valid modern `DiscoverResult`, but the client has already selected the legacy protocol.\n\nAs a result, a modern upstream is exposed as legacy only on cold interactive OAuth flows. Once credentials are cached, the same upstream negotiates `2026-07-28` correctly.\n\n## Expected behavior\n\nInteractive OAuth should not cause a modern server to be classified as legacy solely because user authorization took longer than the discovery timeout.\n\n## Environment\n\n- `mcp==2.1.1`\n- Python 3.12\n- Streamable HTTP transport\n- `Client(mode=\"auto\")`\n- `OAuthClientProvider`\n\nThe current `v2.2.0` source still defines `DISCOVER_TIMEOUT_SECONDS = 10.0` and uses it directly in `send_discover()`.\n\n## Suggested direction\n\nA public configuration point for the discovery timeout would let interactive clients choose an appropriate bound, for example:\n\n```python\nClient(\n transport,\n mode=\"auto\",\n discover_timeout_seconds=300.0,\n)\n```\n\nThat value would need to flow into `ClientSession.send_discover()` instead of relying only on the fixed module-level constant.\n\nAlternatively, the SDK could avoid counting time spent in an interactive OAuth authorization flow against the discovery timeout.\n\n### Example Code\n\n```Python\nimport asyncio\nimport json\n\nimport anyio\nimport httpx2\nfrom mcp.client import Client\nfrom mcp.client.streamable_http import streamable_http_client\n\n\nclass SlowInteractiveOAuth(httpx2.Auth):\n \"\"\"Models an OAuth flow which takes longer than the 10s discover timeout.\"\"\"\n\n requires_response_body = True\n\n async def async_auth_flow(self, request: httpx2.Request):\n response = yield request\n\n if response.status_code == 401:\n # Simulate the user taking 11 seconds to complete browser authorization.\n await anyio.sleep(11)\n\n # Retry the exact original request, now authenticated.\n request.headers[\"Authorization\"] = \"Bearer access-token\"\n yield request\n\n\nasync def handler(request: httpx2.Request) -> httpx2.Response:\n payload = json.loads(request.content)\n method = payload.get(\"method\")\n request_id = payload.get(\"id\")\n\n if method == \"server/discover\":\n if \"authorization\" not in request.headers:\n return httpx2.Response(\n 401,\n headers={\"WWW-Authenticate\": \"Bearer\"},\n )\n\n # The authenticated retry is a valid modern response.\n return httpx2.Response(\n 200,\n json={\n \"jsonrpc\": \"2.0\",\n \"id\": request_id,\n \"result\": {\n \"resultType\": \"complete\",\n \"supportedVersions\": [\"2026-07-28\"],\n \"capabilities\": {},\n \"ttlMs\": 0,\n \"cacheScope\": \"private\",\n },\n },\n )\n\n if method == \"initialize\":\n return httpx2.Response(\n 200,\n json={\n \"jsonrpc\": \"2.0\",\n \"id\": request_id,\n \"result\": {\n \"protocolVersion\": \"2025-11-25\",\n \"capabilities\": {},\n \"serverInfo\": {\n \"name\": \"legacy-fallback\",\n \"version\": \"1.0\",\n },\n },\n },\n )\n\n return httpx2.Response(202)\n\n\nasync def main() -> None:\n async with httpx2.AsyncClient(\n transport=httpx2.MockTransport(handler),\n auth=SlowInteractiveOAuth(),\n ) as http_client, Client(\n streamable_http_client(\n \"https://mcp.example.test/mcp\",\n http_client=http_client,\n ),\n mode=\"auto\",\n ) as client:\n print(client.protocol_version)\n\n\nasyncio.run(main())\n```\n\nExpected output:\n2026-07-28\n\nActual output:\n2025-11-25\n\n### Python & MCP Python SDK\n\n```Text\nPython 3.12\nmcp==2.1.1\n```","author":{"url":"https://github.com/pablozamudio","@type":"Person","name":"pablozamudio"},"datePublished":"2026-09-30T19:46:53Z","url":"https://github.com/modelcontextprotocol/python-sdk/issues/3601"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:cc7409e1-1bb6-583d-9d54-5df8a55e399c |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 8162:3CBB3E:8358F9:A68C83:6B012185 |
| html-safe-nonce | d4b2fa948ee86340aec228d124272970891d033e200ad40ee2e4c63128851110 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4MTYyOjNDQkIzRTo4MzU4Rjk6QTY4QzgzOjZCMDEyMTg1IiwidmlzaXRvcl9pZCI6IjEwNTM2NzMwNDk5Mzg3OTY5MzMiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 65dbca23dfa6dfc169af213cc8b37e3cbacbf5f5177f94ae905e09e19923b543 |
| hovercard-subject-tag | issue:5652111879 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/modelcontextprotocol/python-sdk/3601/issue_layout |
| twitter:image | https://opengraph.githubassets.com/54d1e8088252fce9def380fa33eef1171f9bf01dcdfaa10688f2ef35fdb95a3e/modelcontextprotocol/python-sdk/issues/3601 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/54d1e8088252fce9def380fa33eef1171f9bf01dcdfaa10688f2ef35fdb95a3e/modelcontextprotocol/python-sdk/issues/3601 |
| og:image:alt | Initial Checks I confirm that I'm using the newest release of my line (the latest 2.x, or the latest 1.x if I'm still on v1) I confirm that I searched for my issue in https://github.com/modelcontex... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | pablozamudio |
| hostname | github.com |
| expected-hostname | github.com |
| None | cc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c |
| turbo-cache-control | no-preview |
| go-import | github.com/modelcontextprotocol/python-sdk git https://github.com/modelcontextprotocol/python-sdk.git |
| octolytics-dimension-user_id | 182288589 |
| octolytics-dimension-user_login | modelcontextprotocol |
| octolytics-dimension-repository_id | 862584018 |
| octolytics-dimension-repository_nwo | modelcontextprotocol/python-sdk |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 862584018 |
| octolytics-dimension-repository_network_root_nwo | modelcontextprotocol/python-sdk |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8c77c9e8439031ad54c75a250694842892f693e1 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width