Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly/idempotent/non-destructive, so the description's added value is real: it discloses the 50-per-page cap, stable ordering, the `truncated` signal, and that the catalogue can change mid-traversal — an important caveat for cursor consumers. It stops short of describing what happens if the cursor expires or how the filter interacts with result drift.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.