Servidor MCP

Settled

tools.settled/settled
Cripto y Web3 Pagos y fintech Seguridad Público y accesible MCP 2025-11-25

Qué hace este MCP

Evaluates, discovers and monitors x402 paid endpoints, including payment details, seller reputation, delivery reports and honeypot risks.

settled_check
Check an x402 endpoint
Free up to 300 calls/day per client, shared with the HTTP free routes (a pass lifts the cap). Check an x402 endpoint before paying it (cached ≤5 min; force=true needs a pass): status, payability verdict, latency, parsed price/network/payTo, payee on-chain existence, on-chain payer activity, the scout's last paid purchase (settlement tx and whether the response matched the listing), paying agents' reports, seller claim, quality breakdown, risk flags.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Full URL of the x402 endpoint, e.g. https://api.example.com/search'}, 'pass': {'type': 'string', 'description': 'Settled day pass token: lifts the free daily cap; or send it as the x-settled-pass header'}, 'force': {'type': 'boolean', 'description': 'true to probe now instead of using the 5-minute cache; needs a pass'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'description': 'The endpoint'}, 'asset': {'description': 'Asset of the cheapest option'}, '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'}, 'payee': {'description': 'Whether the payTo has on-chain history'}, 'cached': {'description': "Whether this came from Settled's 5-minute cache"}, 'pay_to': {'description': "The payTo Settled's probe sees; compare it with the quote you are about to pay"}, 'scheme': {'description': 'Payment scheme, e.g. exact'}, 'status': {'description': 'Endpoint status, e.g. live, degraded, dead, free, auth_gated, not_found or quote_invalid'}, 'network': {'description': 'Network of the cheapest option (CAIP-2)'}, 'onchain': {'description': 'Settlements and unique payers over the last 30 days'}, 'quality': {'description': 'Quality score breakdown'}, 'reports': {'description': "Paying agents' reports"}, 'price_usd': {'description': 'Price per call in USD (cheapest option)'}, 'checked_at': {'description': 'When this answer was built'}, 'first_seen': {'description': 'When Settled first saw it'}, 'last_ok_at': {'description': 'When it last answered with a valid quote'}, 'latency_ms': {'description': 'Latency of the latest probe'}, 'payability': {'description': 'Payability verdict and the verb that pays'}, '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)'}, 'description': {'description': "The listing's description"}, 'network_name': {'description': 'Readable network name'}, 'seller_claim': {'description': "The seller's claim and profile, if claimed"}, 'service_name': {'description': "The listing's service name"}, 'x402_version': {'description': 'x402 version of the quote'}, 'last_probe_at': {'description': 'When Settled last probed it'}, 'delivery_receipt': {'description': "The scout's last purchase, with its settlement transaction and checks (when the scout has bought it)"}, 'http_status_last': {'description': 'HTTP status of the latest probe'}, 'last_delivery_at': {'description': 'When the scout last bought it'}, 'delivery_verified': {'description': "Whether a real payment by Settled's scout came back with content"}}, 'additionalProperties': {}}
settled_claim
Claim your endpoints (sellers)
Free. Claim every x402 endpoint paid to your wallet with one signature, on every host. Call with wallet (plus optional name, website, contact, docs) to get message_to_sign, issued_at and what the claim would cover; sign message_to_sign with that payTo wallet (EIP-191 personal_sign on Base, ed25519 on Solana) and call again with issued_at and signature. action: remove withdraws the claim. Claims never change scores.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['wallet'], 'properties': {'docs': {'type': 'string', 'description': 'URL of your API documentation'}, 'name': {'type': 'string', 'description': 'Seller name to show on your endpoints'}, 'action': {'enum': ['claim', 'remove'], 'type': 'string', 'description': 'claim (default) or remove to withdraw an existing claim'}, 'wallet': {'type': 'string', 'description': 'The payTo wallet your endpoints are paid to (0x... on Base, base58 on Solana)'}, 'contact': {'type': 'string', 'description': 'How buyers can reach you, e.g. an email address or X handle'}, 'website': {'type': 'string', 'description': 'Your website URL'}, 'issued_at': {'type': 'string', 'description': 'The issued_at returned by the first call; send it back with the signature'}, 'signature': {'type': 'string', 'description': 'Signature of message_to_sign by the wallet: EIP-191 personal_sign on Base, ed25519 on Solana'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'description': 'What the claim does'}, 'error': {'description': 'signature_required on the first call (sign message_to_sign and call again), or why the claim was refused'}, 'covers': {'description': 'The endpoints and hosts the claim covers'}, 'wallet': {'description': 'The wallet'}, 'claimed': {'description': 'true once the claim is recorded'}, 'network': {'description': "The wallet's network"}, 'profile': {'description': 'The published profile: name, website, contact, docs'}, 'removed': {'description': 'true once a claim is withdrawn'}, 'issued_at': {'description': 'Timestamp to send back with the signature'}, '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)'}, 'would_cover': {'description': 'The endpoints and hosts the claim would cover'}, 'message_to_sign': {'description': 'The exact message to sign with the wallet'}}, 'additionalProperties': {}}
settled_events
Change feed
Free up to 300 calls/day per client. Recent changes worth acting on: venue verdict flips, new suspected honeypots, settlement-integrity changes — newest first. Poll this instead of re-reading the scorecard.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pass': {'type': 'string', 'description': 'Settled day pass token: lifts the free daily cap; or send it as the x-settled-pass header'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'How many events to return, newest first, 1-200 (default 50)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'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'}, '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)'}, 'generated_at': {'description': 'When this list was built'}}, 'additionalProperties': {}}
settled_find_endpoints
Find live x402 endpoints
Free up to 300 calls/day per client, shared with the HTTP free routes (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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Keywords to match in endpoint names, descriptions and URLs, e.g. weather or gift cards'}, 'pass': {'type': 'string', 'description': 'Settled day pass token: lifts the free daily cap; or send it as the x-settled-pass header'}, 'sort': {'enum': ['quality', 'price', 'latency', 'payers'], 'type': 'string', 'description': 'Order of results: quality (default), price, latency or payers'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'How many endpoints to return, 1-50 (default 20)'}, 'status': {'type': 'string', 'description': 'Endpoint status: live (default), degraded, dead, free, auth_gated, not_found, quote_invalid, unknown or any'}, 'network': {'type': 'string', 'description': 'Only endpoints on this network, as a CAIP-2 id, e.g. eip155:8453 for Base'}, 'max_price': {'type': 'number', 'description': 'Highest price per call in USD, e.g. 0.01'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'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'}, 'items': {'description': 'Ranked endpoints, each with payability and delivery status'}, 'filters': {'description': 'The filters applied'}, '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)'}, 'generated_at': {'description': 'When this list was built'}}, 'additionalProperties': {}}
settled_income_check
Honeypot / trust scan of one listing
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. Call before working on an unfamiliar bounty.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'URL of the bounty issue, repository or listing page to scan'}, 'pass': {'type': 'string', 'description': 'Settled day pass token, if you did not send it as the x-settled-pass header'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'description': 'The page scanned'}, 'note': {'description': 'How to read the result'}, 'repo': {'description': 'Repository facts, for GitHub links'}, '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'}, 'label': {'description': 'verified_paying, unverified, gated, suspected_honeypot, dead or closed_to_agents'}, 'trust': {'description': 'Trust score 0-100'}, 'source': {'description': 'What was scanned, e.g. page_text'}, 'indexed': {'description': "Settled's listing for this URL, if it has one"}, 'scanned_at': {'description': 'When the scan ran'}, '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)'}}, 'additionalProperties': {}}
settled_income_listings
Verified agent-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. Suspected honeypots, dead and human-only listings are excluded unless include_honeypots is true.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pass': {'type': 'string', 'description': 'Settled day pass token, if you did not send it as the x-settled-pass header'}, 'rail': {'type': 'string', 'description': 'Only listings paid on this rail: usdc-base, usdc-solana, crypto, fiat, mixed or unknown'}, 'sort': {'enum': ['trust', 'reward', 'recent'], 'type': 'string', 'description': 'Order of results: trust (default), reward or recent'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'How many listings to return, 1-50 (default 20)'}, 'venue': {'type': 'string', 'description': 'Only listings from this venue, by its slug from settled_income_venues'}, 'min_reward': {'type': 'number', 'description': 'Smallest reward to include, in USD'}, 'agent_access': {'enum': ['allowed', 'any'], 'type': 'string', 'description': 'allowed (default) for listings agents may take, or any to include human-only ones'}, 'include_honeypots': {'type': 'boolean', 'description': 'true to include suspected honeypots and dead listings'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'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'}, 'items': {'description': "Open bounties and tasks with reward, agent access, gating, honeypot flags, trust score and the venue's payout record"}, 'filters': {'description': 'The filters applied'}, '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)'}, 'generated_at': {'description': 'When this list was built'}, 'label_vocabulary': {'description': 'The possible listing labels'}}, 'additionalProperties': {}}
settled_income_venues
Which venues actually pay agents
Free. Scorecard of bounty boards, task markets, audit contests and x402 sell-side: verdict (paying / paying small / no payouts seen / closed to agents / defunct), agent policy, gating (KYC, human claim, self-custody wallet), open listings and on-chain payouts out of escrow.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'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'}, 'venues': {'description': 'Each venue with its verdict, agent policy, gating, open listings and on-chain payouts'}, '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)'}, 'generated_at': {'description': 'When this list was built'}, 'verdict_vocabulary': {'description': 'The possible verdicts'}}, 'additionalProperties': {}}
settled_peek
Peek at an endpoint
Free, rate-limited. Coarse status and quality score for one x402 endpoint URL (no fresh probe).
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Full URL of the x402 endpoint, e.g. https://api.example.com/search'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'description': 'The endpoint'}, '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'}, 'detail': {'description': 'Where to get the full check'}, 'status': {'description': 'Endpoint status, e.g. live, degraded, dead, free, auth_gated, not_found or quote_invalid'}, 'quality': {'description': 'Quality score 0-100'}, '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)'}, 'last_probe_at': {'description': 'When Settled last probed it'}, 'seller_claimed': {'description': 'Whether the seller has claimed it'}}, 'additionalProperties': {}}
settled_preflight
Pre-spend check (pay / caution / avoid)
Pass required. The one call to make before paying an unfamiliar x402 endpoint: fresh liveness on both verbs, parsed quote, payability verdict, 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 — one signed answer with a recommendation and reasons.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Full URL of the x402 endpoint, e.g. https://api.example.com/search'}, 'pass': {'type': 'string', 'description': 'Settled day pass token, if you did not send it as the x-settled-pass header'}, 'force': {'type': 'boolean', 'description': 'true to probe the endpoint now instead of reusing a result up to 5 minutes old'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'description': 'The endpoint'}, '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'}, 'payee': {'description': "Whether the payTo exists on-chain, and the seller's other endpoints and settlement integrity"}, 'quote': {'description': 'The parsed 402 quote Settled sees: network, asset, price_usd, pay_to'}, 'cached': {'description': "Whether the probe came from Settled's 5-minute cache"}, 'onchain': {'description': 'Settlements and unique payers over the last 30 days'}, 'quality': {'description': 'Quality score breakdown'}, 'reasons': {'description': 'Why, in plain words'}, 'reports': {'description': "Paying agents' reports"}, 'delivery': {'description': "The scout's last real purchase and whether it matched the listing"}, 'honeypot': {'description': 'Honeypot scan of the listing text'}, 'liveness': {'description': 'Fresh probe results'}, 'checked_at': {'description': 'When this check ran'}, 'payability': {'description': 'Payability verdict and the verb that pays'}, '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)'}, 'description': {'description': "The listing's description"}, 'seller_claim': {'description': "The seller's claim and profile, if claimed"}, 'recommendation': {'description': 'pay, caution or avoid'}}, 'additionalProperties': {}}
settled_report
Report whether a paid call worked
Free. After paying an x402 endpoint on Base, tell Settled whether you got what you paid for. Give the endpoint url, the transaction hash of your USDC payment to it, ok, and an EIP-191 personal_sign by the paying wallet of exactly: 'settled.tools report v1\nurl: <url>\ntx: <tx, lowercase>\nok: <true|false>'. Call without a signature to get the exact message_to_sign. One report per payment and one vote per wallet per endpoint; tallies count once 3+ different wallets have reported. Settled keeps only per-endpoint tallies.
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url', 'tx', 'ok'], 'properties': {'ok': {'type': 'boolean', 'description': 'true if the call delivered what you paid for, false if it did not'}, 'tx': {'type': 'string', 'description': 'Transaction hash (0x...) of your USDC payment to that endpoint on Base, from the last 30 days'}, 'url': {'type': 'string', 'format': 'uri', 'description': 'The x402 endpoint you paid'}, 'signature': {'type': 'string', 'description': 'EIP-191 personal_sign of the exact report message by the wallet that paid; omit it to get message_to_sign'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ok': {'description': 'Your verdict, as recorded'}, 'url': {'description': 'The endpoint'}, 'error': {'description': 'signature_required when no signature was given (sign message_to_sign and call again), or why the report was refused'}, 'paid_at': {'description': 'When your payment was made'}, 'privacy': {'description': 'What Settled keeps about you'}, 'reports': {'description': "This endpoint's report tallies"}, 'accepted': {'description': 'true once the report is recorded'}, 'paid_usd': {'description': 'What your transaction paid the endpoint, in USD'}, '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)'}, 'message_to_sign': {'description': 'The exact message to sign with the paying wallet'}}, 'additionalProperties': {}}
settled_seller_reputation
Seller reputation by payTo address
Pass required. Endpoints served by a recipient address, live/dead counts, price range, clone-farm and quote-only flags, on-chain settlements and unique payers.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'pass': {'type': 'string', 'description': 'Settled day pass token, if you did not send it as the x-settled-pass header'}, 'address': {'type': 'string', 'description': 'The payTo address to look up (0x... on Base)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'dead': {'description': 'How many are dead'}, 'live': {'description': 'How many are live'}, 'claim': {'description': "The seller's claim and profile, if claimed"}, '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': 'Seller flags such as clone_farm or quote_only'}, 'hosts': {'description': 'Hosts serving them'}, 'address': {'description': 'The payTo address'}, 'onchain': {'description': 'On-chain settlements and unique payers'}, 'endpoints': {'description': 'Endpoints paid to it'}, 'first_seen': {'description': 'When Settled first saw one'}, '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)'}, 'generated_at': {'description': 'When this answer was built'}, 'top_endpoints': {'description': 'Its main endpoints'}, 'price_range_usd': {'description': 'Lowest and highest price'}, 'settlement_integrity': {'description': 'Whether paid activity looks organic or self-generated'}}, 'additionalProperties': {}}
settled_sellers
Claimed sellers
Free. Sellers who proved control of the wallet their x402 endpoints are paid to (one signature covers every endpoint and host paid to that wallet), with the profile they published and their endpoint counts. Paged: limit (max 50) and offset, with a total.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'How many sellers to return, 1-50 (default 25)'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'How many sellers to skip, for paging (default 0)'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'description': 'What a claim proves'}, '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'}, 'limit': {'description': 'Page size used'}, 'total': {'description': 'Total claimed sellers'}, 'offset': {'description': 'Offset used'}, 'sellers': {'description': 'Claimed sellers with their profile and endpoint counts'}, '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)'}, 'generated_at': {'description': 'When this list was built'}}, 'additionalProperties': {}}
settled_status
Settled index status
Free. Size and freshness of the x402 endpoint index and the on-chain ledger.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mcp': {'description': "This MCP server's URL"}, 'docs': {'description': 'Where the docs are'}, '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'}, 'scout': {'description': "Totals for the scout's paid test purchases"}, 'network': {'description': "Network Settled's own paid routes settle on (CAIP-2)"}, 'service': {'description': 'Always Settled'}, 'sources': {'description': 'Discovery sources and how far each import has got'}, 'version': {'description': "Settled's software version"}, 'by_status': {'description': 'Endpoint counts by status (live, dead, ...)'}, 'prices_usd': {'description': "Prices of Settled's paid routes, in USD"}, '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)'}, 'total_probes': {'description': 'Probes run so far'}, 'last_probe_at': {'description': 'When the latest probe ran'}, 'settlement_7d': {'description': 'USDC settled to tracked sellers in the last 7 days'}, 'onchain_ledger': {'description': "Coverage of Settled's on-chain settlement ledger"}, 'endpoints_probed': {'description': 'How many have been probed'}, 'endpoints_tracked': {'description': 'Number of x402 endpoints Settled tracks'}, 'live_share_of_probed': {'description': 'Percentage of probed endpoints that are live'}}, 'additionalProperties': {}}
settled_submit
Submit an endpoint
Free, rate-limited. Queue an x402 endpoint URL for indexing.
Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Full URL of an x402 endpoint to add to Settled's index"}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ok': {'description': 'true when accepted'}, 'hint': {'description': 'What to call next'}, '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'}, 'queued': {'description': 'true when queued for its first probe'}, 'status': {'description': 'Its current status, if already indexed'}, '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)'}, 'next_check_at': {'description': 'When it will next be probed'}, 'already_indexed': {'description': 'true when Settled already tracks it'}}, 'additionalProperties': {}}
settled_verify
Verify a signed Settled response
Free. Pass any signed Settled response (attestation included) to recompute its hash and recover the signer; tells you whether it is authentic and unaltered.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['document'], 'properties': {'document': {'type': 'object', 'description': 'A complete signed Settled answer, including its attestation block', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hash': {'description': 'Hash recomputed from the document'}, 'valid': {'description': "true when the hash matches and the signer is Settled's published key"}, 'reason': {'description': 'Why it is not valid'}, 'attested_at': {'description': 'When the document was signed'}, 'hash_matches': {'description': 'Whether it matches the signed hash'}, 'signer_matches': {'description': 'Whether the two addresses match'}, 'signer_published': {'description': "Settled's published signing address"}, 'signer_recovered': {'description': 'Address recovered from the signature'}}, 'additionalProperties': {}}
settled_watch
Buy a Watchdog for an x402 endpoint
Paid: $1.00 USDC on Base, paid over x402 inside MCP (clients built on @x402/mcp pay automatically; the first call returns the payment requirements). 10 days of monitoring for one x402 endpoint: Settled probes it about every 15 minutes and records a signed alert whenever its status, payability, price or payTo changes. Pass watch_id instead of url to renew an existing watch for 10 more days with the same feed. Give a webhook (https) to have alerts POSTed to you, or leave it out and read them with settled_watch_alerts. Returns watch_id. A bad url or webhook is refused before any payment. If your client can't pay inside MCP, POST https://settled.tools/v1/watch over x402 instead.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The x402 endpoint to watch; omit it when renewing'}, 'webhook': {'type': 'string', 'format': 'uri', 'description': 'Optional https URL that receives each alert as a signed POST'}, 'watch_id': {'type': 'string', 'description': 'An existing watch to renew for 10 more days, instead of buying a new one'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'description': 'The watched endpoint'}, 'note': {'description': 'What happens next'}, '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'}, 'alerts': {'description': 'URL of the alerts feed'}, 'manage': {'description': 'URL of the watch'}, 'status': {'description': 'active or expired'}, 'accepts': {'description': 'Present when payment is needed: the x402 payment requirements; pay one and call again with the payment in _meta'}, 'renewed': {'description': 'true when this call renewed an existing watch'}, 'baseline': {'description': "The endpoint's state when the watch started"}, 'delivery': {'description': 'webhook or poll'}, 'watch_id': {'description': "The watch's id: keep it to read alerts and to renew"}, 'created_at': {'description': 'When the watch started'}, 'expires_at': {'description': 'When it ends unless renewed'}, '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)'}, 'x402Version': {'description': 'Present when payment is needed: the x402 version of the requirements'}, 'alert_format': {'description': 'What an alert contains'}, 'webhook_host': {'description': 'Host the alerts are POSTed to, if a webhook was given'}}, 'additionalProperties': {}}
settled_watch_alerts
Read a Watchdog's 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. Poll it whenever your agent runs; the endpoint is probed about every 15 minutes.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['watch_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Most alerts to return, 1-100 (default 50)'}, 'since': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Return alerts with an id above this; pass next_since from your last call, or 0 for all'}, 'watch_id': {'type': 'string', 'description': 'The watch_id returned when the Watchdog was bought'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'how': {'description': 'How to poll'}, 'url': {'description': 'The watched endpoint'}, 'more': {'description': 'true when more alerts are waiting'}, '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'}, 'alerts': {'description': 'Alerts since the given id, oldest first: each change to status, payability, price or payTo'}, 'status': {'description': 'active or expired'}, 'delivery': {'description': 'webhook or poll'}, 'watch_id': {'description': 'The watch'}, 'expires_at': {'description': 'When the watch ends unless renewed'}, 'next_since': {'description': 'Pass this as since on your next call'}, '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)'}, 'endpoint_now': {'description': "The endpoint's state now: status, payability, price, payTo, last probe"}}, 'additionalProperties': {}}
settled_weekly_report
Weekly Agent Income Report
Free. The latest published weekly report as JSON: which venues paid agents on-chain, worker wallets, honeypots flagged, x402 index health.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'key': {'description': "The report's key, e.g. weekly:2026-W40"}, 'kind': {'description': 'Always weekly'}, 'week': {'description': 'ISO week of the report'}, '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'}, 'links': {'description': 'Where the report is published'}, 'venues': {'description': 'Venues that paid agents on-chain'}, 'window': {'description': 'The 7 days covered'}, 'listings': {'description': 'Listings and honeypots'}, 'endpoints': {'description': 'x402 index health'}, '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)'}, 'settlements': {'description': 'On-chain settlement totals'}, 'generated_at': {'description': 'When it was built'}}, 'additionalProperties': {}}
Añadido
settled_verify
4 de October de 2026 a las 02:40
Añadido
settled_weekly_report
4 de October de 2026 a las 02:40
Añadido
settled_watch_alerts
4 de October de 2026 a las 02:40
Añadido
settled_watch
4 de October de 2026 a las 02:40
Añadido
settled_events
4 de October de 2026 a las 02:40
Añadido
settled_income_check
4 de October de 2026 a las 02:40
Añadido
settled_income_listings
4 de October de 2026 a las 02:40
Añadido
settled_income_venues
4 de October de 2026 a las 02:40
Añadido
settled_seller_reputation
4 de October de 2026 a las 02:40
Añadido
settled_find_endpoints
4 de October de 2026 a las 02:40
Añadido
settled_check
4 de October de 2026 a las 02:40
Añadido
settled_preflight
4 de October de 2026 a las 02:40
Añadido
settled_claim
4 de October de 2026 a las 02:40
Añadido
settled_sellers
4 de October de 2026 a las 02:40
Añadido
settled_report
4 de October de 2026 a las 02:40
Añadido
settled_submit
4 de October de 2026 a las 02:40
Añadido
settled_peek
4 de October de 2026 a las 02:40
Añadido
settled_status
4 de October de 2026 a las 02:40