René's URL Explorer Experiment


Title: Consistent JSON forward/backward compatibility (2.0 foundation) by chemicL · Pull Request #927 · modelcontextprotocol/java-sdk · GitHub

Open Graph Title: Consistent JSON forward/backward compatibility (2.0 foundation) by chemicL · Pull Request #927 · modelcontextprotocol/java-sdk

X Title: Consistent JSON forward/backward compatibility (2.0 foundation) by chemicL · Pull Request #927 · modelcontextprotocol/java-sdk

Description: The official Java SDK for Model Context Protocol servers and clients. Maintained in collaboration with Spring AI - Consistent JSON forward/backward compatibility (2.0 foundation) by chemicL · Pull Request #927 · modelcontextprotocol/java-sdk

Open Graph Description: Motivation and Context The MCP specification evolves continuously; domain types must absorb new fields and subtypes without breaking existing clients or servers. On the 1.x line this is structurall...

X Description: Motivation and Context The MCP specification evolves continuously; domain types must absorb new fields and subtypes without breaking existing clients or servers. On the 1.x line this is structurall...

Opengraph URL: https://github.com/modelcontextprotocol/java-sdk/pull/927

X: @github

direct link

Domain: github.com

route-pattern/_view_fragments/voltron/pull_requests/show/:user_id/:repository/:id/pull_request_layout(.:format)
route-controllervoltron_pull_requests_fragments
route-actionpull_request_layout
fetch-noncev2:cbb4df68-81e4-7da4-7fe3-1953503701e1
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idE530:269996:1BC1ED3:24A7B64:6A5C84BA
html-safe-nonce52b5736835f779310585d169cd47ec1f353c42fd9efc558651271e7e1fe31234
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFNTMwOjI2OTk5NjoxQkMxRUQzOjI0QTdCNjQ6NkE1Qzg0QkEiLCJ2aXNpdG9yX2lkIjoiNzQ1NzY4NzcwMDIzNTkxMjM3OCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac7e2a3bdd7fa6c4ec251592530b5eca73a0bcc92f6203d8749e19a307e5889b50
hovercard-subject-tagpull_request:3557214739
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///voltron/pull_requests_fragments/pull_request_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/voltron/pull_requests/show/modelcontextprotocol/java-sdk/927/pull_request_layout
twitter:imagehttps://opengraph.githubassets.com/a41e32205fb47f3209ee71581c907ba49d654feac4dd465a27c6b267625adfb2/modelcontextprotocol/java-sdk/pull/927
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/a41e32205fb47f3209ee71581c907ba49d654feac4dd465a27c6b267625adfb2/modelcontextprotocol/java-sdk/pull/927
og:image:altMotivation and Context The MCP specification evolves continuously; domain types must absorb new fields and subtypes without breaking existing clients or servers. On the 1.x line this is structurall...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamechemicL
hostnamegithub.com
expected-hostnamegithub.com
None5290d7e14309ad1e76106a9c4237bd1041517e83ea182c8ab756752cb0c6940b
turbo-cache-controlno-cache
go-importgithub.com/modelcontextprotocol/java-sdk git https://github.com/modelcontextprotocol/java-sdk.git
octolytics-dimension-user_id182288589
octolytics-dimension-user_loginmodelcontextprotocol
octolytics-dimension-repository_id919609219
octolytics-dimension-repository_nwomodelcontextprotocol/java-sdk
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id919609219
octolytics-dimension-repository_network_root_nwomodelcontextprotocol/java-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
release9c975978430e9ad293956f2bbdaf153b1bd84a99
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/modelcontextprotocol/java-sdk/pull/927#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fjava-sdk%2Fpull%2F927
GitHub CopilotWrite better code with AIhttps://github.com/features/copilot
GitHub Copilot appDirect agents from issue to mergehttps://github.com/features/ai/github-app
MCP RegistryNewIntegrate external toolshttps://github.com/mcp
ActionsAutomate any workflowhttps://github.com/features/actions
CodespacesInstant dev environmentshttps://github.com/features/codespaces
IssuesPlan and track workhttps://github.com/features/issues
Code ReviewManage code changeshttps://github.com/features/code-review
GitHub Advanced SecurityFind and fix vulnerabilitieshttps://github.com/security/advanced-security
Code securitySecure your code as you buildhttps://github.com/security/advanced-security/code-security
Secret protectionStop leaks before they starthttps://github.com/security/advanced-security/secret-protection
Why GitHubhttps://github.com/why-github
Documentationhttps://docs.github.com
Bloghttps://github.blog
Changeloghttps://github.blog/changelog
Marketplacehttps://github.com/marketplace
View all featureshttps://github.com/features
Enterpriseshttps://github.com/enterprise
Small and medium teamshttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
App Modernizationhttps://github.com/solutions/use-case/app-modernization
DevSecOpshttps://github.com/solutions/use-case/devsecops
DevOpshttps://github.com/solutions/use-case/devops
CI/CDhttps://github.com/solutions/use-case/ci-cd
View all use caseshttps://github.com/solutions/use-case
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
View all industrieshttps://github.com/solutions/industry
View all solutionshttps://github.com/solutions
AIhttps://github.com/resources/articles?topic=ai
Software Developmenthttps://github.com/resources/articles?topic=software-development
DevOpshttps://github.com/resources/articles?topic=devops
Securityhttps://github.com/resources/articles?topic=security
View all topicshttps://github.com/resources/articles
Customer storieshttps://github.com/customer-stories
Events & webinarshttps://github.com/resources/events
Ebooks & reportshttps://github.com/resources/whitepapers
Business insightshttps://github.com/solutions/executive-insights
GitHub Skillshttps://skills.github.com
Documentationhttps://docs.github.com
Customer supporthttps://support.github.com
Community forumhttps://github.com/orgs/community/discussions
Trust centerhttps://github.com/trust-center
Partnershttps://github.com/partners
View all resourceshttps://github.com/resources
GitHub SponsorsFund open source developershttps://github.com/open-source/sponsors
Security Labhttps://securitylab.github.com
Maintainer Communityhttps://maintainers.github.com
Acceleratorhttps://github.com/open-source/accelerator
GitHub Starshttps://stars.github.com
Archive Programhttps://archiveprogram.github.com
Topicshttps://github.com/topics
Trendinghttps://github.com/trending
Collectionshttps://github.com/collections
Enterprise platformAI-powered developer platformhttps://github.com/enterprise
GitHub Advanced SecurityEnterprise-grade security featureshttps://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
Pricinghttps://github.com/pricing
Search syntax tipshttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
documentationhttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fjava-sdk%2Fpull%2F927
Sign up https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fpull_requests_fragments%2Fpull_request_layout&source=header-repo&source_repo=modelcontextprotocol%2Fjava-sdk
Reloadhttps://github.com/modelcontextprotocol/java-sdk/pull/927
Reloadhttps://github.com/modelcontextprotocol/java-sdk/pull/927
Reloadhttps://github.com/modelcontextprotocol/java-sdk/pull/927
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
modelcontextprotocol https://github.com/modelcontextprotocol
java-sdkhttps://github.com/modelcontextprotocol/java-sdk
Notifications https://github.com/login?return_to=%2Fmodelcontextprotocol%2Fjava-sdk
Fork 977 https://github.com/login?return_to=%2Fmodelcontextprotocol%2Fjava-sdk
Star 3.6k https://github.com/login?return_to=%2Fmodelcontextprotocol%2Fjava-sdk
Code https://github.com/modelcontextprotocol/java-sdk
Issues 134 https://github.com/modelcontextprotocol/java-sdk/issues
Pull requests 147 https://github.com/modelcontextprotocol/java-sdk/pulls
Discussions https://github.com/modelcontextprotocol/java-sdk/discussions
Actions https://github.com/modelcontextprotocol/java-sdk/actions
Projects https://github.com/modelcontextprotocol/java-sdk/projects
Models https://github.com/modelcontextprotocol/java-sdk/models
Security and quality 2 https://github.com/modelcontextprotocol/java-sdk/security
Insights https://github.com/modelcontextprotocol/java-sdk/pulse
Code https://github.com/modelcontextprotocol/java-sdk
Issues https://github.com/modelcontextprotocol/java-sdk/issues
Pull requests https://github.com/modelcontextprotocol/java-sdk/pulls
Discussions https://github.com/modelcontextprotocol/java-sdk/discussions
Actions https://github.com/modelcontextprotocol/java-sdk/actions
Projects https://github.com/modelcontextprotocol/java-sdk/projects
Models https://github.com/modelcontextprotocol/java-sdk/models
Security and quality https://github.com/modelcontextprotocol/java-sdk/security
Insights https://github.com/modelcontextprotocol/java-sdk/pulse
chemicLhttps://github.com/chemicL
mainhttps://github.com/modelcontextprotocol/java-sdk/tree/main
json-compatibilityhttps://github.com/modelcontextprotocol/java-sdk/tree/json-compatibility
Conversationhttps://github.com/modelcontextprotocol/java-sdk/pull/927
Commits6 (6)https://github.com/modelcontextprotocol/java-sdk/pull/927/commits
Checkshttps://github.com/modelcontextprotocol/java-sdk/pull/927/checks
Files changedhttps://github.com/modelcontextprotocol/java-sdk/pull/927/files
Consistent JSON forward/backward compatibility (2.0 foundation)https://github.com/modelcontextprotocol/java-sdk/pull/927#top
chemicLhttps://github.com/chemicL
mainhttps://github.com/modelcontextprotocol/java-sdk/tree/main
json-compatibilityhttps://github.com/modelcontextprotocol/java-sdk/tree/json-compatibility
https://github.com/chemicL
chemicLhttps://github.com/chemicL
Apr 20, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#issue-4297241922
MCP Documentationhttps://modelcontextprotocol.io
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
chemicLhttps://github.com/chemicL
April 20, 2026 17:20https://github.com/modelcontextprotocol/java-sdk/pull/927#commits-pushed-4ca9935
https://github.com/chemicL
feat!: consistent JSON forward/backward compatibility (2.0 foundation)https://github.com/modelcontextprotocol/java-sdk/pull/927/commits/4ca9935c800c585db2d6264d94caa096b9e99bfd
4ca9935https://github.com/modelcontextprotocol/java-sdk/pull/927/commits/4ca9935c800c585db2d6264d94caa096b9e99bfd
https://github.com/chemicL
Update javadocs and years in headershttps://github.com/modelcontextprotocol/java-sdk/pull/927/commits/3e0cf9fd53b41a00b702f9e16d91a1944a547b2c
3e0cf9fhttps://github.com/modelcontextprotocol/java-sdk/pull/927/commits/3e0cf9fd53b41a00b702f9e16d91a1944a547b2c
https://github.com/chemicL
chemicLhttps://github.com/chemicL
breaking-change https://github.com/modelcontextprotocol/java-sdk/issues?q=state%3Aopen%20label%3Abreaking-change
v2 https://github.com/modelcontextprotocol/java-sdk/issues?q=state%3Aopen%20label%3Av2
Apr 20, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#event-24686285577
chemicLhttps://github.com/chemicL
April 20, 2026 18:47https://github.com/modelcontextprotocol/java-sdk/pull/927#commits-pushed-d7de6b8
https://github.com/chemicL
Formattinghttps://github.com/modelcontextprotocol/java-sdk/pull/927/commits/d7de6b8baf5f4ea0ac33088938ad8281b59e2e6b
d7de6b8https://github.com/modelcontextprotocol/java-sdk/pull/927/commits/d7de6b8baf5f4ea0ac33088938ad8281b59e2e6b
https://github.com/chemicL
Merge branch 'main' into json-compatibilityhttps://github.com/modelcontextprotocol/java-sdk/pull/927/commits/52edd371fab6c97b87d15093c48875532fd8d7b1
52edd37https://github.com/modelcontextprotocol/java-sdk/pull/927/commits/52edd371fab6c97b87d15093c48875532fd8d7b1
https://github.com/chemicL
Update migration dochttps://github.com/modelcontextprotocol/java-sdk/pull/927/commits/d1cad256fbc2dd892213e57f152e446f42f21f44
d1cad25https://github.com/modelcontextprotocol/java-sdk/pull/927/commits/d1cad256fbc2dd892213e57f152e446f42f21f44
https://github.com/chemicL
chemicLhttps://github.com/chemicL
Apr 20, 2026 https://github.com/modelcontextprotocol/java-sdk/pull/927#ref-pullrequest-4297507574
feat!: enforce required MCP spec fields in McpSchema; lenient wire deserialization #928 https://github.com/modelcontextprotocol/java-sdk/pull/928
https://github.com/chemicL
Remove temporary filehttps://github.com/modelcontextprotocol/java-sdk/pull/927/commits/12905a4d2e1b3e3a9ffb285bd995b253cec95e6f
12905a4https://github.com/modelcontextprotocol/java-sdk/pull/927/commits/12905a4d2e1b3e3a9ffb285bd995b253cec95e6f
https://github.com/tzolov
tzolovhttps://github.com/tzolov
Apr 23, 2026 https://github.com/modelcontextprotocol/java-sdk/pull/927#pullrequestreview-4161709810
View reviewed changes https://github.com/modelcontextprotocol/java-sdk/pull/927/files/12905a4d2e1b3e3a9ffb285bd995b253cec95e6f
tzolovhttps://github.com/tzolov
https://github.com/modelcontextprotocol/java-sdk/pull/927#pullrequestreview-4161709810
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
mcp-core/src/main/java/io/modelcontextprotocol/spec/McpSchema.javahttps://github.com/modelcontextprotocol/java-sdk/pull/927/files/12905a4d2e1b3e3a9ffb285bd995b253cec95e6f#diff-8ac83bd9fbe0774d8d98808d03fc46fab670b2bb8e09a1acc84e543886e61d79
tzolovhttps://github.com/tzolov
Apr 23, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#discussion_r3130173520
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
@Formatterhttps://github.com/Formatter
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
mcp-core/src/main/java/io/modelcontextprotocol/spec/McpSchema.javahttps://github.com/modelcontextprotocol/java-sdk/pull/927/files/12905a4d2e1b3e3a9ffb285bd995b253cec95e6f#diff-8ac83bd9fbe0774d8d98808d03fc46fab670b2bb8e09a1acc84e543886e61d79
tzolovhttps://github.com/tzolov
Apr 23, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#discussion_r3130174295
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
@Formatterhttps://github.com/Formatter
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
mcp-core/src/main/java/io/modelcontextprotocol/spec/McpSchema.javahttps://github.com/modelcontextprotocol/java-sdk/pull/927/files/12905a4d2e1b3e3a9ffb285bd995b253cec95e6f#diff-8ac83bd9fbe0774d8d98808d03fc46fab670b2bb8e09a1acc84e543886e61d79
tzolovhttps://github.com/tzolov
Apr 23, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#discussion_r3130176991
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
mcp-core/src/main/java/io/modelcontextprotocol/client/transport/ServerParameters.javahttps://github.com/modelcontextprotocol/java-sdk/pull/927/files/12905a4d2e1b3e3a9ffb285bd995b253cec95e6f#diff-a7bc2bce936809c0c55706240e64f5a22e05658a45d4a45778f0c439ae31c054
tzolovhttps://github.com/tzolov
Apr 23, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#discussion_r3130813633
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
https://modelcontextprotocol.io/docs/develop/connect-local-servershttps://modelcontextprotocol.io/docs/develop/connect-local-servers
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
chemicLhttps://github.com/chemicL
Apr 24, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#discussion_r3136351122
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
https://github.com/tzolov
tzolovhttps://github.com/tzolov
2.0.0-M1https://github.com/modelcontextprotocol/java-sdk/milestone/18
Apr 23, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#event-24800802911
https://github.com/tzolov
tzolovhttps://github.com/tzolov
Apr 23, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#issuecomment-4305312343
4c85963https://github.com/modelcontextprotocol/java-sdk/commit/4c8596306de503d374504e0fb80d6effada7d5f6
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
https://github.com/tzolov
tzolovhttps://github.com/tzolov
Apr 23, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#event-24800810698
https://github.com/chemicL
chemicLhttps://github.com/chemicL
Apr 24, 2026https://github.com/modelcontextprotocol/java-sdk/pull/927#issuecomment-4311770159
spring-io/spring-javaformat#393https://github.com/spring-io/spring-javaformat/issues/393
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
https://github.com/chemicL
chemicLhttps://github.com/chemicL
May 7, 2026 https://github.com/modelcontextprotocol/java-sdk/pull/927#ref-issue-3798815193
Handle schema validation failures gracefully #741 https://github.com/modelcontextprotocol/java-sdk/issues/741
https://github.com/chemicL
chemicLhttps://github.com/chemicL
June 11, 2026 14:40https://github.com/modelcontextprotocol/java-sdk/pull/927#event-26631050399
Add @JsonIgnoreProperties(ignoreUnknown = true) to capability sub-records #852 https://github.com/modelcontextprotocol/java-sdk/pull/852
ToolCapabilities needs to be marked with @JsonIgnoreProperties(ignoreUnknown = true) to avoid errors. #734 https://github.com/modelcontextprotocol/java-sdk/issues/734
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/java-sdk/pull/{{ revealButtonHref }}
Sign up for freehttps://github.com/join?source=comment-repo
Sign in to commenthttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fjava-sdk%2Fpull%2F927
https://github.com/tzolov
tzolov https://github.com/tzolov
https://github.com/modelcontextprotocol/java-sdk/pull/927/files/12905a4d2e1b3e3a9ffb285bd995b253cec95e6f
breaking-change https://github.com/modelcontextprotocol/java-sdk/issues?q=state%3Aopen%20label%3Abreaking-change
v2 https://github.com/modelcontextprotocol/java-sdk/issues?q=state%3Aopen%20label%3Av2
2.0.0-M1 https://github.com/modelcontextprotocol/java-sdk/milestone/18
Please reload this pagehttps://github.com/modelcontextprotocol/java-sdk/pull/927
https://github.com/chemicL
https://github.com/tzolov
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.