Endpoints: 76,849MCP servers: 32,728Payout addresses: 3,825Paid calls: 6,138Letters: 84Defects: 3,890counted 3 min ago
teppi

Server definition

Hash
sha256:5fe4721241631d16d9ae4dbdcc0aa9a8596b7b2f8e97f5577fe36b6ed9c5b9a8
What it is
What a remote MCP server returned when asked what it offers: 18 tools

The blob, as servednamed by its sha256

{ "instructions": "Check an x402 endpoint before your agent pays it. Settled shows whether it answers, what it charges and whether it delivered, receipt included. Before paying an unfamiliar endpoint, call settled_check with its URL (free: 25 calls a day per address, 300 with a payer record, no cap with a pass) or settled_preflight (needs a day pass) and compare the payTo in the endpoint's 402 quote with the pay_to Settled reports; do not pay an endpoint whose recommendation is avoid (both tools carry one, with reasons); weigh the reasons behind caution, and unknown means Settled has nothing on record yet. settled_find_endpoints lists live endpoints by keyword, network and price. After paying, settled_report records whether the call worked. A day pass (POST https://settled.tools/v1/pass, $0.05 over x402) removes the daily cap: send it as the x-settled-pass header or the pass argument. Every answer is signed; settled_verify checks a signature. To check every payment in code, use the npm package settled-x402.", "tools": [ { "description": "Free: 25 calls/day per address, 300 with a payer record (free, keyed to your wallet), no daily cap with a pass. Check an x402 endpoint before paying it, from Settled’s index (cached up to 5 min): status, payability, latency, parsed price/network/payTo, payee on-chain history, the scout’s last real purchase, paying agents’ reports, seller claim, quality breakdown and risk flags, with a recommendation (pay, caution, avoid or unknown) and its reasons. Use when: deciding whether to call an endpoint, and for routine re-checks. Not for: a fresh probe right now (settled_preflight) or searching (settled_find_endpoints). If status is unknown, call settled_submit; after paying, call settled_report.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "force": { "description": "true to probe now instead of using the 5-minute cache; needs a pass", "type": "boolean" }, "pass": { "description": "Settled day pass token: lifts the free daily cap; or send it as the x-settled-pass header", "type": "string" }, "payer_token": { "description": "A Settled payer token (x4t_…, from POST /x401/token with your payer record): the free tier then follows your wallet, 300 a day, through any gateway", "type": "string" }, "url": { "description": "Full URL of the x402 endpoint, e.g. https://api.example.com/search", "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "settled_check", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "asset": { "description": "Asset of the cheapest option" }, "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "cached": { "description": "Whether this came from Settled's 5-minute cache" }, "checked_at": { "description": "When this answer was built" }, "delivery_receipt": { "description": "The scout's last purchase, with its settlement transaction and checks (when the scout has bought it)" }, "delivery_verified": { "description": "Whether a real payment by Settled's scout came back with content" }, "description": { "description": "The listing's description" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "evidence": { "description": "The grade of the evidence and the receipt line first: grade purchased (Settled paid this endpoint and compared what came back with the listing; receipt has the amount, day, bytes, listing verdict and Base transaction) or observed (live probes, payTo history and agent reports only; the scout buys and the ledger reads on Base, so an endpoint on another network is observed only)" }, "first_seen": { "description": "When Settled first saw it" }, "flags": { "description": "Risk flags" }, "http_status_last": { "description": "HTTP status of the latest probe" }, "last_delivery_at": { "description": "When the scout last bought it" }, "last_ok_at": { "description": "When it last answered with a valid quote" }, "last_probe_at": { "description": "When Settled last probed it" }, "latency_ms": { "description": "Latency of the latest probe" }, "network": { "description": "Network of the cheapest option (CAIP-2)" }, "network_name": { "description": "Readable network name" }, "onchain": { "description": "Settlements and unique payers over the last 30 days" }, "pay_to": { "description": "The payTo Settled's probe sees; compare it with the quote you are about to pay" }, "payability": { "description": "Payability verdict and the verb that pays" }, "payee": { "description": "Whether the payTo has on-chain history" }, "price_usd": { "description": "Price per call in USD (cheapest option)" }, "quality": { "description": "Quality score breakdown" }, "reasons": { "description": "Why, one line each; the first positive one is the scout's receipt when there is one" }, "recommendation": { "description": "pay, caution, avoid or unknown: avoid means money at risk (sanctioned or clone-farm payee, a purchase that did not deliver, a honeypot, agents' reports); caution includes an endpoint Settled could not get a quote from, which your own 402 outweighs (compare its payTo with pay_to); unknown means no quote on record and nothing against it" }, "reports": { "description": "Paying agents' reports" }, "scheme": { "description": "Payment scheme, e.g. exact" }, "seller_alerts": { "description": "Only when the caller's payer record is the claimed wallet: that seller's own Seller Watch alerts (down_now, new_24h, latest, feed)" }, "seller_claim": { "description": "The seller's claim and profile, if claimed" }, "service_name": { "description": "The listing's service name" }, "status": { "description": "Endpoint status, e.g. live, degraded, dead, free, auth_gated, not_found or quote_invalid" }, "url": { "description": "The endpoint" }, "verifier": { "description": "The verdict in the x402 Foundation Domain Discovery working group’s draft verifier schema: verdict (true|false|inconclusive), a reason code from its closed set, evidence (none|terms|probe|purchase; purchase_by verifier when Settled bought), the quote’s digest, and an attestation with the key URL, a signed record URL, the two domains compared, valid_until and the relationship disclosure; method_digest pins the method document (/verifier-method.md)" }, "x402_version": { "description": "x402 version of the quote" } }, "type": "object" } }, { "description": "Free. For sellers: claim every x402 endpoint paid to your wallet with one signature, on every host, so your name, website, contact and docs show next to them (plus a 10-day Seller Watch trial). Use when: you operate x402 endpoints. Not for: buyers or third parties; only the payTo wallet can sign. Flow: call with wallet and profile to get message_to_sign and issued_at; sign with that wallet; call again with issued_at and signature. action=remove withdraws a claim (reversible by claiming again). Claims never change scores.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "action": { "description": "claim (default) or remove to withdraw an existing claim", "enum": [ "claim", "remove" ], "type": "string" }, "contact": { "description": "Where Seller Watch alerts go, strongly recommended: an email address ([email protected]), or an https URL that receives each alert as a signed JSON POST (a webhook). Without one, alerts reach you only through the feed, your access log and answers to your own agent", "maxLength": 200, "type": "string" }, "docs": { "description": "Your API documentation, as a full https URL", "format": "uri", "type": "string" }, "issued_at": { "description": "The issued_at timestamp returned by the first call; send it back unchanged with the signature", "type": "string" }, "name": { "description": "Seller name to show on your endpoints, up to 80 characters, e.g. Acme Data", "maxLength": 80, "type": "string" }, "signature": { "description": "Signature of message_to_sign by the wallet: EIP-191 personal_sign (0x hex) on Base, ed25519 (base58) on Solana; omit on the first call", "type": "string" }, "wallet": { "description": "The payTo wallet your endpoints are paid to: 0x + 40 hex characters on Base, or a base58 address on Solana", "maxLength": 64, "minLength": 32, "type": "string" }, "website": { "description": "Your website, as a full https URL", "format": "uri", "type": "string" } }, "required": [ "wallet" ], "type": "object" }, "name": "settled_claim", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "badge": { "description": "Once claimed: the next step. The seller badge and up to 10 endpoint badges with markdown and html snippets filled in, to paste where buyers look" }, "claimed": { "description": "true once the claim is recorded" }, "covers": { "description": "The endpoints and hosts the claim covers" }, "error": { "description": "signature_required on the first call (sign message_to_sign and call again), or why the claim was refused" }, "issued_at": { "description": "Timestamp to send back with the signature" }, "message_to_sign": { "description": "The exact message to sign with the wallet" }, "network": { "description": "The wallet's network" }, "note": { "description": "What the claim does" }, "profile": { "description": "The published profile: name, website, contact, docs" }, "removed": { "description": "true once a claim is withdrawn" }, "wallet": { "description": "The wallet" }, "would_cover": { "description": "The endpoints and hosts the claim would cover" } }, "type": "object" } }, { "description": "Free: 25 calls/day per address, 300 with a payer record, no daily cap with a pass. Recent changes worth acting on: venue verdict flips, new suspected honeypots, settlement-integrity changes, newest first. Use when: your agent runs on a schedule and wants to react to what changed since last time. Not for: the full picture (settled_income_venues) or endpoint-level changes (settled_watch). Poll this instead of re-reading the scorecard.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "description": "How many events to return, newest first, 1-200 (default 50)", "maximum": 200, "minimum": 1, "type": "integer" }, "pass": { "description": "Settled day pass token: lifts the free daily cap; or send it as the x-settled-pass header", "type": "string" }, "payer_token": { "description": "A Settled payer token (x4t_…, from POST /x401/token with your payer record): the free tier then follows your wallet, 300 a day, through any gateway", "type": "string" } }, "type": "object" }, "name": "settled_events", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "count": { "description": "Number of events returned" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "events": { "description": "Changes newest first: venue verdict flips, new suspected honeypots, settlement-integrity changes" }, "generated_at": { "description": "When this list was built" } }, "type": "object" } }, { "description": "Free up to 50 calls/day per client (a pass allows 1,000). Live endpoints matching every word of q (in the URL, name, tags or description), best match first, then by quality, price, latency or payers; filter by network and max price; each with payability and delivery verification. Use when: you need an x402 endpoint for a capability and want candidates that are live, payable and, where possible, proven to deliver. Not for: verifying one known URL (settled_check). After: run settled_check or settled_preflight on the one you pick before paying.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "description": "How many endpoints to return, 1-50 (default 20)", "maximum": 50, "minimum": 1, "type": "integer" }, "max_price": { "description": "Highest price per call in USD, e.g. 0.01", "minimum": 0, "type": "number" }, "network": { "description": "Only endpoints on this network, as a CAIP-2 id, e.g. eip155:8453 for Base", "type": "string" }, "pass": { "description": "Settled day pass token: lifts the free daily cap; or send it as the x-settled-pass header", "type": "string" }, "payer_token": { "description": "A Settled payer token (x4t_…, from POST /x401/token with your payer record): the free tier then follows your wallet, 300 a day, through any gateway", "type": "string" }, "q": { "description": "One to four words every result must match in its URL, name, tags or description, e.g. weather forecast or gift cards; filler words (api, x402, endpoint) are ignored", "type": "string" }, "sort": { "description": "Order of results: quality (default), price, latency or payers", "enum": [ "quality", "price", "latency", "payers" ], "type": "string" }, "status": { "description": "Only endpoints with this status; live (default) or any for every status", "enum": [ "live", "degraded", "dead", "free", "auth_gated", "not_found", "quote_invalid", "unknown", "any" ], "type": "string" } }, "type": "object" }, "name": "settled_find_endpoints", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "count": { "description": "Number of endpoints returned" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "filters": { "description": "The filters applied" }, "generated_at": { "description": "When this list was built" }, "items": { "description": "Ranked endpoints, each with payability and delivery status" } }, "type": "object" } }, { "description": "Pass required. Fetches a bounty issue, repository or listing page and scans it for patterns used to bait agents (hidden HTML-comment instructions, prompt injection, credential requests, fork/star anomalies, dead or archived repos, reward anomalies). Returns trust, label and every flag with its reason. Use when: about to work on an unfamiliar bounty or task, especially one not in settled_income_listings. Not for: x402 API endpoints (settled_check). Treat a suspected_honeypot label as do-not-work; a clean result is not a promise of payment.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "pass": { "description": "Settled day pass token, if you did not send it as the x-settled-pass header", "type": "string" }, "url": { "description": "URL of the bounty issue, repository or listing page to scan", "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "settled_income_check", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "flags": { "description": "Every flag found, with its reason" }, "indexed": { "description": "Settled's listing for this URL, if it has one" }, "label": { "description": "verified_paying, unverified, gated, suspected_honeypot, dead or closed_to_agents" }, "note": { "description": "How to read the result" }, "repo": { "description": "Repository facts, for GitHub links" }, "scanned_at": { "description": "When the scan ran" }, "source": { "description": "What was scanned, e.g. page_text" }, "trust": { "description": "Trust score 0-100" }, "url": { "description": "The page scanned" } }, "type": "object" } }, { "description": "Pass required. Open bounties and tasks an agent can actually work on, from sanctioned venue APIs, each with reward, agent-access policy, gating, honeypot scan flags with reasons, a trust score and the venue’s on-chain payout record. Use when: an agent is looking for work it is allowed to do. Not for: venue-level questions (settled_income_venues). Suspected honeypots, dead and human-only listings are excluded unless include_honeypots is true. Before working one, run settled_income_check on its URL.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "agent_access": { "description": "allowed (default) for listings agents may take, or any to include human-only ones", "enum": [ "allowed", "any" ], "type": "string" }, "include_honeypots": { "description": "true to include suspected honeypots and dead listings", "type": "boolean" }, "limit": { "description": "How many listings to return, 1-50 (default 20)", "maximum": 50, "minimum": 1, "type": "integer" }, "min_reward": { "description": "Smallest reward to include, in USD, e.g. 50", "minimum": 0, "type": "number" }, "pass": { "description": "Settled day pass token, if you did not send it as the x-settled-pass header", "type": "string" }, "rail": { "description": "Only listings paid on this rail, e.g. usdc-base", "enum": [ "usdc-base", "usdc-solana", "crypto", "fiat", "mixed", "unknown" ], "type": "string" }, "sort": { "description": "Order of results: trust (default), reward or recent", "enum": [ "trust", "reward", "recent" ], "type": "string" }, "venue": { "description": "Only listings from this venue, by its slug from settled_income_venues, e.g. superteam-earn", "pattern": "^[a-z0-9-]{2,40}$", "type": "string" } }, "type": "object" }, "name": "settled_income_listings", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "count": { "description": "Number of listings returned" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "filters": { "description": "The filters applied" }, "generated_at": { "description": "When this list was built" }, "items": { "description": "Open bounties and tasks with reward, agent access, gating, honeypot flags, trust score and the venue's payout record" }, "label_vocabulary": { "description": "The possible listing labels" } }, "type": "object" } }, { "description": "Free. Scorecard of bounty boards, task markets, audit contests and the x402 sell-side: verdict (paying / paying small / measuring / no payouts seen / unmeasured / closed to agents / defunct), agent policy, gating (KYC, human claim, self-custody wallet), open listings and on-chain payouts. Use when: choosing where an agent should look for paid work, or checking whether a venue actually pays. Not for: individual listings (settled_income_listings) or x402 endpoints (settled_find_endpoints). Poll settled_events for changes instead of re-reading this.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": {}, "type": "object" }, "name": "settled_income_venues", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "count": { "description": "Number of venues" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "generated_at": { "description": "When this list was built" }, "venues": { "description": "Each venue with its verdict, agent policy, gating, open listings and on-chain payouts" }, "verdict_vocabulary": { "description": "The possible verdicts" } }, "type": "object" } }, { "description": "Free, rate-limited. Coarse status and quality score for one x402 endpoint URL, from the index only (no fresh probe). Use when: you only need a quick yes/no on whether Settled knows the URL and its last status. Not for: deciding whether to pay — use settled_check (free, fuller) or settled_preflight (paid, fresh). If the URL is unknown, call settled_submit, then check again later.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "url": { "description": "Full URL of the x402 endpoint, e.g. https://api.example.com/search", "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "settled_peek", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "detail": { "description": "Where to get the full check" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "last_probe_at": { "description": "When Settled last probed it" }, "quality": { "description": "Quality score 0-100" }, "seller_claimed": { "description": "Whether the seller has claimed it" }, "status": { "description": "Endpoint status, e.g. live, degraded, dead, free, auth_gated, not_found or quote_invalid" }, "url": { "description": "The endpoint" } }, "type": "object" } }, { "description": "Pass required. The call to make right before paying an unfamiliar x402 endpoint: a fresh probe, parsed quote, payability, payTo on-chain history, seller integrity, the scout’s real-payment delivery result and a honeypot scan, as one signed answer with a recommendation (pay, caution or avoid) and reasons. Use when: real money is about to leave your wallet and settled_check was stale or not enough. Not for: browsing (settled_find_endpoints) or endpoints you already verified. After: compare pay_to and price with the 402 you receive, pay, then call settled_report.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "force": { "description": "true to probe the endpoint now instead of reusing a result up to 5 minutes old", "type": "boolean" }, "pass": { "description": "Settled day pass token, if you did not send it as the x-settled-pass header", "type": "string" }, "payer_token": { "description": "Optional. A Settled payer token (x4t_…) for your own wallet: when that wallet is the endpoint's claimed seller, the answer carries seller_alerts, your Seller Watch alerts", "type": "string" }, "url": { "description": "Full URL of the x402 endpoint, e.g. https://api.example.com/search", "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "settled_preflight", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "cached": { "description": "Whether the probe came from Settled's 5-minute cache" }, "checked_at": { "description": "When this check ran" }, "delivery": { "description": "The scout's last real purchase and whether it matched the listing" }, "description": { "description": "The listing's description" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "flags": { "description": "Risk flags" }, "honeypot": { "description": "Honeypot scan of the listing text" }, "liveness": { "description": "Fresh probe results" }, "onchain": { "description": "Settlements and unique payers over the last 30 days" }, "payability": { "description": "Payability verdict and the verb that pays" }, "payee": { "description": "Whether the payTo exists on-chain, and the seller's other endpoints and settlement integrity" }, "quality": { "description": "Quality score breakdown" }, "quote": { "description": "The parsed 402 quote Settled sees: network, asset, price_usd, pay_to" }, "reasons": { "description": "Why, in plain words" }, "recommendation": { "description": "pay, caution or avoid" }, "reports": { "description": "Paying agents' reports" }, "seller_alerts": { "description": "Only when the caller's payer record is the claimed wallet: that seller's own Seller Watch alerts (down_now, new_24h, latest, feed)" }, "seller_claim": { "description": "The seller's claim and profile, if claimed" }, "url": { "description": "The endpoint" }, "verifier": { "description": "The verdict in the x402 Foundation Domain Discovery working group’s draft verifier schema: verdict (true|false|inconclusive), a reason code from its closed set, evidence (none|terms|probe|purchase; purchase_by verifier when Settled bought), the quote’s digest, and an attestation with the key URL, a signed record URL, the two domains compared, valid_until and the relationship disclosure; method_digest pins the method document (/verifier-method.md)" } }, "type": "object" } }, { "description": "Free. After paying an x402 endpoint on Base, tell Settled whether you got what you paid for. Use when: your agent has just made a real USDC payment and has the transaction hash. Not for: endpoints you did not pay, or payments on other chains. Flow: call without signature to get message_to_sign; sign it with the paying wallet (EIP-191 personal_sign); call again with signature. One report per payment, one vote per wallet per endpoint; Settled keeps only per-endpoint tallies.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "ok": { "description": "true if the call delivered what you paid for, false if it did not", "type": "boolean" }, "signature": { "description": "EIP-191 personal_sign of message_to_sign by the wallet that paid (0x + 130 hex characters); omit on the first call to get message_to_sign", "pattern": "^0x[0-9a-fA-F]{130}$", "type": "string" }, "tx": { "description": "Transaction hash of your USDC payment to that endpoint on Base, from the last 30 days: 0x followed by 64 hex characters, e.g. 0x3f9a...c21e", "pattern": "^0x[0-9a-fA-F]{64}$", "type": "string" }, "url": { "description": "The x402 endpoint you paid", "format": "uri", "type": "string" } }, "required": [ "url", "tx", "ok" ], "type": "object" }, "name": "settled_report", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "accepted": { "description": "true once the report is recorded" }, "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "error": { "description": "signature_required when no signature was given (sign message_to_sign and call again), or why the report was refused" }, "message_to_sign": { "description": "The exact message to sign with the paying wallet" }, "ok": { "description": "Your verdict, as recorded" }, "paid_at": { "description": "When your payment was made" }, "paid_usd": { "description": "What your transaction paid the endpoint, in USD" }, "privacy": { "description": "What Settled keeps about you" }, "reports": { "description": "This endpoint's report tallies" }, "url": { "description": "The endpoint" } }, "type": "object" } }, { "description": "Pass required. Everything Settled knows about one payTo address: the endpoints it is paid for, live/dead counts, price range, clone-farm and quote-only flags, on-chain settlements and unique payers. Use when: several endpoints share a seller and you want to judge the seller rather than one URL, or a payTo looks unfamiliar. Not for: a single endpoint’s status (settled_check). Input is the wallet address from a 402 quote.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "address": { "description": "The payTo address from a 402 quote: 0x followed by 40 hex characters (Base)", "pattern": "^0x[0-9a-fA-F]{40}$", "type": "string" }, "pass": { "description": "Settled day pass token, if you did not send it as the x-settled-pass header", "type": "string" }, "payer_token": { "description": "Optional. A Settled payer token (x4t_…) for your own wallet: when it is this claimed wallet, the answer carries seller_alerts, your Seller Watch alerts", "type": "string" } }, "required": [ "address" ], "type": "object" }, "name": "settled_seller_reputation", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "address": { "description": "The payTo address" }, "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "claim": { "description": "The seller's claim and profile, if claimed" }, "dead": { "description": "How many are dead" }, "endpoints": { "description": "Endpoints paid to it" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "first_seen": { "description": "When Settled first saw one" }, "flags": { "description": "Seller flags such as clone_farm or quote_only" }, "generated_at": { "description": "When this answer was built" }, "hosts": { "description": "Hosts serving them" }, "live": { "description": "How many are live" }, "onchain": { "description": "On-chain settlements and unique payers" }, "price_range_usd": { "description": "Lowest and highest price" }, "seller_alerts": { "description": "Only when the caller's payer record is this claimed wallet: its own Seller Watch alerts" }, "settlement_integrity": { "description": "Whether paid activity looks organic or self-generated" }, "top_endpoints": { "description": "Its main endpoints" } }, "type": "object" } }, { "description": "Free. Sellers who proved control of the wallet their x402 endpoints are paid to, with their published profile and endpoint counts. Use when: you want a contact or docs link for a seller, or to see which sellers stand behind their endpoints. Not for: judging an endpoint’s quality (claims never change scores; use settled_check). Paged: limit (max 50) and offset, with a total.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "description": "How many sellers to return, 1-50 (default 25)", "maximum": 50, "minimum": 1, "type": "integer" }, "offset": { "description": "How many sellers to skip, for paging (default 0)", "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "type": "object" }, "name": "settled_sellers", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "generated_at": { "description": "When this list was built" }, "limit": { "description": "Page size used" }, "note": { "description": "What a claim proves" }, "offset": { "description": "Offset used" }, "sellers": { "description": "Claimed sellers with their profile and endpoint counts" }, "total": { "description": "Total claimed sellers" } }, "type": "object" } }, { "description": "Free. Size and freshness of the x402 endpoint index and the on-chain ledger. Use when: you need to know how current Settled’s data is, or what the paid routes cost, before relying on any other tool. Not for: looking up a specific endpoint (use settled_check). No input.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": {}, "type": "object" }, "name": "settled_status", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "by_status": { "description": "Endpoint counts by status (live, dead, ...)" }, "docs": { "description": "Where the docs are" }, "endpoints_probed": { "description": "How many have been probed" }, "endpoints_tracked": { "description": "Number of x402 endpoints Settled tracks" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "last_probe_at": { "description": "When the latest probe ran" }, "live_share_of_probed": { "description": "Percentage of probed endpoints that are live" }, "mcp": { "description": "This MCP server's URL" }, "network": { "description": "Network Settled's own paid routes settle on (CAIP-2)" }, "onchain_ledger": { "description": "Coverage of Settled's on-chain settlement ledger" }, "prices_usd": { "description": "Prices of Settled's paid routes, in USD" }, "scout": { "description": "Totals for the scout's paid test purchases" }, "service": { "description": "Always Settled" }, "settlement_7d": { "description": "x402 payments (matching a quoted price; crawlers and monitors left out) to tracked sellers over the 7 whole UTC days to yesterday (days gives the first and last)" }, "sources": { "description": "Discovery sources and how far each import has got" }, "total_probes": { "description": "Probes run so far" }, "version": { "description": "Settled's software version" } }, "type": "object" } }, { "description": "Free, rate-limited. Queue an x402 endpoint URL for indexing. Use when: settled_check or settled_peek reports the URL as unknown or not indexed. Not for: URLs already indexed (it just returns their status) or non-x402 URLs. After: wait a few minutes, then call settled_check; the first probe runs within minutes. Idempotent.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "url": { "description": "Full URL of an x402 endpoint to add to Settled's index", "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "settled_submit", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "already_indexed": { "description": "true when Settled already tracks it" }, "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "hint": { "description": "What to call next" }, "next_check_at": { "description": "When it will next be probed" }, "ok": { "description": "true when accepted" }, "queued": { "description": "true when queued for its first probe" }, "status": { "description": "Its current status, if already indexed" } }, "type": "object" } }, { "description": "Free. Pass any signed Settled response (attestation included) to recompute its hash and recover the signer; tells you whether it is authentic and unaltered. Use when: a Settled answer reached you through a third party, a cache or a log and you need to trust it. Not for: answers you just received directly over this server (already signed and fresh). Use the full response object, unchanged.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "document": { "additionalProperties": {}, "description": "A complete signed Settled answer, including its attestation block", "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "document" ], "type": "object" }, "name": "settled_verify", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attested_at": { "description": "When the document was signed" }, "hash": { "description": "Hash recomputed from the document" }, "hash_matches": { "description": "Whether it matches the signed hash" }, "reason": { "description": "Why it is not valid" }, "signer_matches": { "description": "Whether the two addresses match" }, "signer_published": { "description": "Settled's published signing address" }, "signer_recovered": { "description": "Address recovered from the signature" }, "valid": { "description": "true when the hash matches and the signer is Settled's published key" } }, "type": "object" } }, { "description": "Paid: $2.00 USDC on Base over x402 inside MCP (the first call returns the payment requirements; @x402/mcp clients pay automatically). Buys 30 days of monitoring for one x402 endpoint: probed about every 15 minutes, with a signed alert whenever status, payability, price or payTo changes. Use when: your agent depends on one endpoint and must learn quickly if it changes. Not for: one-off checks (settled_check). Give url to start or watch_id to renew; give webhook to have alerts POSTed, else read them with settled_watch_alerts. Returns watch_id.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "url": { "description": "The x402 endpoint to watch, e.g. https://api.example.com/search; required unless watch_id is given", "format": "uri", "type": "string" }, "watch_id": { "description": "The watch_id of an existing watch to renew for 30 more days; give this or url, not both", "type": "string" }, "webhook": { "description": "https URL that receives each alert as a signed POST; omit to poll with settled_watch_alerts", "format": "uri", "type": "string" } }, "type": "object" }, "name": "settled_watch", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "accepts": { "description": "Present when payment is needed: the x402 payment requirements; pay one and call again with the payment in _meta" }, "alert_format": { "description": "What an alert contains" }, "alerts": { "description": "URL of the alerts feed" }, "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "baseline": { "description": "The endpoint's state when the watch started" }, "created_at": { "description": "When the watch started" }, "delivery": { "description": "webhook or poll" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "expires_at": { "description": "When it ends unless renewed" }, "manage": { "description": "URL of the watch" }, "note": { "description": "What happens next" }, "renewed": { "description": "true when this call renewed an existing watch" }, "status": { "description": "active or expired" }, "url": { "description": "The watched endpoint" }, "watch_id": { "description": "The watch's id: keep it to read alerts and to renew" }, "webhook_host": { "description": "Host the alerts are POSTed to, if a webhook was given" }, "x402Version": { "description": "Present when payment is needed: the x402 version of the requirements" } }, "type": "object" } }, { "description": "Free. Everything a Watchdog has recorded for its endpoint since a given alert id: each change to status, payability, price or payTo, the endpoint’s state now, and next_since to pass on the next call. Use when: you created a watch with settled_watch and did not give a webhook. Not for: endpoints without a watch (use settled_check). Poll it whenever your agent runs; the endpoint is probed about every 15 minutes.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "description": "Most alerts to return, 1-100 (default 50)", "maximum": 100, "minimum": 1, "type": "integer" }, "since": { "description": "Return alerts with an id above this; pass next_since from your last call, or 0 for all", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "watch_id": { "description": "The watch_id returned by settled_watch when the Watchdog was bought", "minLength": 8, "type": "string" } }, "required": [ "watch_id" ], "type": "object" }, "name": "settled_watch_alerts", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "alerts": { "description": "Alerts since the given id, oldest first: each change to status, payability, price or payTo" }, "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "delivery": { "description": "webhook or poll" }, "endpoint_now": { "description": "The endpoint's state now: status, payability, price, payTo, last probe" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "expires_at": { "description": "When the watch ends unless renewed" }, "how": { "description": "How to poll" }, "more": { "description": "true when more alerts are waiting" }, "next_since": { "description": "Pass this as since on your next call" }, "status": { "description": "active or expired" }, "url": { "description": "The watched endpoint" }, "watch_id": { "description": "The watch" } }, "type": "object" } }, { "description": "Free. The latest published Agent Income Report as JSON: which venues paid agents on-chain, worker wallets, honeypots flagged, x402 index health. Use when: you want the week’s summary, for a digest or a decision about where to look for work. Not for: live numbers (settled_status, settled_income_venues). Published Mondays; the window and ledger coverage are in the body.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "properties": {}, "type": "object" }, "name": "settled_weekly_report", "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "attestation": { "description": "EIP-191 signature over the answer; verify it with settled_verify or any EVM library" }, "attested_at": { "description": "When Settled signed this answer (ISO 8601)" }, "endpoints": { "description": "x402 index health" }, "error": { "description": "Present only when the call failed or needs another step: an error code such as pass_required, next to the fields that explain it" }, "generated_at": { "description": "When it was built" }, "key": { "description": "The report's key, e.g. weekly:2026-W40" }, "kind": { "description": "Always weekly" }, "links": { "description": "Where the report is published" }, "listings": { "description": "Listings and honeypots" }, "settlements": { "description": "x402 payments to indexed sellers over whole UTC days (days names them; usd_7d on the published rule, comparison_basis the basis of the week-over-week figures)" }, "venues": { "description": "Venues that paid agents on-chain" }, "week": { "description": "ISO week of the report" }, "window": { "description": "The 7 days covered" } }, "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:5fe4721241631d16d9ae4dbdcc0aa9a8596b7b2f8e97f5577fe36b6ed9c5b9a8 | sha256sum