mcpField
T
ton-balance

ton-balance

github.com/ton-orgOther10113 installsUpdated 25w ago
Repository

About ton-balance

ton-balance is a read-only skill for querying TON wallet balances, token holdings, and transaction history. It suits agents handling wallet checks and transaction verification.

Key features

  1. 01Read TON wallet balance
  2. 02Query Jetton balances and holdings
  3. 03Look up known Jettons
  4. 04View transaction history
  5. 05Check transaction status

Use cases

  1. 01Review a wallet’s TON and token holdings
  2. 02Find a token address by its name
  3. 03Inspect recent wallet transactions
  4. 04Verify a sent transaction

MCP support

It uses MCP tools to query wallet, Jetton, and transaction data on TON. All listed operations are read-only.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ton-org/skills --skill ton-balance

After installing, type/ton-balancein Claude Code to confirm it loaded.

Details

From the project README

TON Balance & Transaction Queries

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

MCP Tools

ToolRequiredOptional
get_wallet—walletSelector
get_balance—walletSelector
get_balance_by_addressaddresswalletSelector
get_jetton_balancejettonAddresswalletSelector
get_jettons—walletSelector
get_jettons_by_addressaddresslimit, offset, walletSelector
get_jetton_infojettonAddresswalletSelector
get_known_jettons——
get_transactions—limit, walletSelector
get_transaction_statusnormalizedHashwalletSelector

Workflows

Check Balance
  1. Call get_wallet for address and network info
  2. Call get_balance for 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 TON). Use amount for display; use amountRaw only when a raw integer is required.

Comments

Markdown supported