ton-connect/kit202 installs

ton-balance

Q: How do I install this agent skill?

Run npx skills add https://github.com/ton-connect/kit --skill ton-balance.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Check TON wallet balances, token holdings, and transaction history. Use when the user wants to check their balance, see how much GRAM (ex. TON) they have, list tokens, view jettons, check transaction history, look up a token, or verify a transaction status.

How do I install this agent skill?

npx skills add https://github.com/ton-connect/kit --skill ton-balance

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
This skill provides a set of read-only tools to query TON blockchain data, such as wallet balances, token (jetton) holdings, and transaction history. No security risks were identified.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues
Runlayerpass
1 file scanned · No issues

What does this agent skill do?

GRAM (ex. 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_wallet for address and network info
Call get_balance for GRAM (ex. 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
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.

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/ton-connect/kit/ton-balance">View ton-balance on skillZs</a>