MoneyTools Settle
Call before signing an x402 payment: advisory budget check, 0.005 USDC/call
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"settle": {
"url": "https://settle.moneytools.dev/mcp"
}
}
}Remote endpoints
https://settle.moneytools.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (17)
🟢settle_report(apiKey)
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.005 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).
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Optional Settle key mts_… (pays with 1 call instead of x402)."
}
}
}🟢settle_verify(apiKey, tx, payer, nonce, payTo, ...)
0.005 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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"tx": {
"type": "string",
"description": "Settlement tx hash on Base, 0x + 64 hex."
},
"payer": {
"type": "string",
"description": "Payer / agent wallet address 0x… (40 hex)."
},
"nonce": {
"type": "string",
"description": "EIP-3009 authorization nonce, 0x + 64 hex."
},
"payTo": {
"type": "string",
"description": "Seller receiving address 0x…."
},
"amount": {
"type": "string",
"description": "Expected amount in USDC atomic units (6 decimals), e.g. \"10000\" = 0.01 USDC."
},
"validBefore": {
"type": "number",
"description": "Authorization validBefore (unix seconds)."
},
"paymentPayload": {
"type": "string",
"description": "The x402 PAYMENT-SIGNATURE / X-PAYMENT payload (base64 JSON or object)."
}
}
}⚪settle_watch(apiKey, tx, payer, nonce, payTo, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"tx": {
"type": "string",
"description": "Settlement tx hash on Base, 0x + 64 hex."
},
"payer": {
"type": "string",
"description": "Payer / agent wallet address 0x… (40 hex)."
},
"nonce": {
"type": "string",
"description": "EIP-3009 authorization nonce, 0x + 64 hex."
},
"payTo": {
"type": "string",
"description": "Seller receiving address 0x…."
},
"amount": {
"type": "string",
"description": "Expected amount in USDC atomic units (6 decimals), e.g. \"10000\" = 0.01 USDC."
},
"validBefore": {
"type": "number",
"description": "Authorization validBefore (unix seconds)."
},
"paymentPayload": {
"type": "string",
"description": "The x402 PAYMENT-SIGNATURE / X-PAYMENT payload (base64 JSON or object)."
},
"webhook": {
"type": "string",
"description": "Public https URL we POST to when the status resolves."
}
}
}🟢settle_watch_status(apiKey, watchId)
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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"watchId": {
"type": "string",
"description": "Watch id stw_… from settle_watch."
}
}
}⚪settle_gate_claim(apiKey, payer, nonce, paymentPayload, network, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"payer": {
"type": "string",
"description": "Payer / agent wallet address 0x… (40 hex)."
},
"nonce": {
"type": "string",
"description": "EIP-3009 authorization nonce, 0x + 64 hex."
},
"paymentPayload": {
"type": "string",
"description": "The x402 PAYMENT-SIGNATURE / X-PAYMENT payload (base64 JSON or object)."
},
"network": {
"type": "string",
"description": "CAIP-2 network, default eip155:8453 (Base)."
},
"asset": {
"type": "string",
"description": "Token contract, default Base USDC."
}
}
}⚪settle_gate_complete(apiKey, gateId, status, tx)
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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"gateId": {
"type": "string",
"description": "Gate id from settle_gate_claim."
},
"status": {
"type": "string",
"description": "New status (see tool description)."
},
"tx": {
"type": "string",
"description": "Settlement tx hash on Base, 0x + 64 hex."
}
}
}🟡receipt_create(apiKey, ref, tx, amountUsd, webhook, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"ref": {
"type": "string",
"description": "Your order / request id (idempotency key)."
},
"tx": {
"type": "string",
"description": "Settlement tx hash on Base, 0x + 64 hex."
},
"amountUsd": {
"type": "string",
"description": "USD amount as decimal string, e.g. \"0.25\"."
},
"webhook": {
"type": "string",
"description": "Public https URL we POST to when the status resolves."
},
"note": {
"type": "string",
"description": "Free-text note (max 200 chars)."
}
}
}🟡receipt_update(apiKey, receiptId, ref, status, note, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"receiptId": {
"type": "string",
"description": "Receipt id str_… (or use ref)."
},
"ref": {
"type": "string",
"description": "Your order / request id (idempotency key)."
},
"status": {
"type": "string",
"description": "New status (see tool description)."
},
"note": {
"type": "string",
"description": "Free-text note (max 200 chars)."
},
"refundTx": {
"type": "string",
"description": "Refund tx hash on Base, 0x + 64 hex."
}
}
}🟢receipt_get(apiKey, receiptId, ref)
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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"receiptId": {
"type": "string",
"description": "Receipt id str_… (or use ref)."
},
"ref": {
"type": "string",
"description": "Your order / request id (idempotency key)."
}
}
}🟡spend_cap_set(apiKey, payer, perCallUsd, perDayUsd, perSessionUsd, ...)
0.005 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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"payer": {
"type": "string",
"description": "Payer / agent wallet address 0x… (40 hex)."
},
"perCallUsd": {
"type": "string",
"description": "Max USD per single payment, e.g. \"0.10\"."
},
"perDayUsd": {
"type": "string",
"description": "Max USD per rolling 24h."
},
"perSessionUsd": {
"type": "string",
"description": "Max USD per sessionId."
},
"allowPayTo": {
"type": "array",
"items": {
"type": "string"
},
"description": "Allowed seller payTo addresses."
},
"allowHosts": {
"type": "array",
"items": {
"type": "string"
},
"description": "Allowed seller hostnames."
},
"allowNetworks": {
"type": "array",
"items": {
"type": "string"
},
"description": "Allowed CAIP-2 networks."
},
"ownerLock": {
"type": "string",
"description": "Owner secret (>=12 chars); once set, caps can only be loosened with it."
}
}
}🟢spend_cap_get(apiKey, payer, sessionId)
0.005 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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"payer": {
"type": "string",
"description": "Payer / agent wallet address 0x… (40 hex)."
},
"sessionId": {
"type": "string",
"description": "Your session / run id."
}
}
}🟢spend_check(apiKey, payer, paymentRequired, amountUsd, payTo, ...)
0.005 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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"payer": {
"type": "string",
"description": "Payer / agent wallet address 0x… (40 hex)."
},
"paymentRequired": {
"type": "string",
"description": "The 402 PAYMENT-REQUIRED header (base64) or the 402 JSON body."
},
"amountUsd": {
"type": "string",
"description": "USD amount as decimal string, e.g. \"0.25\"."
},
"payTo": {
"type": "string",
"description": "Seller receiving address 0x…."
},
"host": {
"type": "string",
"description": "Seller hostname, e.g. api.example.com."
},
"network": {
"type": "string",
"description": "CAIP-2 network, default eip155:8453 (Base)."
},
"sessionId": {
"type": "string",
"description": "Your session / run id."
},
"ref": {
"type": "string",
"description": "Your order / request id (idempotency key)."
},
"reserve": {
"type": "boolean",
"description": "true = log this payment as pending if allowed."
}
}
}🟡spend_record(apiKey, payer, spendId, ref, amountUsd, ...)
0.005 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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"payer": {
"type": "string",
"description": "Payer / agent wallet address 0x… (40 hex)."
},
"spendId": {
"type": "string",
"description": "Spend id sp_… from spend_check reserve."
},
"ref": {
"type": "string",
"description": "Your order / request id (idempotency key)."
},
"amountUsd": {
"type": "string",
"description": "USD amount as decimal string, e.g. \"0.25\"."
},
"paymentRequired": {
"type": "string",
"description": "The 402 PAYMENT-REQUIRED header (base64) or the 402 JSON body."
},
"payTo": {
"type": "string",
"description": "Seller receiving address 0x…."
},
"host": {
"type": "string",
"description": "Seller hostname, e.g. api.example.com."
},
"network": {
"type": "string",
"description": "CAIP-2 network, default eip155:8453 (Base)."
},
"sessionId": {
"type": "string",
"description": "Your session / run id."
},
"tx": {
"type": "string",
"description": "Settlement tx hash on Base, 0x + 64 hex."
},
"status": {
"type": "string",
"description": "New status (see tool description)."
},
"verify": {
"type": "boolean",
"description": "true = verify tx on Base (read-only)."
},
"note": {
"type": "string",
"description": "Free-text note (max 200 chars)."
}
}
}🟢spend_log(apiKey, payer, days, sessionId, limit)
0.005 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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
},
"payer": {
"type": "string",
"description": "Payer / agent wallet address 0x… (40 hex)."
},
"days": {
"type": "number",
"description": "Look-back window in days (1-31, Settle receipt records)."
},
"sessionId": {
"type": "string",
"description": "Your session / run id."
},
"limit": {
"type": "number",
"description": "Max receipts returned."
}
}
}🟢settle_key_status(apiKey)
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.
Input Schema
{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Your MoneyTools Settle key mts_… (alternative to the X-API-Key header). No key: call settle_trial_key."
}
}
}🟢settle_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.
Input Schema
{
"type": "object",
"properties": {}
}🟢settle_subscribe_info
Pricing: pay per call via x402 with no key (spend_check / spend_cap_get / spend_cap_set / spend_record / settle_verify / spend_log 0.005 USDC). Optional upgrade: 1 USDC / 30 days incl. 1,000 calls, or a free trial key. Read-only.
Input Schema
{
"type": "object",
"properties": {}
}Community
Evidence