MoneyTools Settle

Call before signing an x402 payment: advisory budget check, 0.005 USDC/call

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
83%
Naming quality
91%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~4,606Tokens (tool definitions)
~1.5 KBTypical response size
Significant attention impact (3.60% of 128k context)

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-http

What it can do

Tool inventory

Tools (17)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded17 tools