{"name":"onyx_x402_error_explain","tier":"free","price_usdc":"0","endpoint":"https://onyx-actions.onrender.com/v1/onyx_x402_error_explain","method":"POST","input_schema":{"type":"object","properties":{"status_code":{"type":"integer","description":"HTTP status code returned by the server (e.g. 402, 422, 401)."},"response_body":{"type":"string","description":"Raw response body as text. JSON is auto-detected and parsed."},"response_headers":{"type":"object","description":"Optional. HTTP response headers, useful for 402 challenges that carry payment-required header.","additionalProperties":{"type":"string"}},"request_summary":{"type":"string","description":"Optional. One-line summary of what the caller was trying to do."}},"required":["status_code"]},"description":"Plain-English explainer for any HTTP error in an x402 / MCP flow. Pass the status code + response body (or headers), get back a diagnosis with specific cause and actionable fix. Covers FastAPI validation, OAuth2 DCR failures, EIP-712 signature errors, x402 spec error codes, and Coinbase facilitator-specific responses. Free tier — local logic, no network calls.","when_to_use":"An agent / client got back an HTTP error from an x402 or MCP server and doesn't know what it means. Pass status + body + headers, get a clear diagnosis. Saves 20 min of doc-reading per opaque failure.","vs_alternatives":"HTTP spec lists 30+ codes generically; x402 / MCP / OAuth add layered meanings. No public 'explain this error in agent context' tool exists. This catalogs the 14 most common shapes.","example_request":{"status_code":422,"response_body":"{\"detail\":[{\"loc\":[\"body\",\"wallet_address\"],\"msg\":\"field required\",\"type\":\"value_error.missing\"}]}","request_summary":"POST /v1/onyx_agent_id with empty body"},"example_response":{"ok":true,"status_code":422,"match_count":1,"primary_explanation":{"title":"FastAPI request validation failure","cause":"Body fields don't match the route's input schema...","fix":"Parse 'detail' for {loc, msg, type}..."}},"settle_to":"0x3fD9ee1373562f894D322B37DFFAd7a5D2b2d78f","network":"base","facilitator":"https://facilitator.xpay.sh","payment_required":false,"free_introspection":true,"note":"GET this URL = free introspection card. POST with x402 payment header to call."}