TONNode — TON blockchain access MCP Server

MCP server that gives AI agents direct liteserver access to The Open Network (TON) — no HTTP gateways in the middle. Balances, account state, transaction history and contract get-methods over TON's native ADNL protocol.

Local + remotestreamable-httpstdioMIT

What is the TONNode — TON blockchain access MCP Server?

TONNode — TON blockchain access source profile. From the maintainer documentation: “MCP server that gives AI agents direct liteserver access to The Open Network (TON) — no HTTP gateways in the middle. Balances, account state, transaction history and contract get-methods over TON's native ADNL protocol.”

Installation

The documented npm package is @tonnode/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_balanceGRAM balance of an address
get_jetton_balanceJetton/token balance (USDT and any TEP-74 token)
get_jetton_infoToken metadata: name, symbol, decimals, supply
get_transactionsRecent transactions: values, senders, fees
get_account_stateStatus, deployment flags, last-tx pointer
run_get_methodRead-only get-methods on contracts
parse_addressConvert/validate EQ…/UQ…/raw forms, offline
get_masterchain_infoMasterchain head: seqno, shard, hashes
get_swap_quoteFirm DEX swap quote (GRAM ⇄ any jetton) via Omniston
build_swap_txUnsigned, TonConnect-ready swap transaction
get_crosschain_quoteQuote TON → Ethereum/Arbitrum/Base/BNB/Polygon/Avalanche
build_crosschain_swap_txUnsigned HTLC escrow transaction + its secret
track_crosschain_swapLive phases of a cross-chain trade on both chains
disclose_crosschain_secretReveal the secret — atomically settles both sides
build_crosschain_refundUnsigned cancellation that reclaims escrowed funds
generate_walletMint a fresh TON wallet (mnemonic + keys + address)

How to install the TONNode — TON blockchain access MCP Server

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": [
        "-y",
        "@tonnode/mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.