Add tool annotations support - #151
Merged
laulauland merged 2 commits intoNov 3, 2025
Merged
laulauland merged 2 commits into
laulauland merged 2 commits into
Conversation
Implements tool annotations per MCP specification 2025-06-18, enabling servers to provide behavioral hints and metadata about tools. Changes: - Added ToolAnnotations interface extending Annotations with tool-specific fields - Updated Tool interface to include optional annotations field - Extended tool() method to accept and pass through annotations - Added comprehensive test coverage for all annotation fields - Documented annotations feature with examples in README and JSDoc Annotations include: - Behavioral hints: readOnlyHint, destructiveHint, idempotentHint, openWorldHint - Base fields: audience, priority, lastModified, title This allows clients to make informed decisions about tool usage, understand tool behavior, and identify potential risks. Closes: Investigation of tool annotations support
🦋 Changeset detectedLatest commit: 3530968 The changes in this PR will be included in the next version bump. This PR includes changesets to release 1 package
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
commit: |
Closed
brettimus
approved these changes
Oct 31, 2025
brettimus
left a comment
brettimus
left a comment
Contributor
There was a problem hiding this comment.
just add changeset 👍
glad we support this now, it's useful for openai
|
PR looks great 🙌 |
laulauland
deleted the
claude/investigate-tool-annotations-011CUfPTtSGRzuU7xB3a2J4K
branch
November 3, 2025 09:32
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 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.
Implements tool annotations per MCP specification 2025-06-18, enabling servers to provide behavioral hints and metadata about tools.
Changes:
Annotations include:
This allows clients to make informed decisions about tool usage, understand tool behavior, and identify potential risks.
Closes #150