René's URL Explorer Experiment


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

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@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-profiling0
react-import-mapreact,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-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:cc7409e1-1bb6-583d-9d54-5df8a55e399c
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-id8162:3CBB3E:8358F9:A68C83:6B012185
html-safe-nonced4b2fa948ee86340aec228d124272970891d033e200ad40ee2e4c63128851110
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4MTYyOjNDQkIzRTo4MzU4Rjk6QTY4QzgzOjZCMDEyMTg1IiwidmlzaXRvcl9pZCI6IjEwNTM2NzMwNDk5Mzg3OTY5MzMiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac65dbca23dfa6dfc169af213cc8b37e3cbacbf5f5177f94ae905e09e19923b543
hovercard-subject-tagissue:5652111879
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/modelcontextprotocol/python-sdk/3601/issue_layout
twitter:imagehttps://opengraph.githubassets.com/54d1e8088252fce9def380fa33eef1171f9bf01dcdfaa10688f2ef35fdb95a3e/modelcontextprotocol/python-sdk/issues/3601
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/54d1e8088252fce9def380fa33eef1171f9bf01dcdfaa10688f2ef35fdb95a3e/modelcontextprotocol/python-sdk/issues/3601
og:image:altInitial 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:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamepablozamudio
hostnamegithub.com
expected-hostnamegithub.com
Nonecc5dfdd32f62ebd3223cab3af3aa2b268d3605218237326a48a99d1efd89495c
turbo-cache-controlno-preview
go-importgithub.com/modelcontextprotocol/python-sdk git https://github.com/modelcontextprotocol/python-sdk.git
octolytics-dimension-user_id182288589
octolytics-dimension-user_loginmodelcontextprotocol
octolytics-dimension-repository_id862584018
octolytics-dimension-repository_nwomodelcontextprotocol/python-sdk
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id862584018
octolytics-dimension-repository_network_root_nwomodelcontextprotocol/python-sdk
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release8c77c9e8439031ad54c75a250694842892f693e1
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/issues/3601#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2F3601
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2F3601
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=modelcontextprotocol%2Fpython-sdk
Reloadhttps://github.com/modelcontextprotocol/python-sdk/issues/3601
Reloadhttps://github.com/modelcontextprotocol/python-sdk/issues/3601
Reloadhttps://github.com/modelcontextprotocol/python-sdk/issues/3601
modelcontextprotocolhttps://github.com/modelcontextprotocol
python-sdkhttps://github.com/modelcontextprotocol/python-sdk
Codehttps://github.com/modelcontextprotocol/python-sdk
Issues310 (310)https://github.com/modelcontextprotocol/python-sdk/issues
Pull requests112 (112)https://github.com/modelcontextprotocol/python-sdk/pulls
Actionshttps://github.com/modelcontextprotocol/python-sdk/actions
Projectshttps://github.com/modelcontextprotocol/python-sdk/projects
Security and quality12 (12)https://github.com/modelcontextprotocol/python-sdk/security
Insightshttps://github.com/modelcontextprotocol/python-sdk/insights
https://github.com/modelcontextprotocol/python-sdk
New issuehttps://github.com/login?return_to=https://github.com/modelcontextprotocol/python-sdk/issues/3601
New issuehttps://github.com/login?return_to=https://github.com/modelcontextprotocol/python-sdk/issues/3601
#3635https://github.com/modelcontextprotocol/python-sdk/pull/3635
Client(mode="auto") falls back to legacy when interactive OAuth exceeds the fixed server/discover timeouthttps://github.com/modelcontextprotocol/python-sdk/issues/3601#top
#3635https://github.com/modelcontextprotocol/python-sdk/pull/3635
spec-2026-07-28Concerns the SDK's implementation of the 2026-07-28 MCP spec revisionhttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22spec-2026-07-28%22
v2Affects the v2 line (2.x on main)https://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22v2%22
https://github.com/pablozamudio
pablozamudiohttps://github.com/pablozamudio
on Sep 30, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3601#issue-5652111879
https://github.com/modelcontextprotocol/python-sdk/issueshttps://github.com/modelcontextprotocol/python-sdk/issues
claudehttps://github.com/apps/claude
v2Affects the v2 line (2.x on main)https://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22v2%22
spec-2026-07-28Concerns the SDK's implementation of the 2026-07-28 MCP spec revisionhttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22spec-2026-07-28%22
on Sep 30, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3601#event-32199587348
https://github.com/Ben-Home
Ben-Homehttps://github.com/Ben-Home
on Sep 30, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3601#issuecomment-5921205375
https://github.com/HarshXAI
HarshXAIhttps://github.com/HarshXAI
on Oct 1, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3601#issuecomment-5926555506
https://github.com/BenRobinson-hub
BenRobinson-hubhttps://github.com/BenRobinson-hub
on Oct 1, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3601#issuecomment-5926855203
ChatGPT Codex Connectorhttps://www.chatgpt.com
@HarshXAIhttps://github.com/HarshXAI
https://github.com/Jaswanth1902
Jaswanth1902https://github.com/Jaswanth1902
on Oct 2, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3601#issuecomment-5946045503
maxisbeyhttps://github.com/maxisbey
completedhttps://github.com/modelcontextprotocol/python-sdk/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
#3635https://github.com/modelcontextprotocol/python-sdk/pull/3635
on Oct 2, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3601#event-32367474981
Sign up for freehttps://github.com/signup?return_to=https://github.com/modelcontextprotocol/python-sdk/issues/3601
Sign in to commenthttps://github.com/login?return_to=https://github.com/modelcontextprotocol/python-sdk/issues/3601
spec-2026-07-28Concerns the SDK's implementation of the 2026-07-28 MCP spec revisionhttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22spec-2026-07-28%22
v2Affects the v2 line (2.x on main)https://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22v2%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.