René's URL Explorer Experiment


Title: Fix Pydantic field alias consistency in structured output by sjwhole · Pull Request #1099 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: Fix Pydantic field alias consistency in structured output by sjwhole · Pull Request #1099 · modelcontextprotocol/python-sdk

X Title: Fix Pydantic field alias consistency in structured output by sjwhole · Pull Request #1099 · modelcontextprotocol/python-sdk

Description: Fix Pydantic field alias consistency in structured output Summary Fixes issue #1073. Fix inconsistency between schema and structured output when using Pydantic models with field aliases in tool return types. The schema would display aliased field names but the actual output would use original field names. Motivation and Context When defining Pydantic models with field aliases for tool return types, there was an inconsistency where: The output schema would correctly show aliased field names (e.g., "first", "second") The actual structured tool output would use the original field names (e.g., "field_first", "field_second") This inconsistency made it difficult for clients to reliably consume structured tool outputs, as the field names in the schema didn't match the actual response data. How Has This Been Tested? Added comprehensive test case test_structured_output_aliases() that verifies both schema generation and output use consistent alias names All existing pytest tests continue to pass Breaking Changes No breaking changes. This is a bug fix that makes the behavior consistent with what the schema advertises. Users who were working around this inconsistency may need to update their code to use the aliased field names consistently. 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 The fix was a simple one-line change adding by_alias=True to the model_dump() call in func_metadata.py:114. This ensures that when Pydantic models are serialized for structured output, they use the same field names that appear in the generated JSON schema. The test case covers both the schema generation and the actual output conversion to ensure they remain consistent. This addresses the core issue described in the original bug report where the schema and output used different field naming conventions. Technical Details Before the fix: class Foo(BaseModel): field_first: str | None = Field(default=None, alias="first", description="The first field.") field_second: str | None = Field(default=None, alias="second", description="The second field.") Schema would show: "first" and "second" Output would contain: "field_first" and "field_second" After the fix: Both schema and output consistently use: "first" and "second" Code change: # Before structured_content = validated.model_dump(mode="json") # After structured_content = validated.model_dump(mode="json", by_alias=True)

Open Graph Description: Fix Pydantic field alias consistency in structured output Summary Fixes issue #1073. Fix inconsistency between schema and structured output when using Pydantic models with field aliases in tool ret...

X Description: Fix Pydantic field alias consistency in structured output Summary Fixes issue #1073. Fix inconsistency between schema and structured output when using Pydantic models with field aliases in tool ret...

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

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:5fe913cb-4610-0e91-c8a2-99b766c078a9
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idE1B6:2D96F1:BA4109:F82AAF:6B00F0EB
html-safe-nonce76a5669e3c862d42b362a9b012709c5b6b8d422f2549da8b4050e6e1ecdd1b7f
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFMUI2OjJEOTZGMTpCQTQxMDk6RjgyQUFGOjZCMDBGMEVCIiwidmlzaXRvcl9pZCI6IjI2Nzc3NDgwODYwNTAxODk1NDciLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmacdf5556dc91cccec708743e79b90d2461cf906108d355f11cdfdd2254255ec480
hovercard-subject-tagpull_request:2645951794
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/1099/files
twitter:imagehttps://avatars.githubusercontent.com/u/66054861?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/66054861?s=400&v=4
og:image:altFix Pydantic field alias consistency in structured output Summary Fixes issue #1073. Fix inconsistency between schema and structured output when using Pydantic models with field aliases in tool ret...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None4ef498cbabcbe3c50befc7a5b743e7072ee770b4daf0e15e54801180d1fa91fc
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
release9983dd5da06943f833c971dd5b6bc988e2858be5
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/pull/1099/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F1099%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%2F1099%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/1099/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/1099/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/1099/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
ihrprhttps://github.com/ihrpr
modelcontextprotocol:mainhttps://github.com/modelcontextprotocol/python-sdk/tree/main
sjwhole:fix/pydantic-alias-consistencyhttps://github.com/sjwhole/python-sdk/tree/fix/pydantic-alias-consistency
Conversation 3 https://github.com/modelcontextprotocol/python-sdk/pull/1099
Commits 2 https://github.com/modelcontextprotocol/python-sdk/pull/1099/commits
Checks 0 https://github.com/modelcontextprotocol/python-sdk/pull/1099/checks
Files changed https://github.com/modelcontextprotocol/python-sdk/pull/1099/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1099/files
Fix Pydantic field alias consistency in structured output https://github.com/modelcontextprotocol/python-sdk/pull/1099/files#top
Show all changes 2 commits https://github.com/modelcontextprotocol/python-sdk/pull/1099/files
c5c8a68 Fix Pydantic field alias consistency in structured output sjwhole Jul 7, 2025 https://github.com/modelcontextprotocol/python-sdk/pull/1099/commits/c5c8a68a386798a3a9464e3ad3a0bd6bee923bfb
a8e43ee Add test case for Pydantic field alias consistency sjwhole Jul 7, 2025 https://github.com/modelcontextprotocol/python-sdk/pull/1099/commits/a8e43eebf6f8bc109f0795eb510fd74fddb963fc
Clear filters https://github.com/modelcontextprotocol/python-sdk/pull/1099/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1099/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1099/files
func_metadata.py https://github.com/modelcontextprotocol/python-sdk/pull/1099/files#diff-7ab569bc3087a1aab22a2cac2a25598f907b2faa0d83708b7b8eaf04218bbebe
test_func_metadata.py https://github.com/modelcontextprotocol/python-sdk/pull/1099/files#diff-28100164bc341b35cebdebdebcd004bacade502fd869fc6f8cb546e3d1d0238d
src/mcp/server/fastmcp/utilities/func_metadata.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/1099/files#diff-7ab569bc3087a1aab22a2cac2a25598f907b2faa0d83708b7b8eaf04218bbebe
View file https://github.com/sjwhole/python-sdk/blob/a8e43eebf6f8bc109f0795eb510fd74fddb963fc/src/mcp/server/fastmcp/utilities/func_metadata.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/1099/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/1099/files#diff-7ab569bc3087a1aab22a2cac2a25598f907b2faa0d83708b7b8eaf04218bbebe
https://github.com/modelcontextprotocol/python-sdk/pull/1099/files#diff-7ab569bc3087a1aab22a2cac2a25598f907b2faa0d83708b7b8eaf04218bbebe
tests/server/fastmcp/test_func_metadata.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/1099/files#diff-28100164bc341b35cebdebdebcd004bacade502fd869fc6f8cb546e3d1d0238d
View file https://github.com/sjwhole/python-sdk/blob/a8e43eebf6f8bc109f0795eb510fd74fddb963fc/tests/server/fastmcp/test_func_metadata.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/1099/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/1099/files#diff-28100164bc341b35cebdebdebcd004bacade502fd869fc6f8cb546e3d1d0238d
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.