Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the annotations (readOnlyHint=true, destructiveHint=false), the description discloses specific behavioral outcomes: when all providers are connected, it returns authenticated:true and empty pending[]; when credentials are missing, it returns connect_url for the toolkit and per-install URLs. This adds valuable context about expected response states.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.