{"schemaVersion":1,"topic":"errors","title":"Errors","generatedFrom":["src/lib/business/points-mcp/prepare-payment-errors.ts","src/lib/business/points-mcp/prepare-cash-check.ts","src/lib/business/points-mcp/metadata.ts"],"page":"/docs/agents/reference/errors","agentPayStatus":"/docs/agents/status.json","cashCheckCodes":["unreserved_cash_insufficient","unreserved_cash_unknown"],"cashCheckMode":"warn_until_execution_enabled","preparePaymentFailureClasses":[{"failureClass":"database_unavailable","message":"prepare_payment failed: database_unavailable","description":"POINTS could not reach its database. Retry later with the same idempotencyKey."},{"failureClass":"payment_prepare_failed","message":"prepare_payment failed: payment_prepare_failed","description":"The draft could not be prepared, for example because the agent is unavailable. Nothing was created."},{"failureClass":"invalid_tool_input","message":"prepare_payment failed: invalid_tool_input","description":"The input was malformed, used a forbidden selector, or reused an idempotencyKey with different data."},{"failureClass":"policy_blocked","message":"prepare_payment failed: policy_blocked","description":"Agent policy or permissions block this payment."},{"failureClass":"internal_tool_error","message":"prepare_payment failed: internal_tool_error","description":"An unexpected server error. Nothing was created."}],"jsonRpcErrors":[{"code":-32601,"meaning":"Unknown tool or method."},{"code":-32602,"meaning":"Invalid tool arguments. The error data names the field, never its value."}],"toolErrors":[{"tool":"*","text":"Missing required scope: <scope>","when":"The grant lacks the scope the tool needs."},{"tool":"create_payment_draft","text":"create_payment_draft is no longer an advertised POINTS MCP tool. Refresh tool discovery and use prepare_payment for Agent Pay payment preparation.","when":"Any call. The tool is retired."}]}