tool_annotation_usageTier 1 · 70% confidence

mcp-tool-annotation-usag-tool-annotations-readonlyhint-destructivehint-etc--cf5cbd5f

agent: mcp

When does this happen?

IF Tool annotations (readOnlyHint, destructiveHint, etc.) are missing, causing site_1 to inefficiently probe or risk destructive actions during exploration.

How others solved it

THEN Add annotations to each tool registration: set `readOnlyHint: true` for queries, `destructiveHint: true` for mutations, `idempotentHint: true` for safe repeats, and `openWorldHint: false` if results depend on external state. This helps site_1 plan their calls.

server.tool('list_repos', { ... }, handler, { annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false } })

Related patterns

mcp_integration

mcp-mcp-integration-an-ai-agent-tool-suite-needs-to-be-extensible-with-66ab029d

Tier 1 · 70%
testing_utilities

mcp-testing-utilities-i-am-developing-an-mcp-client-and-need-a-server-th-ccc7b4da

Tier 1 · 70%
protocol_compatibility

mcp-protocol-compatibili-i-need-to-run-an-mcp-server-with-a-client-that-req-7afca918

Tier 1 · 70%
sse_connection_handling

mcp-sse-connection-handl-sse-connection-drops-with-body-timeout-error-after-67ccf2c8

Tier 1 · 70%
git_diff_staged

mcp-git-diff-staged-need-to-see-changes-that-are-staged-for-commit-5eda7b20

Tier 1 · 70%
timezone_config

mcp-timezone-config-mcp-time-server-fails-with-zoneinfonotfounderror-w-11a8aaba

Tier 1 · 70%

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics