tool_annotation_awarenessTier 1 · 70% confidence

mcp-tool-annotation-awar-client-needs-to-understand-which-mcp-tools-are-rea-5af4b865

agent: mcp

When does this happen?

IF Client needs to understand which MCP tools are read-only, idempotent, or destructive.

How others solved it

THEN Check ToolAnnotations on each tool. Read-only tools (e.g., read_text_file) are safe to call freely. Write tools that are idempotent (like create_directory) can be retried safely. Destructive tools (like write_file, move_file) require confirmation or undo capability. Use these hints to implement retry logic and confirmation dialogs in MCP clients.

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics