Document title as Draft and restore annotations.title
#113
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Follow-up to modelcontextprotocol#109. The introduction of `title` in modelcontextprotocol#109 is still a draft and is not supported in the latest specification, `Version 2025-06-18 (latest)`. In this PR, the README.md will be updated to mention this point and restore the references to the removed `annotations.title`. This aims to inform users that, as of `Version 2025-06-18 (latest)`, the use of `annotations.title` is considered stable. Additionally, separate validation for these parameters could be added. Please refer to the following comment regarding `annotations.title` and `title`: modelcontextprotocol/modelcontextprotocol#663 (comment)
koic
commented
Aug 22, 2025
| - `idempotent_hint`: Indicates if the tool's operations are idempotent | ||
| - `open_world_hint`: Indicates if the tool operates in an open world context | ||
| - `read_only_hint`: Indicates if the tool only reads data (doesn't modify state) | ||
| - `title`: A human-readable title for the tool |
There was a problem hiding this comment.
This reorders the items in accordance with https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations.
atesgoral
approved these changes
Aug 22, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Motivation and Context
Follow-up to #109.
The introduction of
titlein #109 is still a draft and is not supported in the latest specification,Version 2025-06-18 (latest).In this PR, the README.md will be updated to mention this point and restore the references to the removed
annotations.title.This aims to inform users that, as of
Version 2025-06-18 (latest), the use ofannotations.titleis considered stable.Please refer to the following comment regarding
annotations.titleandtitle: modelcontextprotocol/modelcontextprotocol#663 (comment)How Has This Been Tested?
Existing tests have been updated and removed tests have been restored.
Breaking Changes
None.
Types of changes
Checklist
Additional context
Additionally, separate validation for these parameters could be added.