ton-swap

SKILL.md

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

  1. If the user mentions a token by name (e.g., "USDT", "jUSDC"), call get_known_jettons to resolve the jetton address
  2. 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)
  3. Show the quote details to the user and ask one short yes/no confirmation
  4. Call send_raw_transaction with the transaction params returned by the quote
  5. 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; prefer the host client's structured confirmation UI when available, otherwise accept natural-language yes/no and do not require a fixed confirmation phrase
  • 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
Weekly Installs
10
Repository
ton-connect/kit
GitHub Stars
21
First Seen
6 days ago
Installed on
cline10
github-copilot10
codex10
kimi-cli10
gemini-cli10
cursor10