Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations indicate readOnly=false, idempotent=false, and destructive=false, but the description adds valuable context: the replaced text is snapshotted first and the revert can itself be reverted. This clarifies the safety profile and goes beyond the annotation booleans.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.