Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Goes well beyond the readOnly/non-destructive annotations by explaining that availability is derived from PostgreSQL plan entitlements and catalog maturity rather than the credential catalog alone — a non-obvious sourcing caveat an agent could otherwise misread. It also reassures that credential values are never revealed, only masked previews, which is meaningful security context for a status endpoint.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.