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
—
get_jetton_balance
jettonAddress
walletSelector
get_jettons
— walletSelector
get_jettons_by_address
address
—
get_jetton_info
address
—
get_known_jettons
— —
get_transactions
— limit , walletSelector
get_transaction_status
normalizedHash
walletSelector
Workflows
Check Balance
-
Call get_wallet for address and network info
-
Call get_balance for TON balance
-
Call get_jettons for all token holdings
Check Specific Token
-
If user mentions a token by name, call get_known_jettons to find its address
-
Call get_jetton_balance with the jettonAddress
View Transaction History
- Call get_transactions with an optional limit (default varies)
Verify a Sent Transaction
- 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
-
Amounts are returned in human-readable format (e.g., "1.5" = 1.5 TON)