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
- If the user mentions a token by name (e.g., "USDT", "jUSDC"), call
get_known_jettonsto resolve the jetton address - Call
get_swap_quotewithfromToken,toToken, andamount- Use
"TON"for native TON, or the jetton master contract address for tokens - Amount is human-readable (e.g.,
"1.5"= 1.5 TON)
- Use
- Show the quote details to the user and ask one short yes/no confirmation
- Call
send_raw_transactionwith the transaction params returned by the quote - Poll
get_transaction_statuswith the returnednormalizedHashuntil status iscompletedorfailed(seeton-balanceskill). 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_statusby default. User can specify whether to check status. - If no wallet is configured, use the
ton-create-walletskill first
Weekly Installs
10
Repository
ton-connect/kitGitHub Stars
21
First Seen
6 days ago
Security Audits
Installed on
cline10
github-copilot10
codex10
kimi-cli10
gemini-cli10
cursor10