ton-org/kit

ton-nfts

View and transfer NFTs on the TON blockchain.

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/ton-org/kit --skill ton-nfts

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

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
dallo stesso repository

Altri Skills

Tutti gli Skills