Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false. The description adds value by detailing specific return values (authenticated:true, empty pending[], connect_url) and conditional behavior. Minor gap: it does not mention partial connectivity states, but overall it enhances the annotation-provided safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.