Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations mark destructiveHint=true, but the description adds meaningful context beyond that: it clarifies the archive is reversible ('goes to the archive, not away'), that pages and widgets remain attached, and that list_archive and restore_from_archive are the recovery paths. This enriches the agent's understanding of the operation's effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.