MCP Server

Use This MCP server To

Check my TON wallet GRAM balance instantly View recent transactions on my TON account Generate a new TON wallet for my AI agent Get real-time token balances like USDT on TON Prepare unsigned swap transactions for GRAM and tokens Track cross-chain swap progress between TON and Ethereum Call read-only methods on TON smart contracts

README

@tonnode/mcp

Русская версия

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.

Built by TONNode — private TON liteservers, archive nodes, mempool stream and indexed API.

Quick start

Add to Claude Desktop, Claude Code, ChatGPT, Cursor, Codex or any MCP client:

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

That's the whole integration. The server connects to TON mainnet via the public global config by default. Ready-made configs for every client — plus programmatic Node.js usage — live in examples/.

Tools

Naming note: the native coin was renamed from Toncoin to GRAM in June 2026; the network itself is still called TON. Tool outputs use *_gram fields.

Tool	What it does	Typical question
`get_balance`	GRAM balance of an address	"How much GRAM does EQ… hold?"
`get_jetton_balance`	Jetton/token balance (USDT and any TEP-74 token)	"How much USDT is on this wallet?"
`get_jetton_info`	Token metadata: name, symbol, decimals, supply	"What are this jetton's decimals?"
`get_transactions`	Recent transactions: values, senders, fees	"Did my payment arrive?"
`get_account_state`	Status, deployment flags, last-tx pointer	"Is this contract deployed?"
`run_get_method`	Read-only get-methods on contracts	"Call `get_jetton_data` on this master"
`parse_address`	Convert/validate EQ…/UQ…/raw forms, offline	"Are these two addresses the same?"
`get_masterchain_info`	Masterchain head: seqno, shard, hashes	"Is the network (or my endpoint) alive?"
`get_swap_quote`	Firm DEX swap quote (GRAM ⇄ any jetton) via Omniston	"How much USDT for 100 GRAM right now?"
`build_swap_tx`	Unsigned, TonConnect-ready swap transaction	"Prepare that swap for my wallet to sign"
`get_crosschain_quote`	Quote TON → Ethereum/Arbitrum/Base/BNB/Polygon/Avalanche	"How much USDT on Ethereum for my TON USDT?"
`build_crosschain_swap_tx`	Unsigned HTLC escrow transaction + its secret	"Start that cross-chain swap"
`track_crosschain_swap`	Live phases of a cross-chain trade on both chains	"Did the resolver lock my USDT on Ethereum?"
`disclose_crosschain_secret`	Reveal the secret — atomically settles both sides	"Complete the swap"
`build_crosschain_refund`	Unsigned cancellation that reclaims escrowed funds	"The trade stalled — get my money back"
`generate_wallet`	Mint a fresh TON wallet (mnemonic + keys + address)	"Create a wallet for my agent to use"

mcp FAQ

Can I use this to check my TON wallet balance?

Yes — it provides real-time GRAM and token balances for any TON address.

Can I use this to view recent transactions on my TON account?

Yes — it shows detailed transaction history including senders, amounts, and fees.

Which apps support this MCP server?

It works with Claude Desktop, ChatGPT, Cursor, Codex, and any MCP-compatible client.

Do I need an API key or account to use this?

No API key is needed for basic access, but hosted endpoints may require authentication tokens.

How hard is it to set up?

Setup is easy — just paste a small config snippet into your MCP client.

Can I generate a new TON wallet using this?

Yes — it can create new wallets with mnemonic and keys for your agent to use.

Does it support token swaps?

Yes — it can get swap quotes and build unsigned transactions for GRAM and tokens.

Can it handle cross-chain swaps?

Yes — it supports atomic swaps between TON and Ethereum, Arbitrum, Base, BNB, Polygon, Avalanche.

Is my private key ever exposed to the server?

No — signing and private keys remain with you; the server only builds unsigned transactions.