René's URL Explorer Experiment


Title: Token handler drops RFC 8707 resource on refresh_token (and authorization_code) grants; provider can't see it · Issue #3720 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: Token handler drops RFC 8707 resource on refresh_token (and authorization_code) grants; provider can't see it · Issue #3720 · modelcontextprotocol/python-sdk

X Title: Token handler drops RFC 8707 resource on refresh_token (and authorization_code) grants; provider can't see it · Issue #3720 · modelcontextprotocol/python-sdk

Description: Initial Checks I confirm that I'm using the newest release of my line (checked on v2.3.0) I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue Release line 2.x (cur...

Open Graph Description: Initial Checks I confirm that I'm using the newest release of my line (checked on v2.3.0) I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before ...

X Description: Initial Checks I confirm that I'm using the newest release of my line (checked on v2.3.0) I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues bef...

Opengraph URL: https://github.com/modelcontextprotocol/python-sdk/issues/3720

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Token handler drops RFC 8707 resource on refresh_token (and authorization_code) grants; provider can't see it","articleBody":"### Initial Checks\n\n- [x] I confirm that I'm using the newest release of my line (checked on v2.3.0)\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\nThe token handler parses the RFC 8707 `resource` parameter on a `refresh_token` grant but never passes it to the provider, and `OAuthAuthorizationServerProvider.exchange_refresh_token` has no way to receive it.\n\n- `RefreshTokenRequest` declares `resource` ([handlers/token.py#L36-L45](https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/handlers/token.py#L36-L45)).\n- The refresh branch calls `self.provider.exchange_refresh_token(client_info, refresh_token, scopes)` and drops `token_request.resource` ([L238](https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/handlers/token.py#L238)).\n- `exchange_refresh_token(self, client, refresh_token, scopes)` has no resource parameter ([provider.py#L259-L264](https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/provider.py#L259-L264)).\n- The JWT bearer branch does forward it (`resource=token_request.resource`, [L268](https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/handlers/token.py#L268)).\n\nSo an authorization server built on the SDK can't apply RFC 8707 §2.2 on refresh (\"such policy may limit the acceptable resources to those that were originally granted by the resource owner or a subset thereof\") or answer a mismatched resource with `invalid_target`. The MCP authorization spec requires clients to send `resource` in token requests, so the value is always there; the provider just can't see it. #3447 added `RefreshToken.resource` so the granted resource can be stored, but there is still nothing to compare it with.\n\nThe same applies to the `authorization_code` grant: the handler doesn't compare `token_request.resource` with `AuthorizationCode.resource` and doesn't pass it to `exchange_authorization_code` ([L200](https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/handlers/token.py#L200)), so a mismatch is accepted silently.\n\nFor comparison, the TypeScript SDK's token handler passes `resource` to `exchangeRefreshToken` and to the authorization code exchange.\n\nToday the only workaround is to subclass `TokenHandler` and hand the form value to the provider out of band.\n\n**Expected:** the provider can see the requested resource on both grants. One backwards-compatible option is an optional `resource: str | None = None` argument on `exchange_refresh_token` and `exchange_authorization_code` (or a params object, as the JWT bearer path does). Optionally, the handler could itself return `invalid_target` when `resource` is sent and differs from `refresh_token.resource` / `auth_code.resource`.\n\n### Example Code\n\n```Python\nclass Provider(OAuthAuthorizationServerProvider[AuthorizationCode, RefreshToken, AccessToken]):\n    async def exchange_refresh_token(\n        self, client: OAuthClientInformationFull, refresh_token: RefreshToken, scopes: list[str]\n    ) -> OAuthToken:\n        # POST /token\n        #   grant_type=refresh_token&refresh_token=...&resource=https://other.example/mcp\n        # The requested resource is not available here, so the provider can't refuse it\n        # with invalid_target or check it against refresh_token.resource.\n        ...\n```\n\n### Python & MCP Python SDK\n\n```Text\nPython 3.12.12\nmcp v2.3.0\n```\n","author":{"url":"https://github.com/mwolffobs","@type":"Person","name":"mwolffobs"},"datePublished":"2026-10-16T17:01:43Z","url":"https://github.com/modelcontextprotocol/python-sdk/issues/3720"}

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:d7b44c1e-75b1-d615-3392-8c04f63607cd
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-id858C:34EA7D:167791:1D95FD:6B00BC6B
html-safe-noncebbc3bc9bfd3811022beecaee76b77b7a991eba29123fd41def3adb170bf7abc0
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4NThDOjM0RUE3RDoxNjc3OTE6MUQ5NUZEOjZCMDBCQzZCIiwidmlzaXRvcl9pZCI6IjExNjExODI5MTAzNTU2NTE2OTEiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac82b8fec2c834bec0f35c383494693f7b4484ae7284b8a9a09ec613a745b3be89
hovercard-subject-tagissue:5888071509
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/3720/issue_layout
twitter:imagehttps://opengraph.githubassets.com/fc9f3d05786b16efe3477cec80d033e8bc543bfa9e0bb1913c00b14cb939f9a7/modelcontextprotocol/python-sdk/issues/3720
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/fc9f3d05786b16efe3477cec80d033e8bc543bfa9e0bb1913c00b14cb939f9a7/modelcontextprotocol/python-sdk/issues/3720
og:image:altInitial Checks I confirm that I'm using the newest release of my line (checked on v2.3.0) I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before ...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamemwolffobs
hostnamegithub.com
expected-hostnamegithub.com
None1d07c25977adfc5ff6acb0a962a9bc168c07afbda6fef765f9761c350c2ae4a2
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
release5429cbfc6aca8c7b9a086a3c8f47400346f38cc9
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/issues/3720#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2F3720
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%2F3720
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/3720
Reloadhttps://github.com/modelcontextprotocol/python-sdk/issues/3720
Reloadhttps://github.com/modelcontextprotocol/python-sdk/issues/3720
modelcontextprotocolhttps://github.com/modelcontextprotocol
python-sdkhttps://github.com/modelcontextprotocol/python-sdk
Codehttps://github.com/modelcontextprotocol/python-sdk
Issues308 (308)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/3720
New issuehttps://github.com/login?return_to=https://github.com/modelcontextprotocol/python-sdk/issues/3720
Token handler drops RFC 8707 resource on refresh_token (and authorization_code) grants; provider can't see ithttps://github.com/modelcontextprotocol/python-sdk/issues/3720#top
bugSomething isn't workinghttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22bug%22
v1Affects the v1.x maintenance linehttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22v1%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/mwolffobs
mwolffobshttps://github.com/mwolffobs
on Oct 16, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3720#issue-5888071509
https://github.com/modelcontextprotocol/python-sdk/issueshttps://github.com/modelcontextprotocol/python-sdk/issues
handlers/token.py#L36-L45https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/handlers/token.py#L36-L45
L238https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/handlers/token.py#L238
provider.py#L259-L264https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/provider.py#L259-L264
L268https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/handlers/token.py#L268
#3447https://github.com/modelcontextprotocol/python-sdk/pull/3447
L200https://github.com/modelcontextprotocol/python-sdk/blob/v2.3.0/src/mcp/server/auth/handlers/token.py#L200
claudehttps://github.com/apps/claude
bugSomething isn't workinghttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22bug%22
v2Affects the v2 line (2.x on main)https://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22v2%22
v1Affects the v1.x maintenance linehttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22v1%22
on Oct 16, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3720#event-33468732240
https://github.com/sattyamjjain
sattyamjjainhttps://github.com/sattyamjjain
on Oct 17, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3720#issuecomment-6231206205
https://github.com/anhdoox
anhdooxhttps://github.com/anhdoox
on Oct 21, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3720#issuecomment-6307249565
https://github.com/Ben-Home
Ben-Homehttps://github.com/Ben-Home
on Oct 21, 2026https://github.com/modelcontextprotocol/python-sdk/issues/3720#issuecomment-6315413588
Sign up for freehttps://github.com/signup?return_to=https://github.com/modelcontextprotocol/python-sdk/issues/3720
Sign in to commenthttps://github.com/login?return_to=https://github.com/modelcontextprotocol/python-sdk/issues/3720
bugSomething isn't workinghttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22bug%22
v1Affects the v1.x maintenance linehttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22v1%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.