René's URL Explorer Experiment


Title: Resolve tool output-schema references within the schema document only by maxisbey · Pull Request #3394 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: Resolve tool output-schema references within the schema document only by maxisbey · Pull Request #3394 · modelcontextprotocol/python-sdk

X Title: Resolve tool output-schema references within the schema document only by maxisbey · Pull Request #3394 · modelcontextprotocol/python-sdk

Description: Builds the client's output-schema validator with an explicit empty referencing.Registry, so $refs in a tool's outputSchema resolve within that schema and the bundled metaschemas, per the 2026-07-28 spec's $ref resolution section. A reference that doesn't resolve there now surfaces from call_tool as the RuntimeError that validate_tool_result documents. Motivation and Context Spec conformance for the structuredContent validation path. referencing.Registry() is jsonschema's documented configuration point for reference resolution, and jsonschema merges its bundled metaschemas into any registry it is given, so #/$defs/…, draft-07 #/definitions/…, $anchor, embedded $id resources and $refs to the standard metaschema URIs resolve exactly as before. Passing registry= also matches typeshed's Validator.__init__, which lets the old cast go. How Has This Been Tested? New test in tests/client/test_output_schema_validation.py through in-memory Client(server); the existing recursive-$defs test (test_recursive_tool_return_type_lists_and_calls_on_legacy_session) covers in-document references. Full suite, coverage, pyright and ruff clean locally. Breaking Changes No API changes. A result whose validation reaches a $ref outside the schema document now fails with RuntimeError: Invalid schema for tool : …, and a dangling in-document $ref surfaces as that same RuntimeError rather than a referencing exception, matching the documented contract. Types of changes Bug fix (non-breaking change which fixes an issue) New feature (non-breaking change which adds functionality) Breaking change (fix or feature that would cause existing functionality to change) Documentation update Checklist I have read the MCP Documentation My code follows the repository's style guidelines New and existing tests pass locally I have added appropriate error handling I have added or updated documentation as needed Additional context referencing is jsonschema's own dependency and the type of its registry= parameter; it is imported directly, the same way pydantic_core already is. The one + … # pyright: ignore[reportUnknownMemberType] in the diff is the existing suppression on best_match, re-indented into the try. AI Disclaimer

Open Graph Description: Builds the client's output-schema validator with an explicit empty referencing.Registry, so $refs in a tool's outputSchema resolve within that schema and the bundled metaschemas, per the 20...

X Description: Builds the client's output-schema validator with an explicit empty referencing.Registry, so $refs in a tool's outputSchema resolve within that schema and the bundled metaschemas, pe...

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

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:b313b389-2743-b6b2-7dc3-69153add4d5e
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idDFAA:D0E46:2F483D:3FDA9D:6B00C40F
html-safe-noncea391482579d1465257cf30acfecd91324d3e9da23777e101e1aff4aa310a0086
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJERkFBOkQwRTQ2OjJGNDgzRDozRkRBOUQ6NkIwMEM0MEYiLCJ2aXNpdG9yX2lkIjoiMjU1MjI5NjI3MDMzNzE5NzA3MSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac8c5f089bf9bb22fbb7bfa99b798162afa644489e643336b223ab3bf2e2977129
hovercard-subject-tagpull_request:4366468707
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/3394/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:altBuilds the client's output-schema validator with an explicit empty referencing.Registry, so $refs in a tool's outputSchema resolve within that schema and the bundled metaschemas, per the 20...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None93edd3bebc4afb7ce711ee74cb5d2a95927850b082a4d43e212222389cb1c415
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
release1fee81a280ea86312b69448e261b418189bfd5b5
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F3394%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%2F3394%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/3394/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files
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
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
local-ref-resolutionhttps://github.com/modelcontextprotocol/python-sdk/tree/local-ref-resolution
Conversation 3 https://github.com/modelcontextprotocol/python-sdk/pull/3394
Commits 1 https://github.com/modelcontextprotocol/python-sdk/pull/3394/commits
Checks 38 https://github.com/modelcontextprotocol/python-sdk/pull/3394/checks
Files changed https://github.com/modelcontextprotocol/python-sdk/pull/3394/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files
Resolve tool output-schema references within the schema document only https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#top
Show all changes 1 commit https://github.com/modelcontextprotocol/python-sdk/pull/3394/files
1a69105 Resolve tool output-schema references within the schema document only maxisbey Aug 26, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3394/commits/1a69105b4ad58b484ca9e48be1413800b96d0cf3
Clear filters https://github.com/modelcontextprotocol/python-sdk/pull/3394/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files
session.py https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-634d1abcb8bda1a784f31e3431a10124e387f487dd243a54244515b4972aa0ee
test_output_schema_validation.py https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-dc75f269f6db41a54ac1f7e6c770c679e7c44ebc8f9b87a8d14a037c28754f64
src/mcp/client/session.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-634d1abcb8bda1a784f31e3431a10124e387f487dd243a54244515b4972aa0ee
View file https://github.com/modelcontextprotocol/python-sdk/blob/1a69105b4ad58b484ca9e48be1413800b96d0cf3/src/mcp/client/session.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3394/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-634d1abcb8bda1a784f31e3431a10124e387f487dd243a54244515b4972aa0ee
claudehttps://github.com/apps/claude
Aug 26, 2026https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#r3862739564
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files
https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-634d1abcb8bda1a784f31e3431a10124e387f487dd243a54244515b4972aa0ee
https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-634d1abcb8bda1a784f31e3431a10124e387f487dd243a54244515b4972aa0ee
https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-634d1abcb8bda1a784f31e3431a10124e387f487dd243a54244515b4972aa0ee
https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-634d1abcb8bda1a784f31e3431a10124e387f487dd243a54244515b4972aa0ee
tests/client/test_output_schema_validation.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-dc75f269f6db41a54ac1f7e6c770c679e7c44ebc8f9b87a8d14a037c28754f64
View file https://github.com/modelcontextprotocol/python-sdk/blob/1a69105b4ad58b484ca9e48be1413800b96d0cf3/tests/client/test_output_schema_validation.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3394/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-dc75f269f6db41a54ac1f7e6c770c679e7c44ebc8f9b87a8d14a037c28754f64
https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-dc75f269f6db41a54ac1f7e6c770c679e7c44ebc8f9b87a8d14a037c28754f64
https://github.com/modelcontextprotocol/python-sdk/pull/3394/files#diff-dc75f269f6db41a54ac1f7e6c770c679e7c44ebc8f9b87a8d14a037c28754f64
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3394/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.