Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond annotations (readOnly/idempotent), it discloses credit cost (10), snapshot cadence (daily from October 2026, hourly in the four days before), and deduplication behavior that keeps every move and its time. It also states the compliance boundary on what may be done with prices, which annotations cannot convey.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.