Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, and non-destructive behavior. The description adds valuable context about output states (authenticated:true with empty pending[], and connect_url when missing credentials). However, it omits partial connection states where some providers are connected and others are not, leaving ambiguity in edge cases.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.