ton-nfts
TON NFT Operations
View and transfer NFTs on the TON blockchain.
MCP Tools
| Tool | Required | Optional |
|---|---|---|
get_nfts |
— | limit, offset, walletSelector |
get_nfts_by_address |
address |
limit, offset |
get_nft |
nftAddress |
— |
send_nft |
nftAddress, toAddress |
comment, walletSelector |
emulate_transaction |
messages |
validUntil |
Workflows
List My NFTs
- Call
get_nftsto list NFTs in the active wallet - Use
limitandoffsetfor pagination
View NFT Details
- Call
get_nftwith thenftAddress
Send an NFT
- Call
get_nftsto find the NFT address if the user doesn't have it - Ask one short yes/no confirmation before transferring the NFT
- Call
send_nftwithnftAddressandtoAddress - Poll
get_transaction_statuswith the returnednormalizedHashuntil status iscompletedorfailed(seeton-balanceskill)
Notes
- Use
emulate_transactionto dry-run any transaction before sending — it returns expected balance changes, fees, and high-level actions so you can verify the outcome - Always confirm with the user before transferring an NFT; prefer the host client's structured confirmation UI when available, otherwise accept natural-language yes/no and do not require a fixed confirmation phrase
- If no wallet is configured, use the
ton-create-walletskill first
More from ton-connect/kit
ton-balance
Check TON wallet balances, token holdings, and transaction history. Use when the user wants to check their balance, see how much TON they have, list tokens, view jettons, check transaction history, look up a token, or verify a transaction status.
88ton-send
Send TON or jettons (tokens) to an address or TON DNS domain. Use when the user wants to send TON, transfer tokens, send jettons, pay someone, send funds to a .ton or .t.me domain, or transfer assets on the TON blockchain.
83ton-manage-wallets
Manage multiple TON wallets, import agentic wallets and rotate operator keys. Use when the user wants to switch wallets, list wallets, import an existing wallet, rotate an operator key, or manage their wallet registry.
83ton-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 TON, USDT, jUSDC, or any jetton. Covers phrases like "swap TON for USDT", "trade tokens", "buy USDT", "exchange jettons".
80ton-create-wallet
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.
80ton-cli
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 ...]`.
69