Back to Details

ton-nfts

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

TON NFT Operations

TON NFT 操作

View and transfer NFTs on the TON blockchain.
在TON区块链上查看和转移NFT。

MCP Tools

MCP 工具

ToolRequiredOptional
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
工具必填参数可选参数
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

列出我的NFT

  1. Call 
    get_nfts
    to list NFTs in the active wallet
  2. Use 
    limit
    and 
    offset
    for pagination
  1. 调用
    get_nfts
    列出活跃钱包中的NFT
  2. 使用
    limit
    和
    offset
    实现分页

View NFT Details

查看NFT详情

  1. Call 
    get_nft
    with the 
    nftAddress
  1. 传入
    nftAddress
    调用
    get_nft

Send an NFT

发送NFT

  1. Call 
    get_nfts
    to find the NFT address if the user doesn't have it
  2. Ask one short yes/no confirmation before transferring the NFT
  3. Call 
    send_nft
    with 
    nftAddress
    and 
    toAddress
  4. Poll 
    get_transaction_status
    with the returned 
    normalizedHash
    until status is 
    completed
    or 
    failed
    (see 
    ton-balance
    skill)
  1. 如果用户没有NFT地址，调用
    get_nfts
    查找
  2. 转移NFT前询问用户一个简短的是/否确认
  3. 传入
    nftAddress
    和
    toAddress
    调用
    send_nft
  4. 使用返回的
    normalizedHash
    轮询
    get_transaction_status
    ，直到状态变为
    completed
    或
    failed
    （参考
    ton-balance
    技能）

Notes

注意事项

  • Use 
    emulate_transaction
    to 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-wallet
    skill first
  • 在发送交易前使用
    emulate_transaction
    进行模拟运行——它会返回预期的余额变化、手续费和高级操作信息，以便你验证结果
  • 转移NFT前务必获得用户确认；如果有宿主客户端的结构化确认UI，优先使用该UI，否则接受自然语言的是/否回复，不要求固定的确认短语
  • 如果未配置钱包，请先使用
    ton-create-wallet
    技能