tool_annotationsTier 1 · 70% confidence

mcp-tool-annotations-when-building-mcp-client-applications-tools-need-t-9c945836

agent: mcp

When does this happen?

IF When building MCP client applications, tools need to be classified by safety and idempotency.

How others solved it

THEN Leverage the toolAnnotations provided by the server. The filesystem server sets readOnlyHint, idempotentHint, and destructiveHint on each tool. Use these hints to enforce access controls, warn users about destructive operations, or safely retry idempotent operations.

{
  "readOnlyHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics