ton-org

Check TON wallet balances, token holdings, and transaction history. Use when the user wants to check their balance, see how much GRAM (ex. TON) they have, list tokens, view jettons, check transaction history, look up a token, or verify a transaction status.

Call TON MCP tools directly from the command line. Use when you want to query wallet info, check balances, send transactions, or run any TON wallet tool without starting an MCP server session. Works via `npx @ton/mcp@alpha <tool_name> [--arg value ...]`.

Create and deploy a TON agentic wallet. Use when the user wants to create a wallet, set up an agent wallet, deploy an agentic wallet, onboard a new wallet, or when any wallet operation fails because no wallet is configured. This skill is a prerequisite before sending, swapping, or managing assets.

Send GRAM (ex. TON) or jettons (tokens) to an address or TON DNS domain. Use when the user wants to send GRAM (ex. TON), transfer tokens, send jettons, pay someone, send funds to a .ton or .t.me domain, or transfer assets on the TON blockchain.

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".

Buy or sell Backed xStocks (tokenized equities, e.g. TSLAx) on TON using jetton addresses from the xStocks API and TON MCP swap tools. Use when the user asks for xStocks, xStock, TSLAx, stock tokens on TON, or buying/selling equity jettons via Omniston.

Guides development across the @ton/kit monorepo (walletkit, appkit, appkit-react) — adding actions, queries, hooks, and components inside the SDK packages, fixing bugs in source, writing tests, creating examples and docs, and reviewing PRs. Covers SDK-internal concerns: cache invalidation patterns, query key naming, streaming provider plumbing, walletkit-package boundary, action/hook templates, and monorepo architecture. Activates when editing files under `packages/walletkit*`, `packages/appkit*`, or making changes to the SDK itself.

Use this skill whenever the user is building an app with @ton/appkit or @ton/appkit-react as a library consumer: setup, TonConnect wallet connection, balances, sending TON/jettons/NFTs, swaps, staking, signing, real-time WebSocket updates, cache invalidation, mainnet/testnet switching, SSR/Next.js hydration, Telegram Mini App returns, iOS deep links, or debugging stale wallet/network/transaction behavior. Do not use for contributing code to the @ton/kit monorepo itself; use kit-dev for repo-internal development tasks.

Searches and references official TON blockchain documentation, standards (TEPs), and SDK guides via the TON Docs MCP server. Use this skill when answering questions about TON architecture, smart contracts, FunC, Tact, Tolk, TL-B schemas, validators, sharding, message routing, wallet contracts, jetton standard (TEP-74), NFT standard (TEP-62), TON addresses, BOC encoding, or any TON protocol details.

Use this skill when checking TON wallet balances, token holdings, or transaction history. It retrieves how much TON or jettons a wallet holds, lists tokens, looks up token details, checks transaction history, and verifies transaction status. Also use when the user asks about their funds, portfolio, or recent activity on TON.

Use this skill when invoking TON MCP tools directly from the command line. It calls any TON wallet tool via `npx @ton/mcp@alpha <tool_name> [--arg value ...]` without starting an MCP server session. Also use when querying wallet info, checking balances, sending transactions, or running raw TON MCP commands from the terminal.

Use this skill when creating or deploying a TON agentic wallet. It generates operator keys and deploys an on-chain agentic wallet. Also use when setting up a new agent wallet, onboarding a wallet, or when any wallet operation fails because no wallet is configured. This skill is a prerequisite before sending, swapping, or managing assets on TON.

Use this skill when managing multiple TON wallets, importing agentic wallets, or rotating operator keys. It switches between wallets, lists all wallets in the registry, imports existing wallets, and rotates operator keys. Also use when the user mentions wallet management, switching accounts, or key rotation on TON.

Use this skill when viewing or transferring NFTs on the TON blockchain. It lists collectibles, checks NFT details, and sends NFTs to other addresses. Also use when the user mentions collectibles, digital assets, NFT collections, or wants to send an NFT to someone on TON.

Use this skill when sending TON or jettons (tokens) to an address or TON DNS domain. It transfers TON, jettons, or other assets to any wallet address, .ton domain, or .t.me domain. Also use when the user wants to pay someone, send funds, transfer tokens, or move assets on the TON blockchain.

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 TON, USDT, jUSDC, or any jetton. Covers phrases like "swap TON for USDT", "trade tokens", "buy USDT", "exchange jettons".