用途:ton-balance 用于对 TON 区块链进行只读查询,查看钱包余额、代币持仓与交易历史,适合用户想检查余额、了解自己有多少 GRAM(原 TON)或列出代币持仓时使用。
主要能力:提供一组 MCP 工具。get_wallet 获取地址与网络信息;get_balance 获取 GRAM(原 TON)余额;get_balance_by_address 按指定地址查余额;get_jetton_balance 按 jettonAddress 查单个 Jetton 代币余额;get_jettons 列出全部代币持仓;get_jettons_by_address 按地址列出代币(可选 limit、offset);get_jetton_info 查代币信息;get_known_jettons 获取已知代币列表;get_transactions 查交易历史(可选 limit);get_transaction_status 按 normalizedHash 验证已发送交易状态。多数工具支持可选 walletSelector。
使用方式:查余额依次调用 get_wallet、get_balance、get_jettons;查特定代币可先用 get_known_jettons 找到地址,再用 get_jetton_balance 查询;查看历史调用 get_transactions 并可传 limit;验证发送或兑换交易时,用返回的 normalizedHash 调用 get_transaction_status。在 registry 模式下,传入 walletSelector 可查询指定钱包而非当前活动钱包。
适用场景:钱包余额与资产总览、按地址查询、单个 Jetton 代币查询、交易记录浏览与交易状态核验。
限制:所有工具均为只读,不涉及转账或写入操作,也无需确认。余额响应同时包含 amountRaw(原始整数字符串)与 amount(人类可读小数字符串,例如 1.5 GRAM),展示时应用 amount,仅在需要原始整数时使用 amountRaw。默认 limit 取值等细节资料暂未提供。