TON Balance & Transaction Queries
Read-only queries for wallet balances, token holdings, and transaction history on TON.
MCP Tools
| Tool | Required | Optional |
|---|---|---|
get_wallet | — | walletSelector |
get_balance | — | walletSelector |
get_balance_by_address | address | walletSelector |
get_jetton_balance | jettonAddress | walletSelector |
get_jettons | — | walletSelector |
get_jettons_by_address | address | limit, offset, walletSelector |
get_jetton_info | jettonAddress | walletSelector |
get_known_jettons | — | — |
get_transactions | — | limit, walletSelector |
get_transaction_status | normalizedHash | walletSelector |
Workflows
Check Balance
- Call
get_walletfor address and network info - Call
get_balancefor TON balance - Call
get_jettonsfor all token holdings
Check Specific Token
- If user mentions a token by name, call
get_known_jettonsto find its address - Call
get_jetton_balancewith thejettonAddress
View Transaction History
- Call
get_transactionswith an optionallimit(default varies)
Verify a Sent Transaction
- Call
get_transaction_statuswith thenormalizedHashreturned by a send/swap operation
Notes
- All tools are read-only — no confirmation needed
- In registry mode, pass
walletSelectorto query a specific wallet instead of the active one - All balance responses include both
amountRaw(raw integer string) andamount(human-readable decimal string, e.g."1.5"for 1.5 TON). Useamountfor display; useamountRawonly when a raw integer is required.