Proposal: API additions for the 2025-11-25 spec (in v1.2.0-pre.1) #725
Description
This issue is a formal proposal for the API additions made in support of the 2025-11-25 spec. These changes were made under their own tracking issue, but API decisions were made as part of the implementation.
Nevertheless, all API changes should be subject to the ordinary proposal process, so I'm opening this issue to aggregate any feedback on the API decisions. We'll leave it open for at least a week during the prerelease period to offer opportunity for discussion.
Here is the full list of changes that aren't covered by another proposal. All of these are in the mcp package.
Fixes for 'Roots' bug (#607)
- ClientCapabilities.RootsV2: added
- RootCapabilities: added
Support for URL mode elicitation (SEP-1036)
- ClientOptions.ElicitationCompleteHandler: added
- ElicitParams.ElicitationID: added
- ElicitParams.Mode: added
- ElicitParams.URL: added
- ElicitationCapabilities.Form: added
- ElicitationCapabilities.URL: added
- ElicitationCompleteNotificationRequest: added
- ElicitationCompleteParams: added
- Event.Retry: added
- FormElicitationCapabilities: added
- URLElicitationCapabilities: added
- URLElicitationRequiredError: added
Support for SSE polling (SEP-1699)
- CloseSSEStreamArgs: added
- RequestExtra.CloseSSEStream: added
Support for icons and metadata (SEP-973)
- Icon: added
- Implementation.Icons: added
- Implementation.WebsiteURL: added
- Prompt.Icons: added
- Resource.Icons: added
- ResourceLink.Icons: added
- ResourceTemplate.Icons: added
- Tool.Icons: added