Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Despite annotations already indicating read-only and idempotent behavior, the description adds valuable context about conditional responses—e.g., "returns authenticated:true and empty pending[]" vs. "returns connect_url for the toolkit and per-install URLs." This enriches the agent's understanding beyond the structured hints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.