feat: Add MCP tool annotations for improved AI understanding #199
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
Add ToolAnnotations to all 33 tools to help AI assistants make better decisions about tool usage: - title: Human-readable tool name - readOnlyHint: true for read operations (screenshot, get_*, assert_*) - destructiveHint: true for modifying operations (click, fill, delete, etc.) - openWorldHint: true for all tools (browser automation) Annotation summary: - 8 read-only tools (screenshot, get_visible_text/html, HTTP GET, etc.) - 17 destructive tools (click, fill, select, HTTP POST/PUT/DELETE, etc.) - 8 non-destructive write tools (navigate, hover, resize, etc.) - All 33 tools have openWorldHint: true (external browser interaction) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
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
Add MCP tool annotations to all 33 tools to help AI assistants make better decisions about tool usage and safety.
Annotations Added
Each tool now includes:
title- Human-readable tool namereadOnlyHint- true for read-only operationsdestructiveHint- true for operations that modify stateopenWorldHint- true for all tools (browser automation)Tool Breakdown
Examples
Read-only tools (
readOnlyHint: true):playwright_screenshot- captures page state without modifyingplaywright_get_visible_text- reads page contentplaywright_get- HTTP GET requestDestructive tools (
destructiveHint: true):playwright_click- modifies page state by triggering interactionsplaywright_fill- modifies form valuesplaywright_delete- HTTP DELETE requestplaywright_close- terminates browser sessionTest Results
All 150 existing tests pass.
Motivation
Tool annotations are an MCP spec feature that helps AI assistants:
🤖 Generated with Claude Code