{"service":"x402 Pre-Pay Clearance","version":"1.2.0","purpose":"Run this before paying an x402 endpoint. It inspects the live payment contract, endpoint behavior, risk signals, and retained reputation evidence to return ALLOW, REVIEW, or BLOCK.","primary_endpoint":{"method":"GET","path":"/clear?target=","price":"$0.05","use_when":"An agent is about to pay an x402 endpoint and needs an evidence-backed clearance decision."},"network":"eip155:8453 (Base mainnet)","payment_asset":"USDC","payment_protocol":"x402","payment":{"scheme":"exact","network":"eip155:8453","asset":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6},"amount_encoding":"USDC base units (6 decimals) in the HTTP 402 payment-required header."},"evidence_policy":{"clearance_uses":["Live HTTP reachability and x402 payment-requirement validation","payTo, network, price, asset, timeout, and payment-scheme checks","SSRF-safe endpoint probing, landmine flags, sanctions data, and retained reputation observations"],"wallet_history_uses":"GET /clear?payTo= returns a separate Base-USDC 30-day payment-history verdict only when full on-chain scan coverage is available.","does_not_guarantee":"A clearance result is risk evidence, not a guarantee that a third-party service, asset, or financial outcome is safe."},"endpoints":{"paid":{"GET /clear?target=":{"price":"$0.05","description":"Primary pre-pay clearance decision for an x402 service URL"},"GET /verify":{"price":"$0.005","description":"x402 endpoint safety check (SAFE/CAUTION/SUSPECT/DEAD)"},"GET /pulse":{"price":"$0.002","description":"Ecosystem activity snapshot"},"GET /signal":{"price":"$0.003","description":"Risk signal for an address"}},"free":{"GET /":{"description":"This discovery document"},"GET /clear?payTo=":{"description":"On-chain Base-USDC payment-history verdict for a payTo wallet (30-day window)"},"GET /price":{"description":"Token price lookup"},"GET /demand":{"description":"Demand statistics"},"GET /changes":{"description":"Recent catalog changes"},"GET /reputation/stats":{"description":"Reputation dataset stats"},"POST /passport/attest":{"description":"Submit a buyer-signed attestation of one completed Base-USDC purchase (EIP-191 signature + on-chain payment verification required)"},"GET /passport?target=":{"description":"Aggregate purchase-attestation evidence for an exact endpoint URL, broken down by evidence level"}}},"service_passport":{"purpose":"Captures evidence that a service purchase completed, without pretending a wallet payment alone proves service quality.","evidence_levels":{"chain_verified_buyer_attested":"The USDC payment from buyer to payTo is verified on-chain AND the buyer signed the outcome claim. Proves a payment happened and what the buyer says about it — NOT independent proof of delivery.","resource_server_signed":"A receipt signed by the resource server itself. The only level that could prove service delivery. Not yet supported — always reported as 0.","failed":"Chain-verified payment where the buyer attests the service failed.","unknown":"Attestations whose on-chain payment could not be verified are never stored and never counted as evidence."},"limitation":"Buyer attestations are self-reported outcomes backed by a real payment. They can show demand and buyer sentiment but cannot prove that the service actually delivered what was promised."},"agent_integration":{"protocol":"MCP (Model Context Protocol) over Streamable HTTP","endpoint":{"method":"POST","path":"/mcp"},"tool":{"name":"prepay_clearance","description":"Free trial: returns a limited decision summary (verdict, score, top reasons) before any payment."},"full_report":{"method":"GET","path":"/clear?target=","price":"$0.05","payment":"x402 (USDC on Base, eip155:8453)","note":"Complete evidence bundle remains on this paid route. The target query value must be URL-encoded."},"trial_limit":"10 successful trial calls per framework peer per rolling 10 minutes."},"documentation":"Responses are JSON. Paid endpoints return HTTP 402 with machine-readable x402 payment requirements when called without payment."}