Errors and limits

Public failures include authentication, missing contract, unavailable tool, validation, permission, conflict, not found, retriable upstream failure, and internal failure. Preserve the structured error code and request ID when contacting support.

Retry read-only upstream failures with bounded backoff. Do not blindly retry writes: use idempotency, reread on conflict, and preserve explicit user intent. Size and pagination limits are exposed in each tool schema; use handles/cursors instead of requesting unbounded content.