Koskamo

Settled MCP

An MCP server that allows AI agents to verify x402 endpoints before making payments. It checks if endpoints are live, what they charge, whether they deliver as promised, and verifies on-chain payment history to prevent fraud or wasted spend.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Settled MCP logo, by SettledVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-06Operated by Settled
You need:no key, no signup
MCP endpoint (Streamable HTTP)
https://settled.tools/mcp
Vendor documentation

What its tools do

18 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

18 of 18 have a description · 18 of 18 declare behavior hints · 15 of 15 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to settled.tools ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Check x402 endpoint liveness and quotes
  • Verify delivery quality via test purchases
  • Review on-chain payment history
  • Prevent agent payments to fraudulent sellers

Source and maintenance

Vendor evidenceRegistry 0.2.1

Protocol and capabilities

Server
settled 0.9.157-sellerpage
MCP protocol negotiated in check
2025-11-25
Tools
18 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

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; avoid endpoints whose recommendation is avoid or whose flags include delivery_failed or clone_farm. 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

18 advertised

settled_status — Settled index status
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_status input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
settled_status output schema
{
  "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": "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)"
    },
    "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_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_peek — Peek at an endpoint
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_peek input schema
{
  "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"
    }
  }
}
settled_peek output schema
{
  "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_peek annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_submit — Submit an endpoint
Advertised by the server during the last successful anonymous check.
Open-world

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_submit input schema
{
  "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"
    }
  }
}
settled_submit output schema
{
  "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_submit annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_report — Report whether a paid call worked
Advertised by the server during the last successful anonymous check.

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_report input schema
{
  "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",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "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"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The x402 endpoint you paid"
    },
    "signature": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{130}$",
      "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"
    }
  }
}
settled_report output schema
{
  "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_report annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_sellers — Claimed sellers
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_sellers input schema
{
  "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)"
    }
  }
}
settled_sellers output schema
{
  "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_sellers annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_claim — Claim your endpoints (sellers)
Advertised by the server during the last successful anonymous check.

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_claim input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wallet"
  ],
  "properties": {
    "docs": {
      "type": "string",
      "format": "uri",
      "description": "Your API documentation, as a full https URL"
    },
    "name": {
      "type": "string",
      "maxLength": 80,
      "description": "Seller name to show on your endpoints, up to 80 characters, e.g. Acme Data"
    },
    "action": {
      "enum": [
        "claim",
        "remove"
      ],
      "type": "string",
      "description": "claim (default) or remove to withdraw an existing claim"
    },
    "wallet": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "The payTo wallet your endpoints are paid to: 0x + 40 hex characters on Base, or a base58 address on Solana"
    },
    "contact": {
      "type": "string",
      "maxLength": 200,
      "description": "Where Seller Watch alerts go, strongly recommended: an email address (hello@example.com), 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"
    },
    "website": {
      "type": "string",
      "format": "uri",
      "description": "Your website, as a full https URL"
    },
    "issued_at": {
      "type": "string",
      "description": "The issued_at timestamp returned by the first call; send it back unchanged with the signature"
    },
    "signature": {
      "type": "string",
      "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"
    }
  }
}
settled_claim output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "note": {
      "description": "What the claim does"
    },
    "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"
    },
    "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_claim annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_preflight — Pre-spend check (pay / caution / avoid)
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_preflight input schema
{
  "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"
    },
    "payer_token": {
      "type": "string",
      "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"
    }
  }
}
settled_preflight output schema
{
  "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"
    },
    "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)"
    },
    "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"
    },
    "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)"
    },
    "recommendation": {
      "description": "pay, caution or avoid"
    }
  },
  "additionalProperties": {}
}
settled_preflight annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_check — Check an x402 endpoint
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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. 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_check input schema
{
  "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"
    },
    "payer_token": {
      "type": "string",
      "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"
    }
  }
}
settled_check output schema
{
  "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"
    },
    "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)"
    },
    "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)"
    },
    "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"
    },
    "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)"
    },
    "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_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_find_endpoints — Find live x402 endpoints
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

