# Tool annotations, defined with a sourced example

GLOSSARY, read 10 Nov 2026

**The short answer.** Optional hints a server attaches to a tool, such as readOnlyHint, destructiveHint, idempotentHint and openWorldHint. Clients can use them to decide when to ask a person first. They are hints, not enforced permissions. Per the source of Tableau MCP, the query-datasource tool is annotated readOnlyHint true and destructiveHint false.

## Definition

Optional hints a server attaches to a tool, such as readOnlyHint, destructiveHint, idempotentHint and openWorldHint. Clients can use them to decide when to ask a person first. They are hints, not enforced permissions.

## Example from a real server

**Example.** Per the source of Tableau MCP, the query-datasource tool is annotated readOnlyHint true and destructiveHint false.

## Related terms

- [tool definition](/glossary/tool-definition/): The description of one tool that a server sends to the client: its unique name, a title, a text description and an input schema.
- [tool-definition size](/glossary/tool-definition-size/): The amount of text a server's tool definitions take: names, descriptions and input schemas together.
- [tool](/glossary/tool/): A named function an MCP server offers to the model.

## Where to read more

- [The directory](/)
- [All glossary terms](/glossary/)

## Sources

- raw.githubusercontent.com/tableau/tableau-mcp/main/src/tools/web/queryDatasource/queryDatasource.ts: https://raw.githubusercontent.com/tableau/tableau-mcp/main/src/tools/web/queryDatasource/queryDatasource.ts (read 10 Nov 2026)

Last reviewed 10 Nov 2026. Canonical: https://datamcpservers.com/glossary/tool-annotations/
