Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, and destructiveHint, but the description adds valuable behavioral nuance: results are timestamped, weights/piece counts yield only an indicative amount, the firm price is determined in the office after verification, and data comes from the public web grid rather than internal tools. This meaningfully shapes expectations beyond the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.