Endpoints: 76,849MCP servers: 32,728Payout addresses: 3,825Paid calls: 6,146Letters: 84Defects: 3,891counted just now
teppi

Server definition

Hash
sha256:4afbdb845f6d12635c6562aad99cf1a0ec1ec2d44dc437acaff9e5810c2c47a0
What it is
What a remote MCP server returned when asked what it offers: 10 tools

The blob, as servednamed by its sha256

{ "instructions": "Lumière PayCheck checks x402 endpoints before an agent pays them. Call check_endpoint for a trust verdict, or check_payment with the amount and payTo from the 402 quote before paying; check_payment returns allow true only when every rule passes. After paying, report_outcome records whether you got what you paid for (with a receipt, or the payment tx). To browse providers use list_sellers and seller_endpoints; for the evidence behind a grade, paid_test_receipts; for x402 reliability as a whole and which sellers refund failed calls, reliability_report. Free to use. Teams running several agents can add a plan: a key per agent with spend limits, human review for unusual payments, signed receipts, and an audit trail. Agents can buy a plan themselves with USDC over x402: GET https://lumierepaycheck.org/v1/plans lists them; POST https://lumierepaycheck.org/v1/plans/builder ($9) or https://lumierepaycheck.org/v1/plans/business ($49) buys 30 days and returns an owner key; then POST https://lumierepaycheck.org/v1/agents creates agent keys. People can pay by card at https://lumierepaycheck.org/subscribe. Enterprise is custom.", "tools": [ { "description": "Get an overview of the whole monitored x402 catalog: how many endpoints are monitored, how many fall into each verdict (proceed, caution, avoid, free, insufficient_data), and when scores were last computed. Use it for context or reporting, for example to tell a user how much of the x402 ecosystem passes checks. Endpoints from a seller listing thousands of near-identical endpoints are counted once as bulk_listing until each has its own grade. It says nothing about any single endpoint: use check_endpoint for one endpoint, top_endpoints for a ranked list, or check_payment before paying. Read-only, free, no parameters.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": {}, "type": "object" }, "name": "catalog_stats", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "byVerdict": { "additionalProperties": { "type": "number" }, "description": "Endpoint count per verdict", "propertyNames": { "type": "string" }, "type": "object" }, "endpoints": { "description": "Endpoints monitored", "type": "number" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "scoredAt": { "description": "When scores were last computed", "type": [ "string", "null" ] } }, "required": [ "scoredAt", "endpoints", "byVerdict" ], "type": "object" } }, { "description": "Get the trust verdict for one x402 endpoint: score (0-100), grade (A-F), and verdict (proceed, caution, avoid, free, or insufficient_data), plus uptime, delivery-test status, payout-wallet incidents, and how many independent buyers stand behind the seller's buyer wallets (we count customers, not wallets). Use it when you're deciding whether an endpoint is trustworthy at all, before you have a price quote. When you already have the 402 quote (amount and payTo) and are about to pay, use check_payment instead: it runs this same check and also verifies the price and wallet. To discover good endpoints rather than check a known one, use top_endpoints. Read-only and free; reflects monitoring every 30 minutes and real test payments, so a brand-new endpoint may return insufficient_data. Endpoints not in the catalog return monitored: false and are checked automatically: if one answers a valid x402 payment quote it joins the catalog within about 10 minutes (see intake). A retest field appears while a failed paid test awaits its re-test (the grade changes only if that fails too). API docs: https://github.com/Book0fEli/lumiere-paycheck/blob/main/docs/api.md", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "url": { "description": "Full URL of the x402 endpoint including path, exactly as the agent will call it, e.g. https://api.example.com/v1/price.", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "check_endpoint", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "advice": { "description": "What the verdict means for paying it, naming the actual cause", "type": "string" }, "auth": { "additionalProperties": false, "description": "Present when our paid test was refused for want of the seller's own sign-in (no money was taken). Have access? Send hasAccess: true to check_payment.", "properties": { "note": { "type": "string" }, "required": { "description": "true: the seller needs its own sign-in (account, API key or wallet signature) on top of x402", "type": "boolean" } }, "required": [ "required", "note" ], "type": "object" }, "browser": { "additionalProperties": false, "description": "Whether a browser-based agent can pay this endpoint (CORS on the 402 and the payment preflight). Server-side agents aren't affected. Never changes the grade.", "properties": { "checkedAt": { "type": "string" }, "problems": { "items": { "type": "string" }, "type": "array" }, "ready": { "type": "boolean" } }, "required": [ "ready", "checkedAt" ], "type": "object" }, "buyerReports": { "additionalProperties": false, "description": "What real buyers reported after paying. Never changes the grade; confirmations move the endpoint up our paid-test queue.", "properties": { "confirmed": { "description": "Buyers (customers or wallets) who reported a usable response in 7 days", "type": "number" }, "note": { "type": "string" }, "ourTestQueued": { "description": "Our own paid test is queued for this endpoint", "type": "boolean" }, "problems": { "description": "Buyers who reported a problem in 7 days", "type": "number" }, "windowDays": { "type": "number" } }, "required": [ "confirmed", "problems", "ourTestQueued", "windowDays", "note" ], "type": "object" }, "buyers": { "additionalProperties": false, "description": "Who is really behind the seller's buyers. Never changes the grade.", "properties": { "buyerWallets30d": { "description": "Buyer wallets that paid the seller in 30 days", "type": "number" }, "estimated": { "description": "true when counted from a sample of buyers", "type": "boolean" }, "flags": { "description": "coordinated_wallets, self_funded, concentrated_buyers, shared_operator, estimated, partial_lookup", "items": { "type": "string" }, "type": "array" }, "independentBuyers30d": { "description": "Independent buyers behind the seller's buyer wallets in 30 days (wallets funded from one source count as one)", "type": "number" }, "organicShare": { "description": "0-1: share of 30-day volume from independent buyers", "type": "number" }, "reviewed": { "description": "false until the seller's buyers have been reviewed (the biggest sellers are reviewed daily)", "type": "boolean" } }, "required": [ "reviewed" ], "type": "object" }, "decidedBy": { "description": "Which rule set the final score (e.g. a ceiling from a failed paid test), or that it came straight from the points", "type": "string" }, "delivery": { "description": "verified = a real test payment was delivered; failing (see advice: an error after payment that didn't collect the money is D/caution; taking the money and failing is F/avoid); or unverified", "type": "string" }, "exampleInput": { "additionalProperties": false, "description": "Present when the listing's own example input got 'not found' when we paid (no money taken): use real input.", "properties": { "found": { "type": "boolean" }, "note": { "type": "string" } }, "required": [ "found", "note" ], "type": "object" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "grade": { "description": "A delivered cleanly; B delivered with a caveat; C unconfirmed; D doesn't work as listed, no money lost; F costs money or unsafe; ? with too little data", "type": "string" }, "headline": { "description": "One sentence: the verdict and its main reason", "type": "string" }, "intake": { "additionalProperties": false, "description": "For an endpoint we don't monitor yet: it's put in line for a first check, and joins the catalog within about 10 minutes if it answers a valid x402 payment quote", "properties": { "note": { "type": "string" }, "status": { "description": "queued | checking | monitored | rejected_recently | host_full | busy | invalid", "type": "string" } }, "required": [ "status", "note" ], "type": "object" }, "listing": { "additionalProperties": false, "description": "Present only when the latest paid response differs from the listing's example or schema. The data is delivered.", "properties": { "capped": { "description": "true: the data is reshaped vs the listing (nested, list vs item), grade capped at B; false: a minor gap, warning only", "type": "boolean" }, "matchesExample": { "description": "false: the paid response differs from the seller's own example", "type": "boolean" }, "sellerFix": { "description": "What the seller can change", "type": "string" }, "warning": { "description": "How the real response differs, and where to read the fields", "type": "string" } }, "required": [ "matchesExample", "warning", "sellerFix" ], "type": "object" }, "lookalike": { "additionalProperties": false, "description": "Present when this new endpoint looks like an imitation of an established seller (name one character off, lookalike characters, or a copied listing) and pays a different wallet. check_payment asks for review unless allowLookalike is true.", "properties": { "of": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "of", "reason" ], "type": "object" }, "monitored": { "description": "false if the endpoint isn't in the monitored catalog", "type": "boolean" }, "page": { "description": "Public page with the full history", "type": "string" }, "payToMode": { "description": "fixed, or per_request when the seller issues a new payout address per request", "type": "string" }, "points": { "additionalProperties": false, "description": "The points behind the score: uptime /40, speed /15, stability /25, delivery /20", "properties": { "delivery": { "type": "string" }, "speed": { "type": "string" }, "stability": { "type": "string" }, "total": { "type": "string" }, "uptime": { "type": "string" } }, "required": [ "uptime", "speed", "stability", "delivery", "total" ], "type": "object" }, "probes": { "description": "Checks counted in the last 7 days", "type": "number" }, "reasons": { "description": "Every factor behind the grade, most important first: paid tests (with date and what came back), uptime, speed, payout wallet, price, listing", "items": { "additionalProperties": false, "properties": { "at": { "description": "Date of the event it's based on (YYYY-MM-DD)", "type": "string" }, "effect": { "description": "positive, neutral or negative", "type": "string" }, "factor": { "description": "data, delivery, uptime, speed, wallet, price, listing, values, access or withdrawn", "type": "string" }, "limit": { "description": "The ceiling this factor puts on the grade, e.g. \"F (max 39)\"", "type": "string" }, "text": { "description": "What we found, in plain words (paid-test results include the date and what came back)", "type": "string" } }, "required": [ "factor", "effect", "text" ], "type": "object" }, "type": "array" }, "requiredInput": { "additionalProperties": false, "description": "Present when our paid test was refused for want of a header or input the listing doesn't document (no money taken).", "properties": { "documented": { "type": "boolean" }, "note": { "type": "string" } }, "required": [ "documented", "note" ], "type": "object" }, "retest": { "additionalProperties": false, "description": "Present while our latest paid test failed and its re-test (about 2 hours later) hasn't run: the grade still shows the earlier result and changes only if the re-test fails too", "properties": { "firstFailureAt": { "type": "string" }, "moneyTaken": { "type": "boolean" }, "note": { "type": "string" }, "pending": { "type": "boolean" }, "reason": { "type": "string" }, "retestDueBy": { "type": "string" } }, "required": [ "pending", "firstFailureAt", "retestDueBy", "moneyTaken", "reason", "note" ], "type": "object" }, "score": { "description": "0-100; null for free resources", "type": [ "number", "null" ] }, "testedWith": { "additionalProperties": false, "description": "Present when the latest passing paid test needed a sign-in or extra input: a seller-provided test account, a wallet sign-in, or the seller's declared test request.", "properties": { "how": { "type": "string" }, "note": { "type": "string" } }, "required": [ "how", "note" ], "type": "object" }, "uptimePct": { "description": "Share of checks in the last 7 days that returned a valid payment quote", "type": "number" }, "url": { "description": "The endpoint checked", "type": "string" }, "values": { "additionalProperties": false, "description": "Automatic value checks on the latest paid response. A warning caps the grade at B, never avoid.", "properties": { "checked": { "description": "true: automatic value checks passed on the latest paid test", "type": "boolean" }, "warning": { "description": "A value that looks wrong (wrong subject, stale data, price far from the public spot price)", "type": "string" } }, "required": [ "checked" ], "type": "object" }, "valuesChecked": { "description": "Latest paid check also passed known-answer value tests", "type": "boolean" }, "verdict": { "description": "proceed | caution | avoid | free | insufficient_data", "type": "string" }, "walletIncidents": { "description": "Unexplained payout-wallet changes", "type": "number" }, "walletUnconfirmed": { "description": "Recent wallet changes nobody could confirm yet", "type": "number" }, "withdrawn": { "additionalProperties": false, "description": "Present when the endpoint was withdrawn by its seller or is gone from the Bazaar: no longer for sale, don't pay it.", "properties": { "at": { "type": "string" }, "note": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "at", "reason", "note" ], "type": "object" }, "x402Version": { "description": "x402 protocol version the endpoint quotes (1 or 2)", "type": "number" } }, "required": [ "url", "monitored", "verdict" ], "type": "object" } }, { "description": "Decide whether a specific x402 payment should go through: returns allow true/false with reasons. Checks the endpoint's trust verdict, that the amount is within your cap and not above the monitored price, and that the payTo wallet matches the one we've observed (catches swapped or hijacked wallets). Optionally (minOrganicShare) it also requires that enough of the seller's volume comes from independent buyers. Intended for right before a payment, with the amount, payTo, and network from the endpoint's 402 quote; allow is true only when every rule passes. Use check_endpoint instead if you only want an endpoint's grade without a quote in hand. Read-only and free; it doesn't make or block the payment itself. When allow is false, the reasons list explains why. pauseDuringRetest: true also holds payments while a failed paid test awaits its re-test. API docs: https://github.com/Book0fEli/lumiere-paycheck/blob/main/docs/api.md", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "allowCaution": { "description": "false = deny endpoints with a caution verdict too, not just avoid (default true)", "type": "boolean" }, "allowLookalike": { "description": "true = don't ask for review when the endpoint is flagged as a possible lookalike of an established seller (default false)", "type": "boolean" }, "amount": { "description": "Amount about to be paid, atomic units (USDC has 6 decimals: 10000 = $0.01)", "type": "string" }, "asset": { "description": "Token (asset) address from the quote. Send it: a quote asking for a different token than this endpoint charges is denied (asset swap).", "type": "string" }, "hasAccess": { "description": "true if you have your own account, API key or sign-in with this seller. For endpoints that need the seller's sign-in on top of x402, allowCaution/requireVerified then don't block (we couldn't confirm delivery only because we can't sign in).", "type": "boolean" }, "maxAmount": { "description": "Your hard cap for this payment in atomic units (USDC: 1000000 = $1). Payments above it are denied.", "type": "string" }, "minOrganicShare": { "description": "Optional, 0-1: deny sellers where less than this share of 30-day volume comes from independent buyers (e.g. 0.5). Not applied to sellers whose buyers haven't been reviewed yet.", "maximum": 1, "minimum": 0, "type": "number" }, "network": { "description": "Network from the quote, e.g. eip155:8453. Send it: a quote on a network this endpoint never uses is denied.", "type": "string" }, "pauseDuringRetest": { "description": "true = deny while our latest paid test of this endpoint failed and its re-test (about 2 hours later) hasn't run yet (default false: allowed, with a note and a retest field)", "type": "boolean" }, "payTo": { "description": "Wallet address from the endpoint's 402 quote", "type": "string" }, "priceTolerance": { "description": "Optional, 0-0.5 (default 0.02 = 2%): how far above the endpoint's recent prices still counts as the same price, for sellers whose price drifts (pegged to BTC, gas or FX). Bigger jumps are denied as overcharges.", "maximum": 0.5, "minimum": 0, "type": "number" }, "requireVerified": { "description": "true = only allow endpoints that delivered on a real test payment (default false)", "type": "boolean" }, "url": { "description": "Full URL of the x402 endpoint you are about to pay, including path", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "check_payment", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "afterPaying": { "description": "How to report the outcome after paying (free, verified on-chain)", "type": "string" }, "allow": { "description": "Pay only when true", "type": "boolean" }, "authRequired": { "description": "true: the seller needs its own sign-in on top of x402; send hasAccess: true if you have it", "type": "boolean" }, "buyerReports": { "additionalProperties": false, "description": "What real buyers reported after paying. Never changes the grade; confirmations move the endpoint up our paid-test queue.", "properties": { "confirmed": { "description": "Buyers (customers or wallets) who reported a usable response in 7 days", "type": "number" }, "note": { "type": "string" }, "ourTestQueued": { "description": "Our own paid test is queued for this endpoint", "type": "boolean" }, "problems": { "description": "Buyers who reported a problem in 7 days", "type": "number" }, "windowDays": { "type": "number" } }, "required": [ "confirmed", "problems", "ourTestQueued", "windowDays", "note" ], "type": "object" }, "buyers": { "additionalProperties": false, "description": "Who is really behind the seller's buyers. Never changes the grade.", "properties": { "buyerWallets30d": { "description": "Buyer wallets that paid the seller in 30 days", "type": "number" }, "estimated": { "description": "true when counted from a sample of buyers", "type": "boolean" }, "flags": { "description": "coordinated_wallets, self_funded, concentrated_buyers, shared_operator, estimated, partial_lookup", "items": { "type": "string" }, "type": "array" }, "independentBuyers30d": { "description": "Independent buyers behind the seller's buyer wallets in 30 days (wallets funded from one source count as one)", "type": "number" }, "organicShare": { "description": "0-1: share of 30-day volume from independent buyers", "type": "number" }, "reviewed": { "description": "false until the seller's buyers have been reviewed (the biggest sellers are reviewed daily)", "type": "boolean" } }, "required": [ "reviewed" ], "type": "object" }, "declaredPayTo": { "description": "Payout wallets the seller declared itself", "items": { "type": "string" }, "type": "array" }, "delivery": { "type": "string" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "grade": { "type": "string" }, "gradeHeadline": { "description": "Why the endpoint has its grade, in one sentence", "type": "string" }, "gradeReasons": { "description": "Every factor behind the endpoint's grade (same as check_endpoint's reasons)", "items": { "additionalProperties": false, "properties": { "at": { "description": "Date of the event it's based on (YYYY-MM-DD)", "type": "string" }, "effect": { "description": "positive, neutral or negative", "type": "string" }, "factor": { "description": "data, delivery, uptime, speed, wallet, price, listing, values, access or withdrawn", "type": "string" }, "limit": { "description": "The ceiling this factor puts on the grade, e.g. \"F (max 39)\"", "type": "string" }, "text": { "description": "What we found, in plain words (paid-test results include the date and what came back)", "type": "string" } }, "required": [ "factor", "effect", "text" ], "type": "object" }, "type": "array" }, "intake": { "additionalProperties": false, "description": "For an endpoint we don't monitor yet: it's put in line for a first check, and joins the catalog within about 10 minutes if it answers a valid x402 payment quote", "properties": { "note": { "type": "string" }, "status": { "description": "queued | checking | monitored | rejected_recently | host_full | busy | invalid", "type": "string" } }, "required": [ "status", "note" ], "type": "object" }, "listing": { "additionalProperties": false, "description": "Present only when the latest paid response differs from the listing's example or schema. The data is delivered.", "properties": { "capped": { "description": "true: the data is reshaped vs the listing (nested, list vs item), grade capped at B; false: a minor gap, warning only", "type": "boolean" }, "matchesExample": { "description": "false: the paid response differs from the seller's own example", "type": "boolean" }, "sellerFix": { "description": "What the seller can change", "type": "string" }, "warning": { "description": "How the real response differs, and where to read the fields", "type": "string" } }, "required": [ "matchesExample", "warning", "sellerFix" ], "type": "object" }, "lookalike": { "additionalProperties": false, "description": "Present when this new endpoint looks like an imitation of an established seller (name one character off, lookalike characters, or a copied listing) and pays a different wallet. check_payment asks for review unless allowLookalike is true.", "properties": { "of": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "of", "reason" ], "type": "object" }, "monitored": { "description": "Whether the endpoint is in the monitored catalog", "type": "boolean" }, "notes": { "items": { "type": "string" }, "type": "array" }, "observed": { "anyOf": [ { "additionalProperties": false, "properties": { "amount": { "type": [ "string", "null" ] }, "assets": { "description": "Tokens this endpoint has been seen quoting", "items": { "type": "string" }, "type": "array" }, "network": { "type": [ "string", "null" ] }, "payTo": { "type": [ "string", "null" ] }, "seenAt": { "type": [ "string", "null" ] } }, "type": "object" }, { "type": "null" } ], "description": "The latest payment quote our monitor saw" }, "payToMode": { "type": "string" }, "reasons": { "description": "Why it was allowed or denied", "items": { "type": "string" }, "type": "array" }, "retest": { "additionalProperties": false, "description": "Present while our latest paid test failed and its re-test (about 2 hours later) hasn't run: the grade still shows the earlier result and changes only if the re-test fails too", "properties": { "firstFailureAt": { "type": "string" }, "moneyTaken": { "type": "boolean" }, "note": { "type": "string" }, "pending": { "type": "boolean" }, "reason": { "type": "string" }, "retestDueBy": { "type": "string" } }, "required": [ "pending", "firstFailureAt", "retestDueBy", "moneyTaken", "reason", "note" ], "type": "object" }, "reviewable": { "description": "Denied only for reasons a person may approve", "type": "boolean" }, "score": { "type": [ "number", "null" ] }, "url": { "type": "string" }, "values": { "additionalProperties": false, "description": "Automatic value checks on the latest paid response", "properties": { "checked": { "type": "boolean" }, "warning": { "type": "string" } }, "required": [ "checked" ], "type": "object" }, "verdict": { "description": "proceed | caution | avoid | free | insufficient_data", "type": [ "string", "null" ] }, "walletUnconfirmed": { "type": "number" } }, "required": [ "allow", "reasons", "monitored" ], "type": "object" } }, { "description": "Get instructions for buying the detailed paid report on one x402 endpoint (score breakdown, current price quote, wallet and price history, test-payment results). Returns the report URL, price, and network; it doesn't buy the report itself. The report is an x402 endpoint that your agent pays with any x402 client. Use it only when the free check_endpoint result isn't enough and the user wants the full history. The response also lists the other paid x402 checks (wallet risk, batch grades, watch alerts), paid the same way. Endpoints we don't monitor return 404 on the report URL and are never charged. API docs: https://github.com/Book0fEli/lumiere-paycheck/blob/main/docs/api.md", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "url": { "description": "Full URL of the x402 endpoint you want the paid report for, including path", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "get_full_report", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "available": { "description": "false when paid reports aren't enabled", "type": "boolean" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "network": { "type": "string" }, "note": { "type": "string" }, "otherPaidChecks": { "description": "Other pay-per-call x402 checks, paid the same way", "items": { "additionalProperties": false, "properties": { "price": { "type": "string" }, "request": { "type": "string" }, "what": { "type": "string" } }, "required": [ "what", "request", "price" ], "type": "object" }, "type": "array" }, "payment": { "type": "string" }, "price": { "type": "string" }, "reportUrl": { "description": "Request this URL with an x402 client to buy the report", "type": "string" } }, "type": "object" } }, { "description": "List the sellers behind the monitored x402 endpoints, grouped by domain, with each seller's endpoint count, verdict mix (proceed, caution, avoid, free, insufficient_data, bulk_listing), passing and paid-tested counts, and best grade. Use it to find which providers have trustworthy endpoints, search a provider by domain, or see who has endpoints to avoid. Open one seller's endpoints with seller_endpoints; for a single endpoint use check_endpoint. Read-only and free; the same data as lumierepaycheck.org/sellers, refreshed every few minutes.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "includeBulk": { "description": "Include sellers listing thousands of near-identical endpoints (default true)", "type": "boolean" }, "limit": { "description": "Sellers per page, 1-50 (default 20)", "maximum": 50, "minimum": 1, "type": "integer" }, "offset": { "description": "Skip this many sellers, for paging (default 0)", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "query": { "description": "Part of a seller's domain to search for, e.g. 'weather' or 'x402node.dev'", "maxLength": 200, "type": "string" }, "sort": { "description": "Order: most endpoints (default), most passing, most paid-tested, most to avoid, or by name", "enum": [ "endpoints", "passing", "paid_tested", "avoid", "name" ], "type": "string" }, "verdict": { "description": "Only sellers with at least one endpoint in this verdict (sorted by how many they have in it)", "enum": [ "proceed", "caution", "avoid", "free", "insufficient_data", "bulk_listing" ], "type": "string" } }, "type": "object" }, "name": "list_sellers", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "error": { "type": "string" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "limit": { "type": "number" }, "matching": { "description": "Sellers matching the filters", "type": "number" }, "offset": { "type": "number" }, "sellers": { "items": { "additionalProperties": false, "properties": { "bestEndpoint": { "description": "The seller's best-graded endpoint", "type": [ "string", "null" ] }, "bestGrade": { "type": [ "string", "null" ] }, "bulkLister": { "description": "Lists thousands of near-identical endpoints", "type": "boolean" }, "byVerdict": { "additionalProperties": { "type": "number" }, "description": "Endpoint count per verdict", "propertyNames": { "type": "string" }, "type": "object" }, "endpoints": { "type": "number" }, "host": { "description": "Seller domain", "type": "string" }, "paidTested": { "description": "Endpoints where a real test payment was delivered", "type": "number" }, "passing": { "description": "proceed + caution", "type": "number" } }, "required": [ "host", "endpoints", "byVerdict", "passing", "paidTested", "bestGrade", "bestEndpoint", "bulkLister" ], "type": "object" }, "type": "array" }, "totalEndpoints": { "type": "number" }, "totalSellers": { "type": "number" } }, "type": "object" } }, { "description": "Get the signed receipts for our real test payments to one x402 endpoint: the exact payment terms we paid and the response we got (as SHA-256 hashes), amount quoted and paid, payout wallet, HTTP status, result and time, signed with our published Ed25519 key. Use it when a user or agent wants evidence behind a grade instead of the grade alone; check_endpoint gives the grade itself. The tester wallet and transaction appear only after that test wallet is retired (until then a hash commits to them). Read-only and free; receipts exist for tests since Nov 7, 2026.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "description": "How many receipts, newest first, 1-50 (default 10)", "maximum": 50, "minimum": 1, "type": "integer" }, "url": { "description": "Full URL of the x402 endpoint, including path", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "paid_test_receipts", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "count": { "type": "number" }, "docs": { "type": "string" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "howToVerify": { "type": "string" }, "keys": { "description": "JWKS with the public key", "type": "string" }, "kid": { "type": "string" }, "monitored": { "type": "boolean" }, "receipts": { "items": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "outcome": { "type": "string" }, "payload": { "additionalProperties": {}, "description": "The decoded signed fields: url, amounts, payTo, termsHash, responseHash, httpStatus, outcome, testedAt, commitment", "propertyNames": { "type": "string" }, "type": "object" }, "receipt": { "description": "The signed receipt: <body>.<signature>, Ed25519", "type": "string" }, "refunded": { "description": "The seller refunded a failed test", "type": "boolean" }, "revealed": { "anyOf": [ { "additionalProperties": false, "properties": { "payer": { "type": "string" }, "salt": { "type": "string" }, "tx": { "type": [ "string", "null" ] } }, "required": [ "payer", "tx", "salt" ], "type": "object" }, { "type": "null" } ], "description": "Payer, transaction and salt, once that test wallet is retired; null before" }, "testedAt": { "type": "string" } }, "required": [ "id", "testedAt", "outcome", "receipt", "payload", "revealed", "refunded" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "type": "object" } }, { "description": "Get the live x402 reliability numbers from our own paid tests over the last 30 days: how many endpoints delivered once paid, how often payments didn't go through, how many bad calls still charged the buyer and how many were refunded, why paid calls fail, what calls cost, and the sellers that refund failed calls. Includes the same numbers from about 30 days earlier when available. Use it to answer questions about x402 reliability as a whole or which sellers refund; for one endpoint use check_endpoint, for one seller seller_endpoints. Read-only and free; recomputed every 6 hours. The same data is at lumierepaycheck.org/reliability.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "refunders": { "description": "How many sellers that refund to list, most refunds first (default 10)", "maximum": 50, "minimum": 0, "type": "integer" } }, "type": "object" }, "name": "reliability_report", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "attempts": { "description": "Paid tests in the window", "type": "number" }, "badCalls": { "additionalProperties": false, "properties": { "charged": { "type": "number" }, "chargedPct": { "type": [ "number", "null" ] }, "refunded": { "type": "number" }, "refundedPct": { "type": [ "number", "null" ] }, "total": { "type": "number" } }, "required": [ "total", "charged", "refunded", "chargedPct", "refundedPct" ], "type": "object" }, "badReasons": { "items": { "additionalProperties": false, "properties": { "n": { "type": "number" }, "reason": { "type": "string" } }, "required": [ "reason", "n" ], "type": "object" }, "type": "array" }, "data": { "type": "string" }, "deliveredPct": { "description": "Share of endpoints whose latest graded paid test delivered", "type": [ "number", "null" ] }, "endpoints": { "type": "number" }, "error": { "type": "string" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "generatedAt": { "type": "string" }, "page": { "type": "string" }, "paidUsd": { "type": "number" }, "paymentFailedPct": { "description": "Share of attempts where the payment didn't go through", "type": [ "number", "null" ] }, "ready": { "type": "boolean" }, "sellers": { "type": "number" }, "sellersThatRefund": { "items": { "additionalProperties": false, "properties": { "failedCharged": { "type": "number" }, "host": { "type": "string" }, "lastRefundAt": { "type": [ "string", "null" ] }, "refunded": { "type": "number" } }, "required": [ "host", "failedCharged", "refunded", "lastRefundAt" ], "type": "object" }, "type": "array" }, "settled": { "description": "Payments that settled", "type": "number" }, "thirtyDaysAgo": { "anyOf": [ { "additionalProperties": false, "properties": { "chargedPct": { "type": [ "number", "null" ] }, "day": { "type": "string" }, "deliveredPct": { "type": [ "number", "null" ] }, "paymentFailedPct": { "type": [ "number", "null" ] }, "refundedPct": { "type": [ "number", "null" ] } }, "required": [ "day", "deliveredPct", "paymentFailedPct", "chargedPct", "refundedPct" ], "type": "object" }, { "type": "null" } ] }, "windowDays": { "type": "number" } }, "type": "object" } }, { "description": "After paying an x402 endpoint, report whether you got what you paid for. Free, optional, and open to every agent: send the receipt from a Lumière PayCheck allow decision (paid plans), or the endpoint url plus the payment's transaction hash (anyone; we verify the payment on-chain, Base or Solana, within 24 hours). Answer the short questions in answers: gotResponse, matchedListing (yes/partly/no), charged (as_quoted/more/twice), dataUsable (yes/unsure/no), wouldPayAgain. Reports never change a grade by themselves: confirmations from independent buyers move the endpoint up our paid-test queue, and serious problems (nothing came back, charged more or twice) trigger a re-test; only our own paid test changes the grade. One report per payment; the seller's own wallet can't report on itself.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "answers": { "properties": { "charged": { "description": "Were you charged the quoted amount, once?", "enum": [ "as_quoted", "more", "twice" ], "type": "string" }, "dataUsable": { "description": "Did the data look real and usable?", "enum": [ "yes", "unsure", "no" ], "type": "string" }, "gotResponse": { "description": "Did you get a response after paying?", "type": "boolean" }, "matchedListing": { "description": "Did it match what the listing promised?", "enum": [ "yes", "partly", "no" ], "type": "string" }, "wouldPayAgain": { "description": "Would you pay this endpoint again?", "type": "boolean" } }, "type": "object" }, "httpStatus": { "description": "HTTP status the endpoint returned after payment, e.g. 200 or 500", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "outcome": { "description": "Optional shortcut instead of answers: delivered = usable; problem = error, empty, wrong or overcharged", "enum": [ "delivered", "problem" ], "type": "string" }, "problems": { "description": "Short descriptions, e.g. 'missing field price', 'HTTP 500'", "items": { "type": "string" }, "type": "array" }, "receipt": { "description": "The receipt from a Lumière PayCheck 'allow' decision (paid plans). Or send url + tx instead.", "type": "string" }, "tx": { "description": "The payment's transaction hash (Base 0x...) or Solana signature", "type": "string" }, "url": { "description": "The endpoint you paid (with tx, when you have no receipt)", "type": "string" } }, "type": "object" }, "name": "report_outcome", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "accepted": { "description": "Whether the report was recorded", "type": "boolean" }, "flagged": { "description": "no_response, overcharged or double_charged: sent privately to the operator for an immediate re-test", "type": "string" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "network": { "type": "string" }, "ourTestQueued": { "description": "Our own paid test of this endpoint is queued (buyer confirmations or problem reports moved it up)", "type": "boolean" }, "outcome": { "type": "string" }, "overcharge": { "description": "Present when the on-chain payment was higher than any quote we saw", "type": "string" }, "paid": { "description": "Amount paid on-chain, atomic units", "type": "string" }, "reason": { "description": "Why it wasn't accepted", "type": "string" }, "retestQueued": { "description": "A paid re-test was queued because of reports", "type": "boolean" }, "thanks": { "type": "string" }, "url": { "type": "string" }, "verifiedOnChain": { "description": "The payment was found on-chain (reports sent with tx instead of a receipt)", "type": "boolean" } }, "required": [ "accepted" ], "type": "object" } }, { "description": "List one seller's monitored x402 endpoints with each one's grade, score, verdict, 7-day uptime, median response time, whether a real test payment was delivered, and how many checks it's based on, plus the seller's counts per verdict and its refund record (how many of our failed paid calls it refunded in the last 30 days). Use it after list_sellers to pick the best endpoint from a provider, or to see which of a seller's endpoints to avoid. For the full reasons behind one endpoint's grade use check_endpoint. Read-only and free; 50 endpoints per page at most.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "host": { "description": "The seller's domain, e.g. api.example.com (a full URL works too)", "maxLength": 253, "minLength": 1, "type": "string" }, "limit": { "description": "Endpoints per page, 1-50 (default 50)", "maximum": 50, "minimum": 1, "type": "integer" }, "offset": { "description": "Skip this many endpoints, for paging (default 0)", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "query": { "description": "Part of the endpoint URL to search for, e.g. a path like '/weather'", "maxLength": 200, "type": "string" }, "sort": { "description": "Order: by URL (default), best score first, or worst score first", "enum": [ "url", "grade", "worst" ], "type": "string" }, "verdict": { "description": "Only endpoints with this verdict", "enum": [ "proceed", "caution", "avoid", "free", "insufficient_data", "bulk_listing" ], "type": "string" } }, "required": [ "host" ], "type": "object" }, "name": "seller_endpoints", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "counts": { "additionalProperties": { "type": "number" }, "description": "All of the seller's endpoints per verdict", "propertyNames": { "type": "string" }, "type": "object" }, "endpoints": { "items": { "additionalProperties": false, "properties": { "checks": { "description": "Checks in the last 7 days", "type": "number" }, "grade": { "type": "string" }, "medianLatencyMs": { "type": [ "number", "null" ] }, "paidTested": { "type": "boolean" }, "score": { "type": [ "number", "null" ] }, "uptimePct": { "type": "number" }, "url": { "type": "string" }, "verdict": { "description": "proceed | caution | avoid | free | insufficient_data | bulk_listing", "type": "string" } }, "required": [ "url", "grade", "score", "verdict", "paidTested" ], "type": "object" }, "type": "array" }, "error": { "type": "string" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" }, "host": { "type": "string" }, "limit": { "type": "number" }, "offset": { "type": "number" }, "refunds": { "additionalProperties": false, "description": "The seller's refund record from our paid tests (v1.78.0)", "properties": { "failedCharged": { "description": "Our paid tests on this seller that failed after charging", "type": "number" }, "lastRefundAt": { "type": [ "string", "null" ] }, "refunded": { "description": "How many of those the seller refunded on-chain", "type": "number" }, "windowDays": { "type": "number" } }, "required": [ "windowDays", "failedCharged", "refunded", "lastRefundAt" ], "type": "object" }, "total": { "description": "Endpoints matching the filters", "type": "number" } }, "type": "object" } }, { "description": "List the x402 endpoints that are currently safest to pay (verdict proceed or caution, no payout-wallet incidents), best first, with score, grade, verdict, and whether a real test payment was delivered. Use it to discover reliable endpoints or pick between providers. To evaluate one specific endpoint use check_endpoint; to approve a payment use check_payment. Read-only and free; rankings update as monitoring runs (every 30 minutes).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "description": "How many endpoints to return, 1-50 (default 10)", "maximum": 50, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "top_endpoints", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "count": { "type": "number" }, "endpoints": { "description": "Best first", "items": { "additionalProperties": false, "properties": { "delivery": { "type": "string" }, "grade": { "type": "string" }, "score": { "type": [ "number", "null" ] }, "url": { "type": "string" }, "verdict": { "description": "proceed | caution | avoid | free | insufficient_data", "type": "string" } }, "required": [ "url", "score", "grade", "verdict", "delivery" ], "type": "object" }, "type": "array" }, "forTeams": { "additionalProperties": false, "description": "Short note about team plans (per-agent keys, spend limits, audit trail)", "properties": { "enterprise": { "description": "Private enterprise inquiry form", "type": "string" }, "freeKey": { "type": "string" }, "message": { "type": "string" }, "plans": { "type": "string" }, "url": { "description": "Plans and checkout", "type": "string" } }, "required": [ "message", "plans", "url", "enterprise" ], "type": "object" } }, "required": [ "count", "endpoints" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:4afbdb845f6d12635c6562aad99cf1a0ec1ec2d44dc437acaff9e5810c2c47a0 | sha256sum