settle_report
Settlement health report (paid, read-only)
Paid, read-only, no arguments: x402 settlement health report for Base USDC — Base RPC head/latency, PayAI facilitator reachability, settlement-watch outcomes (24h); with a key also your receipts/open watches/caps/spend. $0.001 USDC per call via x402 over MCP (unpaid call returns PaymentRequired; retry with params._meta["x402/payment"]), or 1 call of your Settle key (apiKey).
ParametersapiKey
settle_verify
Verify x402 settlement
0.003 USDC per call via x402, no key (unpaid call returns PaymentRequired; retry with params._meta["x402/payment"]). Verify an x402 settlement on Base USDC right now (by tx hash, or payer+nonce / paymentPayload via USDC.authorizationState). Returns settled|failed|pending|not_settled|expired|unknown. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParameterstxnoncepayTopayeramountapiKeyvalidBeforepaymentPayload
settle_watch
Watch timed-out settlement
Watch a timed-out/unknown x402 settlement: re-checked on-chain for up to 24h; POSTs your webhook when it becomes settled/failed/expired. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParameterstxnoncepayTopayeramountapiKeywebhookvalidBeforepaymentPayload
settle_watch_status
Settlement watch status
Status of a settlement watch. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParametersapiKeywatchId
settle_gate_claim
Claim payment authorization
Idempotency gate: claim an EIP-3009 authorization (payer+nonce) before settling. claimed:false means duplicate — do not settle again. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParametersassetnoncepayerapiKeynetworkpaymentPayload
settle_gate_complete
Complete gate (settled/failed)
Mark a claimed authorization settled or failed (failed allows a retry). Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParameterstxapiKeygateIdstatus
receipt_create
Create delivery receipt
Create a delivery receipt (status paid) for an order/request ref; idempotent per ref. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParameterstxrefnoteapiKeywebhookamountUsd
receipt_update
Update delivery receipt
Move a receipt paid -> delivered | failed | refunded (refundTx optional). Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParametersrefnoteapiKeystatusrefundTxreceiptId
receipt_get
Get delivery receipt
Read a delivery receipt and its history. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParametersrefapiKeyreceiptId
spend_cap_set
Set agent spend caps
0.002 USDC per call via x402, no key (unpaid call returns PaymentRequired; retry with params._meta["x402/payment"]). Advisory spend caps that complement your wallet's enforced hard limits (Coinbase Agentic Wallet / CDP spendControls); cannot block payments. Set per-call / per-day (rolling 24h) / per-session USD limits and optional allow-lists (payTo, hosts, networks) for a payer wallet address (replaces the previous policy for that payer). Optional ownerLock secret so the agent cannot loosen the caps later. Advisory and non-custodial. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParameterspayerapiKeyownerLockperDayUsdallowHostsallowPayToperCallUsdallowNetworksperSessionUsd
spend_cap_get
Get agent spend caps
0.002 USDC per call via x402, no key (unpaid call returns PaymentRequired; retry with params._meta["x402/payment"]). Advisory (complements your wallet's enforced hard limits): read the spend caps of a payer address plus what it spent in the last 24h (and in a session). Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParameterspayerapiKeysessionId
spend_check
Pre-payment spend check
0.002 USDC per call via x402, no key (unpaid call returns PaymentRequired; retry with params._meta["x402/payment"]). Advisory pre-sign check (your wallet's own hard limits still apply; we cannot block a payment): 'would this payment exceed my cap?'. Pass the 402 PAYMENT-REQUIRED (header or body) or amountUsd, plus payer and optional sessionId/host. Returns allow|deny with reasons and remaining budget; reserve:true also logs it as pending. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParametersrefhostpayTopayerapiKeynetworkreserveamountUsdsessionIdpaymentRequired
spend_record
Record x402 payment
0.002 USDC per call via x402, no key (unpaid call returns PaymentRequired; retry with params._meta["x402/payment"]). Record an x402 payment the agent made (or update a reserved one by spendId/ref): status settled|failed|pending|refunded, tx; verify:true checks a Base tx on-chain (read-only). Builds the spend log / receipts. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParameterstxrefhostnotepayTopayerapiKeystatusverifynetworkspendIdamountUsd+2 more
spend_log
Spend log / receipts
0.003 USDC per call via x402, no key (unpaid call returns PaymentRequired; retry with params._meta["x402/payment"]). Spend log / receipts for a payer address: totals (settled, pending, refunded), top sellers and the latest receipts over the last N days (1-31; read from Settle's own receipt records, not from Base RPC history). Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParametersdayslimitpayerapiKeysessionId
settle_key_status
Key status (free)
Show remaining calls/expiry of your MoneyTools Settle key. Needs a key mts_ (X-API-Key header or apiKey argument). No key? call settle_trial_key (free, 50 calls/7 days). Full plan 1 USDC/30d incl. 1,000 calls via x402.
ParametersapiKey
settle_trial_key
Get free trial key
Get a free MoneyTools Settle trial key right now (50 calls, 7 days, 1 per client per day; bucketed by IPv6 /64 or CF-Worker zone) with ready-to-run first calls. Pass the returned apiKey as the apiKey argument of any tool.
Takes no parameters.
settle_subscribe_info
Buy / trial info
Pricing: pay per call via x402 with no key (spend_check / spend_cap_get / spend_cap_set / spend_record 0.002, settle_verify / spend_log 0.003 USDC). Optional upgrade: 1 USDC / 30 days incl. 1,000 calls, or a free trial key. Read-only.
Takes no parameters.