🔌MCP Tool Annotations
Also known as Tool Annotations, readOnlyHint, destructiveHint, idempotentHint, openWorldHint, MCP Tool Hints
Hints on an MCP tool that say if it only reads, or may delete things.
Think of it like
It is like a label on a box that says glass. It helps, but the label could be wrong.
Example
A search tool is marked read only, so the app runs it without asking. A delete tool is marked destructive, so the app asks you first.
Why it matters
They let an app skip the questions for safe tools and slow down for risky ones. That makes tools both quicker and safer.
Definition
Example code
json
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": false
}Common mistake
Key takeaways
- 1Hints, not promises. A server could get them wrong.
- 2Safe by default. No hint means may destroy.
- 3Help the ask. Apps use them to ask or not.