feat: Add destructiveHint and openWorldHint tool annotations #715
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
|
Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA). View this failed invocation of the CLA check for more information. For the most up to date status, view the checks section at the bottom of the pull request. |
triepod-ai
changed the title
triepod-ai
force-pushed
the
add-tool-annotations
branch
from
d1b01b8 to
e00b306
Compare
This PR adds the missing MCP tool annotations to improve AI assistant understanding of tool capabilities: - openWorldHint: true for all 26 tools (browser automation = external interaction) - destructiveHint: true for closePage, navigatePage, evaluateScript (irreversible changes) - destructiveHint: false for all other write operations (reversible modifications) These annotations help AI assistants make better decisions about: - Which tools require user confirmation before execution - Which tools interact with external systems - Which operations may cause data loss 🤖 Generated with [Claude Code](https://claude.com/claude-code)
triepod-ai
force-pushed
the
add-tool-annotations
branch
from
e00b306 to
aaa3fb7
Compare
|
Thank you, own thank you this is if it was an under human hand I will not succeed any step of my life ha ha ha ha ha ha ha ha thank you |
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.
Summary
This PR adds the missing MCP tool annotations (
destructiveHintandopenWorldHint) to all 26 tools in chrome-devtools-mcp.Changes
ToolDefinition.ts: Added optionaldestructiveHintandopenWorldHintfields to the annotations interfaceopenWorldHint: truefor all tools (browser automation inherently interacts with external websites)destructiveHint: trueforclosePage,navigatePage, andevaluateScript(operations that can cause irreversible changes)destructiveHint: falsefor other write operations (reversible modifications like click, fill, hover)Why These Annotations Matter
Per the MCP specification:
openWorldHint: Indicates tools that interact with an "open world" of external entities. All browser automation tools interact with external websites, so this is true for all tools.destructiveHint: Indicates tools that may perform irreversible updates. This helps AI assistants determine when to request user confirmation.Tools Summary
🤖 Generated with Claude Code