{"uid":"cap_u9_It7YqIHitxE99--OYK","slug":"creator-desk-agent-surface-preflight-check-5f362492","name":"Creator Desk Agent Surface Preflight Check","description":"Machine-callable x402-paid utilities for autonomous agents.","url":"https://creator-desk-x402-isolated.onrender.com/v1/agent/preflight?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"origin":{"type":"string","format":"uri","maxLength":2048,"description":"Public HTTPS origin for the agent/service. Private/local destinations and non-443 ports are rejected."}}},"responseSchema":{"type":"json","example":{"checks":[{"code":"agent_card_reachable","pass":false,"message":"A2A agent card was not observed."}],"origin":"https://example.com/","version":"1.0.0","surfaces":{"x402":{"url":"https://example.com/.well-known/x402","status":404,"networks":[],"reachable":false,"error_code":null,"parseable_json":false,"resource_count":0,"payment_enabled_count":0},"agent_card":{"url":"https://example.com/.well-known/agent-card.json","name":null,"status":404,"reachable":false,"error_code":null,"skills_count":0,"parseable_json":false,"protocol_version":null,"provider_declared":false}},"readiness":"REVIEW","checked_at":"2026-10-05T00:00:00.000Z","product_id":"creator_desk_agent_surface_preflight","limitations":["Observable public metadata only; this is not a security audit, identity verification, legal opinion, settlement proof, or guarantee of delivery."]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HceM79M5yYe13vJZGBDI5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a public-metadata preflight scan on an agent/service origin URL, checking x402 payment surface and A2A agent card reachability and readiness.","exampleAgentPrompt":"Can you run a preflight check on https://myagent.example.com to see if its x402 payment surface and agent card are properly set up and reachable?","exampleUseCases":[{"title":"Pre-launch agent readiness audit","prompt":"Before I list my agent service at https://myservice.example.com in any marketplace, can you run a preflight scan to tell me if its x402 payment config and agent card are correctly set up?"},{"title":"Diagnosing agent discovery failure","prompt":"My agent at https://agent.mycompany.com isn't showing up in agent directories — can you do a preflight check to see what's wrong with its public surfaces?"},{"title":"Vetting a third-party agent before integration","prompt":"I'm thinking of integrating with the agent at https://partner.example.com — can you check whether it has a valid x402 surface and reachable agent card before I commit?"}],"resultDescription":"Returns a structured JSON report containing: a `readiness` rating (e.g. REVIEW, READY), a list of named checks (e.g. agent_card_reachable) each with pass/fail and a message, detailed surface data for both the x402 well-known URL (HTTP status, reachability, network list, resource counts, payment-enabled counts) and the agent card (name, skills count, protocol version, provider declared), the checked timestamp, product ID, and a limitations disclaimer. Does not represent a security audit or identity verification.","failureModes":["Private or localhost origin URLs are rejected (non-public or non-443 ports not allowed)","Malformed or non-HTTPS URIs return a validation error","The target origin may be unreachable, causing surface checks to return reachable:false","x402 or agent card JSON may be present but unparseable, reflected in parseable_json:false","Network timeouts on the remote origin may produce incomplete check results"],"whenToPreferThis":"Use this endpoint when you need a quick, automated, public-metadata-only readiness scan of an agent or service origin — specifically to verify x402 payment surface configuration and A2A agent card discoverability before listing, integrating, or routing payments through an agent. Prefer this over manual curl checks or custom monitoring when you need a structured, machine-readable readiness verdict with per-surface breakdown.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:41:15.651Z","isFirstParty":false,"canonicalSlug":"creator-desk-agent-surface-preflight-check-5f362492"}