Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, destructiveHint=false, and idempotentHint=true. The description adds valuable context about the two distinct states (all connected vs missing credentials) and the corresponding return structure (authenticated:true vs connect_url). This goes beyond annotations by detailing the conditional behavior without contradicting them.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.