TONNode — TON blockchain access
Read TON blockchain data and build non-custodial swaps and wallets with 16 tools
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally or Remotely
- Version
- 0.9.2
- Listing updated
- 1 day ago
About TONNode — TON blockchain access
TONNode — TON blockchain access is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
The package talks to TON liteservers over the native ADNL protocol, with no HTTP gateway in between, and also runs as a hosted endpoint. Read tools return GRAM balances, jetton balances and metadata, transactions, account state, masterchain info and contract get-method results; the README notes the native coin was renamed from Toncoin to GRAM in June 2026.
Action tools stay non-custodial. get_swap_quote and build_swap_tx use Omniston for firm DEX quotes and unsigned TonConnect-ready transactions, and a set of cross-chain tools builds, tracks, settles or refunds escrow-based transfers between TON and Ethereum, Arbitrum, Base, BNB, Polygon and Avalanche. The server never signs or broadcasts. generate_wallet mints a new mnemonic and keys, which are returned to the caller, so the README says to treat them as hot wallets, and operators can disable the tool.
The free public configuration is throttled and read-focused; hosted plans run from $0 at 60 requests a minute to $199 at 1,200.
Install
Run in a terminal
claude mcp add --transport http mcp https://mcp.tonnode.io/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.tonnode.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.tonnode.io/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.tonnode.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://mcp.tonnode.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://mcp.tonnode.io/mcp"
}
}
}Configuration
TON_LITESERVERSOptional JSON array of private liteserver entries: [{"ip":"host","port":41000,"key":"<base64 ed25519>"}]. Defaults to the public global config.TON_NETWORKSet to "testnet" to use the testnet global config.
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- get_balance
- Returns the GRAM balance of an address.
- get_jetton_balance
- Returns a jetton or token balance.
- get_jetton_info
- Returns token name, symbol, decimals and supply.
- get_transactions
- Lists recent transactions with values, senders and fees.
- get_account_state
- Returns account status and deployment flags.
- run_get_method
- Calls a read-only get-method on a contract.
- parse_address
- Converts and validates address forms offline.
- get_masterchain_info
- Returns the masterchain head.
- get_swap_quote
- Returns a firm DEX swap quote.
- build_swap_tx
- Builds an unsigned swap transaction.
- get_crosschain_quote
- Quotes a transfer from TON to another chain.
- build_crosschain_swap_tx
- Builds an unsigned escrow transaction and its secret.
- track_crosschain_swap
- Shows the phases of a cross-chain trade.
- disclose_crosschain_secret
- Reveals the secret to settle both sides.
- build_crosschain_refund
- Builds an unsigned cancellation to reclaim escrowed funds.
- generate_wallet
- Creates a new TON wallet with mnemonic, keys and address.
What it does
- Native chain reads
- Balances, jettons, transactions, account state and get-methods via liteservers.
- DEX quotes
- Firm swap quotes and unsigned transactions for the user to sign.
- Cross-chain actions
- Build, track, settle and refund escrow transfers to other chains.
- Wallet generation
- Create new wallets in several contract versions, with a kill switch for operators.
- Mempool stream
- A separate paid WebSocket product for pending external messages.
Good for
- Check whether a payment arrived at an address
- Get a USDT quote for 100 GRAM
- Prepare an unsigned swap for a wallet to sign
- Create a wallet for an agent's ephemeral use
Pricing
Freemium, from $29 a month
Hobby free (60 req/min); Pro $29/mo; Scale $199/mo
Prices change. Check tonnode.io before you buy.
TONNode — TON blockchain access FAQ
Does it hold or sign with my funds?
No. Swap and cross-chain tools return unsigned messages; the server never signs, broadcasts or stores keys.
Is generate_wallet safe?
It returns secret key material, so treat generated wallets as hot; operators can set TONNODE_DISABLE_WALLET_GEN=1.
What does it cost?
A free tier at 60 requests a minute, Pro at $29 a month and Scale at $199.
Which networks does it support?
TON mainnet by default, with TON_NETWORK=testnet available.
Is TONNode — TON blockchain access free?
TONNode — TON blockchain access has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.
How do I add TONNode — TON blockchain access to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp https://mcp.tonnode.io/mcp
What are the best alternatives to TONNode — TON blockchain access?
The closest alternatives to TONNode — TON blockchain access are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to TONNode — TON blockchain access

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools