Settled

Endpoints (9 live)

• GET /v1/payto/:address — Seller reputation by payTo address: how many endpoints it serves, how many are live, price range, clone-farm and quote-only flags, and on-chain activity on Base (settlements and unique payers over 30 days, last settlement time). (0.005 USDC on Base)
• GET /v1/preflight — Pre-spend check for one x402 endpoint in a single signed response: fresh liveness probe on both verbs, parsed quote, payability verdict (payable / malformed 402 / cannot pay on either verb / unpriced), whether the payTo exists on-chain, the seller's other endpoints and settlement integrity, the scout's real-payment delivery result, and a honeypot scan of the listing text. Returns recommendation: pay | caution | avoid, with reasons. Call it before the first payment to an unfamiliar endpoint. (0.005 USDC on Base)
• POST /v1/watch — Watchdog: 30 days of signed webhook alerts for one x402 endpoint. Settled keeps probing it and POSTs an EIP-191-signed JSON alert to your webhook whenever its status, payability, price or payTo changes (checked every 15 minutes), plus one notice at expiry. Body: {url, webhook}. Verify any alert at /v1/verify. (1 USDC on Base)
• GET /v1/income — Verified agent-income listings: open bounties and tasks from sanctioned venue APIs (Taskmarket, Superteam Earn, GitHub bounty labels), each with reward, agent-access policy, gating (KYC / human claim / self-custody wallet), a honeypot scan with reasons, a trust score and the venue's on-chain payout record. Honeypots and human-only listings are excluded by default. (0.01 USDC on Base)
• GET /v1/income/check — Scan one bounty / task / repository URL before working on it: fetches it (GitHub issues and repos via the API), runs the honeypot pattern scan (hidden HTML-comment instructions, prompt injection, credential requests, fork/star anomalies, dead or archived repos, reward anomalies) and returns a trust score, a label and every flag with its reason. (0.005 USDC on Base)
• GET /v1/endpoints — Ranked list of live x402 endpoints (top 50) filtered by keyword, network and max price, ordered by Settled quality score. Use it to find a working alternative to a dead or overpriced endpoint. (0.005 USDC on Base)
• POST /v1/pass — Buy a 24-hour day pass: one payment unlocks preflight, check, endpoints, payto, income and income/check, and every MCP tool, for 24h at up to 120 requests/min (the Watchdog, Seller Watch and the seller re-test are sold separately). Returns a bearer token to send as the x-settled-pass header. (0.05 USDC on Base)
• GET /v1/check — Signed check of an x402 endpoint before you pay it: who really pays it on Base (settlements and unique payers over 30 days), a fresh unpaid probe (cached ≤5 min) with status, latency and the parsed quote, payability, paying agents' reports, the seller's claim, the scout's last real purchase (settlement transaction and whether it matched the listing), a quality score and risk flags. Free up to 300 calls a day per client at /v1/free/check. (0.002 USDC on Base)
• GET /v1/payto/1 — Seller reputation by payTo address: how many endpoints it serves, how many are live, price range, clone-farm and quote-only flags, and on-chain activity on Base (settlements and unique payers over 30 days, last settlement time). (0.005 USDC on Base)

MCP tools (18)

settled https://settled.tools/mcp

• settled_check — Free up to 300 calls/day per client (a pass lifts the cap). 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. 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.
• settled_claim — 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.
• settled_events — Free up to 300 calls/day per client. 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.
• settled_find_endpoints — Free up to 300 calls/day per client (a pass lifts the cap). Ranked live endpoints by keyword, network and max price (sort by quality, price, latency or payers), 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.
• settled_income_check — 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.
• settled_income_listings — 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.
• settled_income_venues — 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.
• settled_peek — 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.
• settled_preflight — 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.
• settled_report — 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.
• settled_seller_reputation — 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.
• settled_sellers — 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.
• settled_status — 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.
• settled_submit — 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.
• settled_verify — 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.
• settled_watch — Paid: $1.00 USDC on Base over x402 inside MCP (the first call returns the payment requirements; @x402/mcp clients pay automatically). Buys 10 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.
• settled_watch_alerts — 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.
• settled_weekly_report — 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.