ton-nfts
View and transfer NFTs on the TON blockchain. Use when the user wants to see their NFTs, list collectibles, check NFT details, send an NFT, or transfer an NFT to someone.
How do I install this agent skill?
npx skills add https://github.com/ton-connect/kit --skill ton-nftsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates TON blockchain NFT operations, including viewing and transferring collectibles. It employs security best practices such as transaction emulation and explicit user confirmation for transfers. A low-risk surface for indirect prompt injection is identified in the processing of blockchain-sourced NFT metadata.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
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 | — |
build_nft_transfer | nftAddress, toAddress | comment, walletSelector |
emulate_transaction | messages | validUntil |
send_raw_transaction | messages | validUntil, fromAddress, walletSelector |
build_nft_transfer does NOT broadcast — it returns ready-to-send transaction.messages plus transaction.fromAddress. Preview with emulate_transaction, then broadcast with send_raw_transaction.
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 - Call
build_nft_transferwithnftAddressandtoAddressto build the transaction (it is NOT sent) - Preview it with
emulate_transactionusing the returnedtransaction.messages(recommended before broadcasting) - Ask one short yes/no confirmation before transferring the NFT
- Broadcast with
send_raw_transactionpassing thetransaction.messagesandtransaction.fromAddress(the NFT transfer is bound to the wallet it was built for) - Poll
get_transaction_statuswith the returnednormalizedHashuntil status iscompletedorfailed(seeton-balanceskill)
Notes
build_nft_transferbuilds the transaction only;send_raw_transactionis the tool that signs and broadcasts it- Use
emulate_transactionto preview expected balance changes before broadcasting (fake signature) - 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/ton-connect/kit/ton-nfts">View ton-nfts on skillZs</a>