Class ToolAnnotations
Optional metadata (“tool annotations”) describing a tool’s behavior and UX hints. Spec: https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations
These are hints for presentation/policy; clients MUST NOT make security-critical decisions based solely on them.
public sealed class ToolAnnotations
- Inheritance
-
ToolAnnotations
- Inherited Members
Properties
- DestructiveHint
If
true
, the tool may perform destructive updates. Only meaningful when ReadOnlyHint isfalse
. Default:true
.
- IdempotentHint
If
true
, repeated calls with the same arguments have no additional effect (idempotent). Only meaningful when ReadOnlyHint isfalse
. Default:false
.
- OpenWorldHint
If
true
, the tool may interact with an “open world” of external entities (e.g., the web). Default:true
.
- ReadOnlyHint
If
true
, the tool does not modify its environment (read-only). Default:false
.
- Title
Human-readable title for UI display. Default:
""
(empty string indicates unspecified — consumers may fall back to the tool name).