# What are MCP tool annotations?

Tool annotations are optional hints an MCP server attaches to each tool: whether it is read-only, destructive, idempotent or reaches the open world. Apps use them to decide what to ask you before running a tool, but they are hints, not guarantees.

## The four hints

- `readOnlyHint` (default false): the tool doesn't change anything.
- `destructiveHint` (default true): a change may destroy rather than add.
- `idempotentHint` (default false): repeating the same call is safe.
- `openWorldHint` (default true): the tool reaches things outside a closed set, such as the web.

A tool without annotations is treated pessimistically: not read-only, possibly destructive, not idempotent, open-world. ChatGPT, for example, asks you to confirm every tool not marked read-only.

## Not a safety guarantee

The MCP project is clear that annotations may not describe a tool faithfully, that clients should treat them as untrusted unless the server is trusted, and that hard guarantees need network controls or sandboxing. See [Is this MCP server safe?](https://ai-powered.com/academy/connect-mcp-servers/is-this-mcp-server-safe)

## Sources

Official documentation, checked on 19 November 2026:

- [Tool annotations as risk vocabulary (MCP blog, 16 March 2026)](https://blog.modelcontextprotocol.io/posts/2026-03-16-tool-annotations/)
- [Add custom MCP server (OpenAI developer docs)](https://developers.openai.com/api/docs/guides/developer-mode)

## Related terms

- [Tool call](https://ai-powered.com/academy/glossary/tool-call): A tool call is a structured request from an AI model to run one of the functions it was given, with arguments that match the function's input schema. The app runs the function, sends the result back to the model, and the model uses it to answer or to decide its next step.
- [MCP](https://ai-powered.com/academy/glossary/mcp): MCP (Model Context Protocol) is an open standard for connecting AI applications to outside tools and data. An AI app connects to small programs called MCP servers, asks each one what it offers, and calls those tools when a task needs them.
- [Prompt injection](https://ai-powered.com/academy/glossary/prompt-injection): Prompt injection is an attack where instructions meant for an AI are hidden in content it reads, such as a web page, email, document or a tool's result, to make it do something the user didn't ask for, like leaking data or misusing a connected tool.
