Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the readOnlyHint annotation, the description discloses important behavioral expectations: preserving legacy AgentTune adaptations, applying instrument-specific source terms, keeping responses local, preserving ties, and requiring user review before installation. This adds meaningful operational context that annotations alone do not provide.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.