Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false. The description adds concrete behavioral detail: it returns authenticated:true and empty pending[] when all providers are connected, and connect_url plus per‑install URLs when credentials are missing. This goes beyond the annotations and helps predict the tool's output without any contradiction.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.