How do I install the Ton Swap skill?

Run npx skillmds@latest add ton-org/ton-swap in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ton Swap safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ton Swap?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ton Swap free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ton Swap?

ton-org (@ton-org) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ton Swap by ton-org — Agent Skill

Name: Ton Swap
Author: ton-org

Ton Swap

Swap or trade tokens on the TON blockchain via DEX. Use when the user wants to swap, trade, exchange, convert, buy, or sell tokens like GRAM (ex. TON), USDT, jUSDC, or any jetton. Covers phrases like "swap GRAM (ex. TON) for USDT", "trade tokens", "buy USDT", "exchange jettons".

ton-org b67a664 2.0 KB Updated Sep 17, 2026

File contents

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`
`emulate_transaction`	`messages`	`validUntil`
`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 GRAM (ex. TON), or the jetton master contract address for tokens
- Amount is human-readable (e.g., "1.5" = 1.5 GRAM (ex. TON))
Call emulate_transaction with the quote's transaction.messages to dry-run the swap — verify the expected money flow (GRAM (ex. TON)/jetton balance changes) before sending
Show the quote details and emulation results to the user and ask one short yes/no 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; 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

---name: ton-swapdescription: Swap or trade tokens on the TON blockchain via DEX. Use when the user wants to swap, trade, exchange, convert, buy, or sell tokens like GRAM (ex. TON), USDT, jUSDC, or any jetton. Covers phrases like "swap GRAM (ex. TON) for USDT", "trade tokens", "buy USDT", "exchange jettons".---# Swap TON TokensSwap 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` || `emulate_transaction` | `messages` | `validUntil` || `send_raw_transaction` | `messages` | `walletSelector` || `get_known_jettons` | — | — |## Workflow1. If the user mentions a token by name (e.g., "USDT", "jUSDC"), call `get_known_jettons` to resolve the jetton address2. Call `get_swap_quote` with `fromToken`, `toToken`, and `amount` - Use `"TON"` for native GRAM (ex. TON), or the jetton master contract address for tokens - Amount is human-readable (e.g., `"1.5"` = 1.5 GRAM (ex. TON))3. Call `emulate_transaction` with the quote's `transaction.messages` to dry-run the swap — verify the expected money flow (GRAM (ex. TON)/jetton balance changes) before sending4. Show the quote details and emulation results to the user and ask one short yes/no confirmation5. Call `send_raw_transaction` with the transaction params returned by the quote6. 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

Frequently asked questions