Swap TON Tokens

Swap tokens on TON via DEX aggregator. Two-step flow: get a quote, confirm with the user, then execute.

MCP Tools

Tool Required Optional

get_swap_quote

fromToken , toToken , amount

walletSelector

send_raw_transaction

messages

walletSelector

get_known_jettons

— —

Workflow

• If the user mentions a token by name (e.g., "USDT", "jUSDC"), call get_known_jettons to resolve the jetton address

• Call get_swap_quote with fromToken , toToken , and amount

• Use "TON" for native TON, or the jetton master contract address for tokens

• Amount is human-readable (e.g., "1.5" = 1.5 TON)

• Show the quote details to the user and ask for confirmation

• Call send_raw_transaction with the transaction params returned by the quote

• Poll get_transaction_status with the returned normalizedHash until status is completed or failed (see ton-balance skill). User can ask to skip polling.

Notes

• Always confirm the swap with the user before executing

• The quote returns transaction messages ready for send_raw_transaction

• After execution, poll get_transaction_status by default. User can specify whether to check status.

• If no wallet is configured, use the ton-create-wallet skill first