docs
Get startedTroubleshootingPaymentsWebhooksAgent paymentsSwop MCPOviIdentity (swop.id)SwivyRPC (preview)API reference
Tool reference

Money

Spending settings, sends, paying x402 links and EVM swaps. Every money action is previewed and capped.

5 tools. Generated from the Swop MCP server’s own tools/list (server version 0.2.2), so names, inputs and limits match what your client sees.

swop_get_spending_delegation

Get my AI spending settings · Sign-in: wallet.send · /mcp only · Read-only

The linked account's transaction delegation for AI assistants: whether it's active, per-transaction and daily caps, and how much of today's cap is already spent. Check before attempting a send.

No inputs.

swop_send

Send money or tokens to a swop.id or wallet address · Sign-in: wallet.send · /mcp only · Preview, then confirm · Changes or moves things

Send money or tokens from the linked Swop wallet to a swop.id handle or 0x address, within the caps the user set in the Swop app. Default is USDC on Base. Other tokens the wallet holds on Base, Ethereum, Polygon or Arbitrum work too — ETH, POL, or an ERC-20 with a liquid verified market — by symbol or 0x contract address, with chain. Size the send with amountUsd (USD, converted at Swop's verified price) OR amount (token units), never both. Solana is not supported here (the user sends Solana assets from the Swop app). TWO-STEP: call WITHOUT confirm first to get a preview (resolved recipient, token, chain, amount in token units and in USD, the price used, wallet balance, caps); show the user the token, chain, both amounts and the recipient, and get their explicit yes; then call again with the returned previewId, confirm: true and the same to/token/chain/amount — a confirm that states anything different from the preview is refused. Each preview executes at most once. Refused at preview: tokens the wallet does not hold, tokens without a verifiable USD price or with a thin market, sends on Ethereum under $5. Over-cap or confirm-only settings return a Swop-app approval link for USDC on Base; for any other token they are refused and the user sends it from the Swop app or raises their caps. Never call with confirm before the user has seen the preview.

InputTypeRequiredDescription
tostringYesRecipient: swop.id handle (e.g. "alice.swop.id") or 0x address (min length 1)
amountUsdnumberNoAmount in USD. For USDC this is the amount sent; for any other token it is converted at the verified price (max 1000; > 0)
amountstringNoAmount in token units as a decimal string (e.g. "0.25"). Use instead of amountUsd
tokenstringNoToken symbol (default USDC; ETH or POL for the native coin) or 0x contract address
chain"base" | "ethereum" | "polygon" | "arbitrum"NoChain the token is on (default base)
previewIdstringNoFrom the preview step
confirmbooleanNotrue ONLY after the user explicitly confirmed the preview

Pay an x402 payment link · Sign-in: payments.x402 · /mcp only · Preview, then confirm · Changes or moves things

Pay an external x402 payment link (any https URL that returns an HTTP 402 USDC challenge) from the linked user's Swop wallet, within their caps. TWO-STEP like swop_send: call WITHOUT confirm to preview (amount, payee, host, caps), show it to the user and get their explicit yes, then call again with the returned previewId and confirm: true. Over-cap or no delegation returns a Swop-app approval link. Base USDC only.

InputTypeRequiredDescription
urlstringYesThe x402 payment link (https) (format uri)
previewIdstringNoFrom the preview step
confirmbooleanNotrue ONLY after the user confirmed the preview

swop_get_swap_quote

Get a token swap quote · Sign-in: wallet.trade · /mcp only · Read-only

Get a swap quote for the linked user — EVM (via LiFi) or Solana (via Jupiter). Read-only: returns the estimated output and directs the user to complete the swap in the Swop app. For EVM, pass chain plus token ADDRESSES; for Solana, omit chain and pass token MINTS. Amounts are in the input token's base units.

InputTypeRequiredDescription
inputMintstringYesInput token: EVM contract address, or Solana mint
outputMintstringNoOutput token: EVM address, or Solana mint (default USDC)
amountstringYesInput amount in base units (wei / lamports / token decimals)
chainstringNoEVM chain for a LiFi quote: base, ethereum, polygon, arbitrum, optimism, or a numeric chain id. Omit for a Solana (Jupiter) quote.

swop_swap

Execute a token swap (EVM) · Sign-in: wallet.trade · /mcp only · Preview, then confirm · Changes or moves things

Execute an on-chain token swap from the linked user's Swop wallet, within their delegation caps. EVM only (via LiFi); Solana swaps still complete in the app. TWO-STEP like swop_send: call WITHOUT confirm to preview (estimated output, min received, USD value, caps); show the user the estimated output and get their explicit yes; then call again with the returned previewId and confirm: true. Gas is sponsored, and any needed token approval is handled automatically. Over-cap or no delegation returns a Swop-app approval link. Pass chain plus token ADDRESSES; amount is in the input token's base units.

InputTypeRequiredDescription
inputMintstringYesInput token EVM contract address
outputMintstringYesOutput token EVM contract address
amountstringYesInput amount in base units (wei / token decimals)
chainstringYesEVM chain: base, ethereum, polygon, arbitrum, or a numeric chain id
previewIdstringNoFrom the preview step
confirmbooleanNotrue ONLY after the user confirmed the preview (output shown)

On this page