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 yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5fe4721241631d16d9ae4dbdcc0aa9a8596b7b2f8e97f5577fe36b6ed9c5b9a8 | sha256sum