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, a mempool stream and a REST API (early access, on request).
Quick start
Add to Claude Desktop, Claude Code, ChatGPT, Cursor, Codex or any MCP client:
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"* |
Wallet generation
generate_wallet mints a brand-new wallet — a 24-word mnemonic, its ed25519 keypair and the address for the chosen contract version (**v4** default, plus **v3r2**, **v5r1** and **highload_v3** for mass payouts). The v3r2/v4/v5r1 addresses come from @ton/ton's canonical contracts; highload_v3 is derived from the official contract code and cross-checked against a maintained reference implementation.
> ⚠️ **This returns secret key material.** In hosted mode the keys are generated on the server and returned over TLS — treat every generated wallet as **hot**: fine for programmatic/ephemeral use, but move any meaningful balance to cold storage, and keep the response out of logs and shared transcripts. The server never stores or logs the mnemonic or private key (only the public address). Operators can set TONNODE_DISABLE_WALLET_GEN=1 to remove the tool entirely.
Swaps — agents that can actually trade
get_swap_quote and build_swap_tx are powered by Omniston, STON.fi's RFQ protocol aggregating STON.fi and DeDust liquidity. No API key needed.