Skip to content
MCP server

TONNode — TON blockchain access

Read TON blockchain data and build non-custodial swaps and wallets with 16 tools

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.tonnode.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.tonnode.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools