René's URL Explorer Experiment


Title: Add subject and claims to AccessToken by maxisbey · Pull Request #2686 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: Add subject and claims to AccessToken by maxisbey · Pull Request #2686 · modelcontextprotocol/python-sdk

X Title: Add subject and claims to AccessToken by maxisbey · Pull Request #2686 · modelcontextprotocol/python-sdk

Description: Summary Adds optional subject and claims fields to AccessToken so token verifiers can surface the resource owner (sub) and any additional claims to request handlers, and adds subject to AuthorizationCode and RefreshToken so the value can be carried through code-for-token exchange and refresh. Context.subject exposes the value to tool and resource handlers. The simple-auth example is updated to thread the subject from login through the introspection response and back into the verifier. Closes #1038. Supersedes #2209 and #1517 — this combines #2209's subject + claims fields and Context.subject accessor with #1517's threading through the authorization-code flow and example verifier, and adds RefreshToken.subject which both were missing. Thanks to @thomasst, @yukuanj, and @shivama205 for the prior work. Motivation Request handlers often need to make decisions based on which end-user a token was issued for, not just which OAuth client. AccessToken previously carried only client_id. The other SDKs already expose this — Go's TokenInfo.UserID, C#'s ClaimsPrincipal — and the claims dict gives an extension point for iss, act, and deployment-specific values without further model changes. Test plan Model tests for all three types covering defaults and populated values Context.subject tests covering authenticated / unauthenticated / no-subject Full suite, ruff, pyright clean Breaking changes None. All new fields are optional with None defaults. AI Disclaimer

Open Graph Description: Summary Adds optional subject and claims fields to AccessToken so token verifiers can surface the resource owner (sub) and any additional claims to request handlers, and adds subject to Authorizati...

X Description: Summary Adds optional subject and claims fields to AccessToken so token verifiers can surface the resource owner (sub) and any additional claims to request handlers, and adds subject to Authorizati...

Opengraph URL: https://github.com/modelcontextprotocol/python-sdk/pull/2686

X: @github

direct link

Domain: github.com

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/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:ea4ae16e-9220-86a2-96fb-7d69028ebd67
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-id91F4:B5F60:3B7CFA:525FD9:6AFD1223
html-safe-noncecb214be99505a7c1994ca525900fa62325decfa23d93d91e79dcf91d572798f8
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5MUY0OkI1RjYwOjNCN0NGQTo1MjVGRDk6NkFGRDEyMjMiLCJ2aXNpdG9yX2lkIjoiNzI2Mzk0NzA2NDE2ODIyMzI2OCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac1506a88627f42adad0776aea0d613477fe200bb66c9620117610ccfdd620585b
hovercard-subject-tagpull_request:3747314127
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/modelcontextprotocol/python-sdk/pull/2686/files
twitter:imagehttps://avatars.githubusercontent.com/u/224885523?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/224885523?s=400&v=4
og:image:altSummary Adds optional subject and claims fields to AccessToken so token verifiers can surface the resource owner (sub) and any additional claims to request handlers, and adds subject to Authorizati...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None7c34e25df4e46e972c8f0225e63410231bdeb9ea5634597c712796bbcdb2e627
turbo-cache-controlno-preview
diff-viewunified
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 full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release8fa571ebaa95e4e6bf872197c0e84b7dc48e6785
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F2686%2Ffiles
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%2Fpull%2F2686%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=modelcontextprotocol%2Fpython-sdk
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files
modelcontextprotocolhttps://github.com/modelcontextprotocol
python-sdkhttps://github.com/modelcontextprotocol/python-sdk
Codehttps://github.com/modelcontextprotocol/python-sdk
Issues306 (306)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
Sign up for GitHub https://github.com/signup?return_to=%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2Fnew%2Fchoose
maxisbeyhttps://github.com/maxisbey
mainhttps://github.com/modelcontextprotocol/python-sdk/tree/main
auth-access-token-subjecthttps://github.com/modelcontextprotocol/python-sdk/tree/auth-access-token-subject
Conversation 10 https://github.com/modelcontextprotocol/python-sdk/pull/2686
Commits 4 https://github.com/modelcontextprotocol/python-sdk/pull/2686/commits
Checks 60 https://github.com/modelcontextprotocol/python-sdk/pull/2686/checks
Files changed https://github.com/modelcontextprotocol/python-sdk/pull/2686/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files
Add subject and claims to AccessToken https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#top
Show all changes 4 commits https://github.com/modelcontextprotocol/python-sdk/pull/2686/files
c4fe4d2 Add subject and claims to AccessToken maxisbey May 22, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/2686/commits/c4fe4d254aeb7d1a502e9a805a900869ab73219a
7e542e9 Clarify subject docstrings and add Context.claims maxisbey May 26, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/2686/commits/7e542e9c64a4bd03e99e2ac19c6f02159900ab3c
4185d1c Scope down to model fields and add subject to auth integration test maxisbey May 26, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/2686/commits/4185d1c3b8fadc1895679463d4693fce24025565
a857cfc Address review: iss in introspection, tighten field comments maxisbey May 26, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/2686/commits/a857cfc25ff0eae9d92bc45c7d76af371a325c48
Clear filters https://github.com/modelcontextprotocol/python-sdk/pull/2686/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files
auth_server.py https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-1923b3db33049224b57ac8bf6131919e088dd382ebaa61902f49ce6d601b7899
simple_auth_provider.py https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-41a606ab858c2ba47b880a5f09e15157ee945ab71c528227e29e368616d84d47
token_verifier.py https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-488377b765d8b32e8e5fb73fa28dec511790c79066d63d37b2e18d85ee5ef19d
provider.py https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-f7e852ad288ea2750460eb8e8ef0d6152216cd97ae505acd5f06146cf866abec
context.py https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-b8a980ea2822cbd7a2f938f77b794ef9df6724acb5d637fdf87c0ad2bfe2db1a
test_auth_integration.py https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
examples/servers/simple-auth/mcp_simple_auth/auth_server.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-1923b3db33049224b57ac8bf6131919e088dd382ebaa61902f49ce6d601b7899
View file https://github.com/modelcontextprotocol/python-sdk/blob/a857cfc25ff0eae9d92bc45c7d76af371a325c48/examples/servers/simple-auth/mcp_simple_auth/auth_server.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2686/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-1923b3db33049224b57ac8bf6131919e088dd382ebaa61902f49ce6d601b7899
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-1923b3db33049224b57ac8bf6131919e088dd382ebaa61902f49ce6d601b7899
examples/servers/simple-auth/mcp_simple_auth/simple_auth_provider.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-41a606ab858c2ba47b880a5f09e15157ee945ab71c528227e29e368616d84d47
View file https://github.com/modelcontextprotocol/python-sdk/blob/a857cfc25ff0eae9d92bc45c7d76af371a325c48/examples/servers/simple-auth/mcp_simple_auth/simple_auth_provider.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2686/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-41a606ab858c2ba47b880a5f09e15157ee945ab71c528227e29e368616d84d47
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-41a606ab858c2ba47b880a5f09e15157ee945ab71c528227e29e368616d84d47
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-41a606ab858c2ba47b880a5f09e15157ee945ab71c528227e29e368616d84d47
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-41a606ab858c2ba47b880a5f09e15157ee945ab71c528227e29e368616d84d47
examples/servers/simple-auth/mcp_simple_auth/token_verifier.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-488377b765d8b32e8e5fb73fa28dec511790c79066d63d37b2e18d85ee5ef19d
View file https://github.com/modelcontextprotocol/python-sdk/blob/a857cfc25ff0eae9d92bc45c7d76af371a325c48/examples/servers/simple-auth/mcp_simple_auth/token_verifier.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2686/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-488377b765d8b32e8e5fb73fa28dec511790c79066d63d37b2e18d85ee5ef19d
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-488377b765d8b32e8e5fb73fa28dec511790c79066d63d37b2e18d85ee5ef19d
src/mcp/server/auth/provider.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-f7e852ad288ea2750460eb8e8ef0d6152216cd97ae505acd5f06146cf866abec
View file https://github.com/modelcontextprotocol/python-sdk/blob/a857cfc25ff0eae9d92bc45c7d76af371a325c48/src/mcp/server/auth/provider.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2686/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-f7e852ad288ea2750460eb8e8ef0d6152216cd97ae505acd5f06146cf866abec
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-f7e852ad288ea2750460eb8e8ef0d6152216cd97ae505acd5f06146cf866abec
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-f7e852ad288ea2750460eb8e8ef0d6152216cd97ae505acd5f06146cf866abec
src/mcp/server/mcpserver/context.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-b8a980ea2822cbd7a2f938f77b794ef9df6724acb5d637fdf87c0ad2bfe2db1a
View file https://github.com/modelcontextprotocol/python-sdk/blob/a857cfc25ff0eae9d92bc45c7d76af371a325c48/src/mcp/server/mcpserver/context.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2686/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-b8a980ea2822cbd7a2f938f77b794ef9df6724acb5d637fdf87c0ad2bfe2db1a
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-b8a980ea2822cbd7a2f938f77b794ef9df6724acb5d637fdf87c0ad2bfe2db1a
tests/server/mcpserver/auth/test_auth_integration.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
View file https://github.com/modelcontextprotocol/python-sdk/blob/a857cfc25ff0eae9d92bc45c7d76af371a325c48/tests/server/mcpserver/auth/test_auth_integration.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2686/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
https://github.com/modelcontextprotocol/python-sdk/pull/2686/files#diff-5a81a6a5148119d275223ade78614223f48f68203d1ef375fb1b271621d5894c
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2686/files
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.