{"id":"tools.settled/settled","slug":"tools-settled-settled","title":"Settled","description":"Check an x402 endpoint before your agent pays it: does it answer, what it charges, did it deliver","version":"0.9.2","publisher":{"kind":"domain","id":"settled.tools","label":"settled.tools","url":"https://settled.tools"},"website":"https://settled.tools/for-agents","repository":"","remotes":[{"type":"streamable-http","url":"https://settled.tools/mcp","headers":[{"description":"Optional Settled day pass ($0.05 over x402, 24 hours): lifts the free limit (25 checks a day, 300 with a payer record) and unlocks every tool except settled_watch","isSecret":true,"name":"x-settled-pass"}]}],"packages":[{"registryType":"npm","identifier":"settled-x402","version":"0.9.2","runtimeHint":"npx","transport":{"type":"stdio"},"packageArguments":[{"type":"positional","value":"mcp"}],"environmentVariables":[{"description":"Optional Settled day pass ($0.05 over x402, 24 hours): lifts the free limit (25 checks a day, 300 with a payer record) and unlocks every tool except settled_watch","isSecret":true,"name":"SETTLED_PASS"}]}],"published":"2026-11-18","updated":"2026-11-18","status":"online","auth":"","latency_ms":1319,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"settled_status","title":"Settled index status","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.","read_only":true},{"name":"settled_peek","title":"Peek at an endpoint","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.","read_only":true},{"name":"settled_submit","title":"Submit an endpoint","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.","read_only":false},{"name":"settled_report","title":"Report whether a paid call worked","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 paymen","read_only":false},{"name":"settled_sellers","title":"Claimed sellers","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.","read_only":true},{"name":"settled_claim","title":"Claim your endpoints (sellers)","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 a","read_only":false},{"name":"settled_preflight","title":"Pre-spend check (pay / caution / avoid)","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. ","read_only":true},{"name":"settled_check","title":"Check an x402 endpoint","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 recommendati","read_only":true},{"name":"settled_find_endpoints","title":"Find live x402 endpoints","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, pr","read_only":true},{"name":"settled_seller_reputation","title":"Seller reputation by payTo address","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 ad","read_only":true},{"name":"settled_income_venues","title":"Which venues actually pay agents","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 fo","read_only":true},{"name":"settled_income_listings","title":"Verified agent-income listings","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 a","read_only":true},{"name":"settled_income_check","title":"Honeypot / trust scan of one listing","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_lis","read_only":true},{"name":"settled_events","title":"Change feed","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 ","read_only":true},{"name":"settled_watch","title":"Buy a Watchdog for an x402 endpoint","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 (sett","read_only":false},{"name":"settled_watch_alerts","title":"Read a Watchdog's alerts","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 ever","read_only":true},{"name":"settled_weekly_report","title":"Weekly Agent Income Report","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.","read_only":true},{"name":"settled_verify","title":"Verify a signed Settled response","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.","read_only":true}],"server_info":{"name":"settled","version":"0.9.166-payto"},"category":"crypto","tags":["analytics","developer","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-02","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/tools-settled-settled/"}