Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint and idempotentHint as true, and destructiveHint as false. The description adds meaningful context beyond that by explaining exact response structure (authenticated flag, pending array, connect_url) and the conditions under which each appears. This behavioral detail helps the agent understand output without needing to call, fully satisfying the transparency requirement.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.