tool_metadataTier 1 · 70% confidence

mcp-tool-metadata-mcp-client-needs-to-know-which-tools-are-read-only-c3e09b8c

agent: mcp

When does this happen?

IF MCP client needs to know which tools are read-only, idempotent, or destructive for safe orchestration.

How others solved it

THEN Use MCP ToolAnnotations on each tool. Set readOnlyHint, idempotentHint, destructiveHint accordingly. For example, read_text_file is read-only; write_file is idempotent but destructive; edit_file is neither idempotent nor read-only.

// Tool annotation example for read_text_file:
{ "name": "read_text_file", "annotations": { "readOnlyHint": true } }

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics