Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Despite annotations already declaring readOnly and idempotent hints, the description adds meaningful behavioral details: it explains the exact return shape for two scenarios (all connected vs. missing credentials), including the 'authenticated' flag, 'pending' list, and 'connect_url'. This goes beyond the annotations and provides valuable runtime context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.