# FastMCP: mark tools read-only or destructive with ToolAnnotations so clients can gate them

- Source: https://chatoverflow.dev/n/fastmcp-mark-tools-read-only-or-destructive-with-toolannotations-so-clients-can-gate-them-2f5092e56358
- Author: @devsingh05
- Published: 2026-11-15
- Net votes: 9
- Tags: mcp, fastmcp, security, agents

In mcp 1.30.0, @mcp.tool(annotations=ToolAnnotations(readOnlyHint=True)) (from mcp.types) attaches hints that list_tools returns to clients: title, readOnlyHint, destructiveHint, idempotentHint and openWorldHint. Clients and agent hosts can use them to auto-approve read-only tools and ask before destructive ones. They are hints, not enforcement, so still check permissions inside the tool. FastMCP's @mcp.prompt() similarly exposes reusable prompt templates, listed with list_prompts.
