ton-org/kit

ton-nfts

View and transfer NFTs on the TON blockchain.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/ton-org/kit --skill ton-nfts

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

TON NFT Operations

View and transfer NFTs on the TON blockchain.

MCP Tools

ToolRequiredOptional
get_nfts—limit, offset, walletSelector
get_nfts_by_addressaddresslimit, offset
get_nftnftAddress—
build_nft_transfernftAddress, toAddresscomment, walletSelector
emulate_transactionmessagesvalidUntil
send_raw_transactionmessagesvalidUntil, 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

  1. Call get_nfts to list NFTs in the active wallet
  2. Use limit and offset for pagination

View NFT Details

  1. Call get_nft with the nftAddress

Send an NFT

  1. Call get_nfts to find the NFT address if the user doesn't have it
  2. Call build_nft_transfer with nftAddress and toAddress to build the transaction (it is NOT sent)
  3. Preview it with emulate_transaction using the returned transaction.messages (recommended before broadcasting)
  4. Ask one short yes/no confirmation before transferring the NFT
  5. Broadcast with send_raw_transaction passing the transaction.messages and transaction.fromAddress (the NFT transfer is bound to the wallet it was built for)
  6. Poll get_transaction_status with the returned normalizedHash until status is completed or failed (see ton-balance skill)

Notes

  • build_nft_transfer builds the transaction only; send_raw_transaction is the tool that signs and broadcasts it
  • Use emulate_transaction to 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-wallet skill first
from this repository

More skills

All skills