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
Domain: github.com
{"@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-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:d7b44c1e-75b1-d615-3392-8c04f63607cd |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 858C:34EA7D:167791:1D95FD:6B00BC6B |
| html-safe-nonce | bbc3bc9bfd3811022beecaee76b77b7a991eba29123fd41def3adb170bf7abc0 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4NThDOjM0RUE3RDoxNjc3OTE6MUQ5NUZEOjZCMDBCQzZCIiwidmlzaXRvcl9pZCI6IjExNjExODI5MTAzNTU2NTE2OTEiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | 82b8fec2c834bec0f35c383494693f7b4484ae7284b8a9a09ec613a745b3be89 |
| hovercard-subject-tag | issue:5888071509 |
| 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/3720/issue_layout |
| twitter:image | https://opengraph.githubassets.com/fc9f3d05786b16efe3477cec80d033e8bc543bfa9e0bb1913c00b14cb939f9a7/modelcontextprotocol/python-sdk/issues/3720 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/fc9f3d05786b16efe3477cec80d033e8bc543bfa9e0bb1913c00b14cb939f9a7/modelcontextprotocol/python-sdk/issues/3720 |
| og:image:alt | 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 ... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | mwolffobs |
| hostname | github.com |
| expected-hostname | github.com |
| None | 1d07c25977adfc5ff6acb0a962a9bc168c07afbda6fef765f9761c350c2ae4a2 |
| 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 | 5429cbfc6aca8c7b9a086a3c8f47400346f38cc9 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width