Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,164Letters: 84Defects: 3,898counted 2 min ago
teppi

Server definition

Hash
sha256:edf55c06427a3abbe061a3d826382d6a8ad24b663fac8e6665c71085b8dfbdd9
What it is
What a remote MCP server returned when asked what it offers: 16 tools

The blob, as servednamed by its sha256

{ "instructions": null, "tools": [ { "description": "Free: after paying an x402 endpoint, pass the PAYMENT-RESPONSE header it returned (X-PAYMENT-RESPONSE in v1). Returns the transaction, network and payer it names, whether that transaction exists on-chain and succeeded, and which USDC moved from whom to whom, with an explorer link. Read-only. Limited to 10 calls per hour.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "header": { "description": "The PAYMENT-RESPONSE header value (base64 JSON)", "maxLength": 20000, "minLength": 8, "type": "string" } }, "required": [ "header" ], "type": "object" }, "name": "check_payment_proof", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "checks": { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, "decoded": { "additionalProperties": {}, "description": "Transaction, network and payer named in the header", "propertyNames": { "type": "string" }, "type": "object" }, "explorer": { "description": "Explorer link for the transaction", "type": [ "string", "null" ] }, "onchain": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Whether the transaction exists and succeeded, and the USDC transfers" }, "overall": { "description": "pass, warn or fail", "type": "string" } }, "required": [ "overall" ], "type": "object" } }, { "description": "Free: look up an agent in Concordium's Agent Registry (CIS-8004) by its badge, the CIS-2 token address an Agent Card carries, or by the longer Agent ID that Concordium's registry app shows. Returns whether the badge is valid (Active, the card at agent_uri hashes to the metadata_hash on chain, and that card carries this badge), the owner account (tied to a verified identity), the agent wallet, the origins the card lists, and the CIS-8 key the agent binds with the address it stands for and whether the CIS-8 registry still holds it. To check the payTos of an x402 endpoint against its seller's badge, use x402_payee_check. Read-only. Shares the free limit of 10 calls per hour.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "badge": { "description": "The badge (e.g. Mf22oVsbu3vf4Jb1cga49), its ccd:<genesis>/cis-2:<address> form, or the registry app's Agent ID", "maxLength": 120, "minLength": 8, "type": "string" } }, "required": [ "badge" ], "type": "object" }, "name": "concordium_badge_check", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "agentUri": { "type": [ "string", "null" ] }, "agentWallet": { "type": [ "string", "null" ] }, "badge": { "description": "The badge as its short CIS-2 token address (an Agent ID is turned into it)", "type": "string" }, "card": { "description": "match, mismatch or unread", "type": [ "string", "null" ] }, "card_origins": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "The origins the anchored card lists as the agent's own" }, "external_key": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "The key the agent binds with CIS-8: namespace, key_type, the address it stands for, and still_bound (the CIS-8 registry still holds it for the owner)" }, "issues": { "description": "Why it is not valid; empty when valid", "items": { "type": "string" }, "type": "array" }, "network": { "description": "mainnet or testnet, from the badge's own registry contract", "type": [ "string", "null" ] }, "owner": { "description": "The owner account: a Concordium account, tied to a verified identity at the protocol level", "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ] }, "tokenId": { "type": [ "string", "number", "null" ] }, "valid": { "description": "Active, the card at agent_uri hashes to the metadata_hash on chain, and the card carries this badge", "type": "boolean" } }, "required": [ "badge", "valid", "issues" ], "type": "object" } }, { "description": "Report a bug, a missing feature or anything else about this service, in a structured way. Free. A person reads every report; nothing is run or changed automatically.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "contact": { "description": "Optional: how to reach you about it", "type": "string" }, "endpoint": { "description": "Optional: the route or tool it is about, e.g. /v1/token", "type": "string" }, "message": { "description": "What happened or what you need", "type": "string" }, "payment": { "description": "Optional: the payment it is about, when a paid call went wrong: its transaction (with the network) or a receipt id", "properties": { "network": { "description": "Its network, e.g. eip155:8453 (Base), solana, xrpl:0", "type": "string" }, "receipt": { "description": "A receipt id you were given for it", "type": "string" }, "tx": { "description": "The transaction hash or signature, e.g. the settlement transaction from the pay answer", "type": "string" } }, "type": "object" }, "type": { "description": "bug, feature (something missing) or other", "enum": [ "bug", "feature", "other" ], "type": "string" } }, "required": [ "message" ], "type": "object" }, "name": "feedback", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "id": { "description": "Report id, to refer to it later", "type": "string" }, "note": { "type": "string" }, "received": { "description": "true: a person will read it", "type": "boolean" }, "service": { "type": "string" }, "type": { "type": "string" } }, "required": [ "received", "id" ], "type": "object" } }, { "description": "Free: check the signed receipt that every paid x402 Doctor answer carries (diagnose, preflight, batch, deep, fix, delivery check; HTTP or MCP), for example to prove later which verdict you got before paying an endpoint. Pass the whole answer as response. Returns valid, the signer and whether it is an x402 Doctor signer; with route and input also whether the receipt is for exactly that request. A changed verdict or receipt fails. Read-only, nothing is stored. Same as POST /api/v1/verify.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "input": { "additionalProperties": {}, "description": "The tool arguments you sent (MCP), or the query parameters as strings (HTTP)", "propertyNames": { "type": "string" }, "type": "object" }, "response": { "additionalProperties": {}, "description": "The whole paid answer as you received it, including its receipt", "propertyNames": { "type": "string" }, "type": "object" }, "route": { "description": "The request it answered: \"mcp <tool name>\" for an MCP answer (e.g. \"mcp x402_preflight\"), \"GET /api/v1/preflight\" for an HTTP one", "type": "string" } }, "required": [ "response" ], "type": "object" }, "name": "verify_receipt", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "input_matches": { "description": "Only with route and input: whether the receipt is for exactly that request", "type": "boolean" }, "known_signer": { "description": "Whether that address is a current, retired or certified x402 Doctor signer", "type": [ "boolean", "null" ] }, "reason": { "description": "Why it is not valid", "type": "string" }, "signer": { "description": "The address that signed it", "type": "string" }, "signer_status": { "description": "current, retired or certified", "type": [ "string", "null" ] }, "valid": { "description": "true: signed by an x402 Doctor signer, unchanged, and (when route and input are given) for that request", "type": "boolean" } }, "required": [ "valid" ], "type": "object" } }, { "description": "Paid ($0.25 via x402 in USDC on Base, Solana, Monad, Polygon, Arbitrum, Avalanche, Algorand or Stellar, or in RLUSD on the XRP Ledger): not a reading but a purchase. x402 Doctor buys the endpoint once (at most $0.1, USDC on Base, from its own wallet) with the example input its listing declares, checks the answer against the declared output schema, has TypeSafe's Jev judge whether it is what was paid for, and measures the charge on chain. Answers with a job id at once; follow it with x402_delivery_status (free), the result usually comes within minutes. The endpoint must get a \"go\" from the pre-payment check and be payable in USDC on Base; otherwise it is refused before payment. Same as GET /api/v1/delivery-check. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "method": { "description": "HTTP method of the paid route (default: GET, then POST)", "enum": [ "GET", "POST" ], "type": "string" }, "url": { "description": "The x402 endpoint to buy once (https, someone else's, payable in USDC on Base)", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_delivery_check", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "accepts": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Only on an unpaid call: the x402 payment options" }, "endpoint_price_usd": { "type": [ "number", "null" ] }, "id": { "description": "The job id: pass it to x402_delivery_status", "type": [ "string", "null" ] }, "receipt": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Signed receipt (EIP-191) binding the answer to your arguments" }, "status": { "description": "queued, then done", "type": [ "string", "null" ] }, "status_url": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } }, "type": "object" } }, { "description": "Free: the status of a delivery check ordered with x402_delivery_check (or GET /api/v1/delivery-check): awaiting_payment, queued or done, and once done the result: paid_and_delivered, the outcome, the charge measured on chain and the transaction.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "id": { "description": "The job id x402_delivery_check answered with", "pattern": "^[a-z0-9]{10}$", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "x402_delivery_status", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "id": { "type": "string" }, "result": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Once done: paid_and_delivered, result, charged_usd, transaction, cache (could a CDN serve the paid answer to callers who did not pay)" }, "status": { "description": "awaiting_payment, queued or done", "type": "string" }, "status_url": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } }, "required": [ "id", "status" ], "type": "object" } }, { "description": "Paid ($0.01 via x402 in USDC on Base, Solana, Monad, Polygon, Arbitrum, Avalanche, Algorand or Stellar, or in RLUSD on the XRP Ledger): diagnose an x402 endpoint the way a paying agent would, without paying it: the 402 challenge format, every accepts[] option, the resource URL, Solana settlement readiness, which wallets can pay, Bazaar/OpenAPI discovery and the browser paywall. Returns every check with pass/warn/fail and a fix hint. For the endpoint's owner or a developer debugging it; to decide whether to pay someone else's endpoint, use x402_preflight. Same as GET /api/v1/diagnose. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "body": { "description": "Example JSON request body, for a POST route that checks its input before the 402 (implies POST). Without it, {} is sent and the requestBody example in the endpoint's /openapi.json is tried.", "maxLength": 16384, "type": "string" }, "method": { "description": "HTTP method of the paid route (default: GET, then POST)", "enum": [ "GET", "POST" ], "type": "string" }, "url": { "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_diagnose", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "accepts": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Only on an unpaid call: the x402 payment options" }, "checks": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Every check with its status, message and hint" }, "overall": { "anyOf": [ { "description": "pass, warn or fail", "type": "string" }, { "type": "null" } ], "description": "pass, warn or fail (absent on the payment requirement)" }, "receipt": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Signed receipt (EIP-191) binding the answer to your arguments" }, "url": { "type": [ "string", "null" ] } }, "type": "object" } }, { "description": "Free: which public x402 facilitators (PayAI, x402.org, GoPlausible, x402.rs, Dexter, Daydreams, Semantic Pay and more) answer right now, and which networks and schemes each one settles. Give a network (CAIP-2 like eip155:8453, or an x402 v1 name like base, solana, xlayer) to get only the facilitators that settle it now. Read from each facilitator's GET /supported at most every 5 minutes; never verifies or settles anything. Use it to pick a facilitator for a new paid endpoint, or to see why payments on a network fail.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "network": { "description": "A network to filter on, e.g. eip155:196 or xlayer", "pattern": "^[a-z0-9-]{2,32}(:[-_a-zA-Z0-9/+=]{1,64})?$", "type": "string" } }, "type": "object" }, "name": "x402_facilitator_status", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "checked_at": { "type": "string" }, "down": { "type": "number" }, "facilitators": { "description": "Per facilitator: id, name, url, state (up, slow, down, not_checked), note, networks (CAIP-2, testnet flag, schemes), schemes, x402_versions, recent checks, last_up", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, "network": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "With a network asked for: its CAIP-2 id, name, and facilitators_up (the ids that settle it right now)" }, "up": { "description": "Facilitators that answered GET /supported with at least one payment kind", "type": "number" } }, "required": [ "checked_at", "up", "down", "facilitators" ], "type": "object" } }, { "description": "Paid ($0.05 via x402 in USDC on Base, Solana, Monad, Polygon, Arbitrum, Avalanche, Algorand or Stellar, or in RLUSD on the XRP Ledger): diagnoses your x402 endpoint, then returns per problem the concrete change as code for your stack (express, next, hono, node, python, generic), filled in with your own payTo, amount, network and route. A working endpoint gets improvements too (ERC-8004 identity, Base Builder Code, x402scan ownership proof, skill.md, browser paywall, Bazaar output schema), each with code. For the endpoint's owner: includes the diagnosis, so there is no need to call x402_diagnose first. Same as GET /api/v1/fix. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "body": { "description": "Example JSON request body, for a POST route that checks its input before the 402 (implies POST). Without it, {} is sent and the requestBody example in the endpoint's /openapi.json is tried.", "maxLength": 16384, "type": "string" }, "method": { "description": "HTTP method of the paid route (default: GET, then POST)", "enum": [ "GET", "POST" ], "type": "string" }, "stack": { "description": "Your server stack (default: detected)", "enum": [ "express", "next", "hono", "node", "python", "generic" ], "type": "string" }, "url": { "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_fix", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "accepts": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Only on an unpaid call: the x402 payment options" }, "fixes": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Each problem with steps and code for your stack" }, "improvements": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Not wrong, but makes the service easier to find, trust or pay: steps and code" }, "overall": { "anyOf": [ { "description": "pass, warn or fail", "type": "string" }, { "type": "null" } ] }, "receipt": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Signed receipt (EIP-191) binding the answer to your arguments" }, "summary": { "type": [ "string", "null" ] }, "unfixed": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ] }, "url": { "type": [ "string", "null" ] } }, "type": "object" } }, { "description": "Free: is every payTo of this x402 endpoint really its seller's? Per payment option, one outcome of the draft ERC \"x402 Payee Verification for ERC-8004 Agents\": verified-wallet (the payTo is the agent wallet registered in the ERC-8004 Identity Registry), verified-delegation (the agent wallet signed an EIP-712 payee delegation for it), mismatch, invalid-delegation, endpoint-unlisted, owner-only (payTo is the identity's owner: never counted as verified), no-agent-wallet or not-read. The identity comes from the 402's extra.erc8004 or the seller's /.well-known/agent-registration.json. When the seller's /.well-known/agent-card.json carries a Concordium badge, the result also has concordium: the agent in Concordium's Agent Registry (CIS-8004; its owner is an identity-verified account) and per payTo verified-wallet, verified-external-key (a CIS-8 bound key), owner-only, mismatch, not-bound, revoked, card-mismatch, endpoint-unlisted or not-read. Never pays. Shares the free limit of 10 calls per hour.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "body": { "description": "Example JSON request body, for a POST route that checks its input before the 402 (implies POST). Without it, {} is sent and the requestBody example in the endpoint's /openapi.json is tried.", "maxLength": 16384, "type": "string" }, "method": { "description": "HTTP method of the paid route (default: GET, then POST)", "enum": [ "GET", "POST" ], "type": "string" }, "url": { "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_payee_check", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "agent": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "The identity checked: registry, agentId, block read, agent wallet" }, "concordium": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Verified by Concordium, when the seller's Agent Card carries a Concordium badge: status, summary, agent (badge, network, owner, agent wallet) and payees (outcome per payment option: verified-wallet, verified-external-key, owner-only, no-agent-wallet, mismatch, not-bound, revoked, card-mismatch, endpoint-unlisted, not-read)" }, "fix": { "type": [ "string", "null" ] }, "payees": { "description": "Per payment option: network, payTo, asset, outcome (verified-wallet, verified-delegation, mismatch, invalid-delegation, endpoint-unlisted, owner-only, no-agent-wallet, not-read) and reason", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, "status": { "description": "pass: every payTo is bound to the seller's agent; warn: some are not; info: could not confirm; none: no ERC-8004 identity found", "type": "string" }, "summary": { "type": "string" }, "url": { "type": "string" } }, "required": [ "status", "summary", "payees" ], "type": "object" } }, { "description": "Paid ($0.001 via x402 in USDC on Base, Solana, Monad, Polygon, Arbitrum, Avalanche, Algorand or Stellar, or in RLUSD on the XRP Ledger): call this before your agent pays an x402 endpoint. Returns go, caution or no_go, the recommended payment option, and why: payment would fail, the seller's payout address is on the OFAC SDN sanctions list, over your budget (max_usd), price above what is advertised, not HTTPS, unknown token, its 30-day track record. Never pays the endpoint. The buyer's check for one call; for several endpoints at once use x402_preflight_batch, before a payment above about $1 x402_preflight_deep, and to debug your own endpoint x402_diagnose. Same as GET /api/v1/preflight. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "body": { "description": "Example JSON request body, for a POST route that checks its input before the 402 (implies POST). Without it, {} is sent and the requestBody example in the endpoint's /openapi.json is tried.", "maxLength": 16384, "type": "string" }, "client": { "description": "Set to gateway when your agent pays with Circle's Gateway client (@circle-fin/x402-batching) from a Gateway balance: Gateway-only endpoints are then not a caution, and Gateway options are recommended first.", "enum": [ "gateway" ], "type": "string" }, "max_usd": { "description": "Your budget per call in USD, e.g. 0.05", "exclusiveMinimum": 0, "type": "number" }, "method": { "description": "HTTP method of the paid route (default: GET, then POST)", "enum": [ "GET", "POST" ], "type": "string" }, "network": { "description": "CAIP-2 network you want to pay on, e.g. eip155:8453", "type": "string" }, "pay_to": { "description": "The payout address (payTo) your agent was asked to pay, from the 402 it got. x402 Doctor screens that address too (OFAC SDN) and says caution (payto_not_shown) when the seller showed x402 Doctor another one: a seller can show a checker one 402 and buyers another.", "pattern": "^[A-Za-z0-9:._-]{20,128}$", "type": "string" }, "url": { "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_preflight", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "accepts": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Only on an unpaid call: the x402 payment options" }, "next_step": { "anyOf": [ { "description": "pay, ask_user (a caution: tell your user why and pay only if they accept) or do_not_pay", "type": "string" }, { "type": "null" } ] }, "options": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Each payment option with its network, price and problems" }, "reasons": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ] }, "receipt": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Signed receipt (EIP-191) binding the answer to your arguments" }, "safe_to_pay": { "type": [ "boolean", "null" ] }, "summary": { "description": "One line, e.g. OK to pay: $0.02 on Base.", "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "verdict": { "anyOf": [ { "description": "go: pay; caution: stop and ask your user first, saying why; no_go: do not pay", "type": "string" }, { "type": "null" } ] } }, "type": "object" } }, { "description": "Paid ($0.005 via x402 in USDC on Base, Solana, Monad, Polygon, Arbitrum, Avalanche, Algorand or Stellar, or in RLUSD on the XRP Ledger): the pre-payment check for up to 10 x402 endpoints at once. Per endpoint go, caution or no_go, the recommended payment option and why, plus totals. For marketplaces and agents that weigh several services. Never pays the endpoints. Same as GET /api/v1/preflight/batch. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "client": { "description": "Set to gateway when your agent pays with Circle's Gateway client (@circle-fin/x402-batching) from a Gateway balance: Gateway-only endpoints are then not a caution, and Gateway options are recommended first.", "enum": [ "gateway" ], "type": "string" }, "max_usd": { "description": "Your budget per call in USD, e.g. 0.05", "exclusiveMinimum": 0, "type": "number" }, "method": { "description": "HTTP method of the paid route (default: GET, then POST)", "enum": [ "GET", "POST" ], "type": "string" }, "network": { "description": "CAIP-2 network you want to pay on, e.g. eip155:8453", "type": "string" }, "urls": { "description": "The x402 endpoints to check (public http(s) URLs), at most 10", "items": { "type": "string" }, "maxItems": 10, "minItems": 1, "type": "array" } }, "required": [ "urls" ], "type": "object" }, "name": "x402_preflight_batch", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "accepts": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Only on an unpaid call: the x402 payment options" }, "count": { "type": [ "number", "null" ] }, "counts": { "anyOf": [ { "additionalProperties": { "type": "number" }, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "How many go, caution, no_go and unknown" }, "receipt": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Signed receipt (EIP-191) binding the answer to your arguments" }, "results": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "One preflight per endpoint" } }, "type": "object" } }, { "description": "Paid ($0.01 via x402 in USDC on Base, Solana, Monad, Polygon, Arbitrum, Avalanche, Algorand or Stellar, or in RLUSD on the XRP Ledger): for expensive calls. The pre-payment verdict (go, caution or no_go) plus the full diagnosis, the 30-day history per day, how reliable the seller's other endpoints are and whether the endpoint moved domains. Never pays the endpoint. Worth it before a payment above about $1; for an ordinary call x402_preflight is enough. Same as GET /api/v1/preflight/deep. The answer carries a signed receipt (EIP-191, bound to your arguments) that proves later which verdict you got.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "body": { "description": "Example JSON request body, for a POST route that checks its input before the 402 (implies POST). Without it, {} is sent and the requestBody example in the endpoint's /openapi.json is tried.", "maxLength": 16384, "type": "string" }, "client": { "description": "Set to gateway when your agent pays with Circle's Gateway client (@circle-fin/x402-batching) from a Gateway balance: Gateway-only endpoints are then not a caution, and Gateway options are recommended first.", "enum": [ "gateway" ], "type": "string" }, "max_usd": { "description": "Your budget per call in USD, e.g. 0.5", "exclusiveMinimum": 0, "type": "number" }, "method": { "description": "HTTP method of the paid route (default: GET, then POST)", "enum": [ "GET", "POST" ], "type": "string" }, "network": { "description": "CAIP-2 network you want to pay on, e.g. eip155:8453", "type": "string" }, "url": { "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_preflight_deep", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "accepts": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Only on an unpaid call: the x402 payment options" }, "next_step": { "anyOf": [ { "description": "pay, ask_user (a caution: tell your user why and pay only if they accept) or do_not_pay", "type": "string" }, { "type": "null" } ] }, "options": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ] }, "reasons": { "anyOf": [ { "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "type": "array" }, { "type": "null" } ] }, "receipt": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "Signed receipt (EIP-191) binding the answer to your arguments" }, "safe_to_pay": { "type": [ "boolean", "null" ] }, "summary": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "verdict": { "anyOf": [ { "description": "go: pay; caution: stop and ask your user first, saying why; no_go: do not pay", "type": "string" }, { "type": "null" } ] } }, "type": "object" } }, { "description": "Free: does this x402 endpoint work for a paying agent? Returns pass, warn or fail with the number of problems and the top three. Limited to 10 calls per hour. For every check use x402_diagnose ($0.01); for code changes x402_fix ($0.05); before paying someone else's endpoint x402_preflight ($0.001).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "body": { "description": "Example JSON request body, for a POST route that checks its input before the 402 (implies POST). Without it, {} is sent and the requestBody example in the endpoint's /openapi.json is tried.", "maxLength": 16384, "type": "string" }, "method": { "description": "HTTP method of the paid route (default: GET, then POST)", "enum": [ "GET", "POST" ], "type": "string" }, "url": { "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_quick_check", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "failures": { "type": "number" }, "next": { "type": "string" }, "overall": { "description": "pass, warn or fail", "type": "string" }, "top_problems": { "description": "Up to three problems, failures first", "items": { "type": "string" }, "type": "array" }, "url": { "type": "string" }, "warnings": { "type": "number" } }, "required": [ "overall", "failures", "warnings", "top_problems" ], "type": "object" } }, { "description": "Free: add your own paid endpoint to the x402 Trust Index when no registry lists it yet (CDP Bazaar, Circle's Agent Marketplace, GoPlausible, XRPL AI Hub, nohumans.directory, PayAPI Market, HIVE402, MPP directory). x402 Doctor first checks that it answers 402 with a payment challenge (x402, MPP or L402); the next daily scan starts its record, which buyers' agents see before they pay. At most 25 endpoints per host. Limited to 10 calls per hour.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "url": { "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_trust_add", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "check": { "description": "The free web check for this URL", "type": [ "string", "null" ] }, "error": { "description": "Why it was not added", "type": [ "string", "null" ] }, "message": { "type": [ "string", "null" ] }, "ok": { "description": "true: added, already added, or already listed", "type": "boolean" }, "status": { "description": "added, submitted (already added) or listed (a registry lists it)", "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "verdict": { "description": "The pre-payment verdict when it was added", "type": [ "string", "null" ] } }, "required": [ "ok" ], "type": "object" } }, { "description": "Free: the daily track record of a paid x402 or MPP endpoint from the x402 Trust Index: on how many of the last 30 scanned days an agent could pay it, the latest verdict and reasons, price and networks. found: false when it is not in the index; add your own endpoint with x402_trust_add. Limited to 10 calls per hour. Before paying, x402_preflight ($0.001) checks the live 402 and includes this record.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "url": { "description": "The x402 endpoint (public http(s) URL), e.g. https://api.example.com/paid", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "x402_trust_record", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "days_checked": { "type": [ "number", "null" ] }, "days_payable": { "description": "Days the daily scan found it payable (go or caution)", "type": [ "number", "null" ] }, "found": { "description": "false: not in the Trust Index (see how_to_list)", "type": "boolean" }, "how_to_list": { "type": [ "string", "null" ] }, "last": { "description": "Latest day: g go, c caution, n no_go, x unreachable", "type": [ "string", "null" ] }, "last_scan": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ], "description": "The latest verdict, reasons, price and networks" }, "payable_ratio": { "type": [ "number", "null" ] }, "submitted": { "description": "Added by its seller, not listed in a registry", "type": [ "boolean", "null" ] }, "url": { "type": "string" } }, "required": [ "url", "found" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:edf55c06427a3abbe061a3d826382d6a8ad24b663fac8e6665c71085b8dfbdd9 | sha256sum