settled_find_endpoints input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "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"
    },
    "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": {
      "enum": [
        "live",
        "degraded",
        "dead",
        "free",
        "auth_gated",
        "not_found",
        "quote_invalid",
        "unknown",
        "any"
      ],
      "type": "string",
      "description": "Only endpoints with this status; live (default) or any for every status"
    },
    "network": {
      "type": "string",
      "description": "Only endpoints on this network, as a CAIP-2 id, e.g. eip155:8453 for Base"
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest price per call in USD, e.g. 0.01"
    },
    "payer_token": {
      "type": "string",
      "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"
    }
  }
}
settled_find_endpoints output schema
{
  "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_find_endpoints annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_seller_reputation — Seller reputation by payTo address
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_seller_reputation input schema
{
  "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",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "The payTo address from a 402 quote: 0x followed by 40 hex characters (Base)"
    },
    "payer_token": {
      "type": "string",
      "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"
    }
  }
}
settled_seller_reputation output schema
{
  "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"
    },
    "seller_alerts": {
      "description": "Only when the caller's payer record is this claimed wallet: its own Seller Watch alerts"
    },
    "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_seller_reputation annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_income_venues — Which venues actually pay agents
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_income_venues input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
settled_income_venues output schema
{
  "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_income_venues annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_income_listings — Verified agent-income listings
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_listings input schema
{
  "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": {
      "enum": [
        "usdc-base",
        "usdc-solana",
        "crypto",
        "fiat",
        "mixed",
        "unknown"
      ],
      "type": "string",
      "description": "Only listings paid on this rail, e.g. usdc-base"
    },
    "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",
      "pattern": "^[a-z0-9-]{2,40}$",
      "description": "Only listings from this venue, by its slug from settled_income_venues, e.g. superteam-earn"
    },
    "min_reward": {
      "type": "number",
      "minimum": 0,
      "description": "Smallest reward to include, in USD, e.g. 50"
    },
    "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"
    }
  }
}
settled_income_listings output schema
{
  "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_listings annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_income_check — Honeypot / trust scan of one listing
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_check input schema
{
  "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"
    }
  }
}
settled_income_check output schema
{
  "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_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_events — Change feed
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

settled_events input schema
{
  "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)"
    },
    "payer_token": {
      "type": "string",
      "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"
    }
  }
}
settled_events output schema
{
  "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_events annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_watch — Buy a Watchdog for an x402 endpoint
Advertised by the server during the last successful anonymous check.
Open-world

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.

settled_watch input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The x402 endpoint to watch, e.g. https://api.example.com/search; required unless watch_id is given"
    },
    "webhook": {
      "type": "string",
      "format": "uri",
      "description": "https URL that receives each alert as a signed POST; omit to poll with settled_watch_alerts"
    },
    "watch_id": {
      "type": "string",
      "description": "The watch_id of an existing watch to renew for 30 more days; give this or url, not both"
    }
  }
}
settled_watch output schema
{
  "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 annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
settled_watch_alerts — Read a Watchdog's alerts
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_watch_alerts input schema
{
  "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",
      "minLength": 8,
      "description": "The watch_id returned by settled_watch when the Watchdog was bought"
    }
  }
}
settled_watch_alerts output schema
{
  "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_watch_alerts annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_weekly_report — Weekly Agent Income Report
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

settled_weekly_report input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
settled_weekly_report output schema
{
  "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": "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)"
    },
    "generated_at": {
      "description": "When it was built"
    }
  },
  "additionalProperties": {}
}
settled_weekly_report annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
settled_verify — Verify a signed Settled response
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_verify input schema
{
  "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": {}
    }
  }
}
settled_verify output schema
{
  "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_verify annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
655 ms
95th percentile latency
655 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 655 ms · metadata changed · 18 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http settled-mcp https://settled.tools/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add settled-mcp --url https://settled.tools/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable settled-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "settled-mcp": {
      "url": "https://settled.tools/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "settled-mcp": {
      "type": "streamableHttp",
      "url": "https://settled.tools/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start settled-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "settled-mcp": {
      "type": "http",
      "url": "https://settled.tools/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http settled-mcp https://settled.tools/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://settled.tools/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "settled-mcp": {
      "serverUrl": "https://settled.tools/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Settled MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run Settled MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing