Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already disclose readOnly, idempotent, and non-destructive behavior. The description adds valuable context by explaining the two distinct response scenarios (all providers connected vs. missing credentials) and the fields returned (authenticated, pending, connect_url), enhancing transparency beyond the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.