ton-connect/kit/ton-balance

GRAM (ex. TON) Balance & Transaction Queries

Read-only queries for wallet balances, token holdings, and transaction history on TON.

MCP Tools

Workflows

Check Balance

1. Call get_wallet for address and network info
2. Call get_balance for GRAM (ex. TON) balance
3. Call get_jettons for all token holdings

Check Specific Token

1. If user mentions a token by name, call get_known_jettons to find its address
2. Call get_jetton_balance with the jettonAddress

View Transaction History

1. Call get_transactions with an optional limit (default varies)

Verify a Sent Transaction

1. Call get_transaction_status with the normalizedHash returned by a send/swap operation

Notes

• All tools are read-only — no confirmation needed
• In registry mode, pass walletSelector to query a specific wallet instead of the active one
• All balance responses include both amountRaw (raw integer string) and amount (human-readable decimal string, e.g. "1.5" for 1.5 GRAM (ex. TON)). Use amount for display; use amountRaw only when a raw integer is required.