tonnode/mcp

TON MCP server for Claude, ChatGPT, Cursor, Codex and any MCP client — liteserver queries over native ADNL: balances, account state, transaction history, get-methods. Private & archive endpoints suppo

About 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.

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/.

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 --------- getbalance GRAM balance of an address "How much GRAM does EQ… hold?" getjettonbalance Jetton/token balance (USDT and any TEP-74 token) "How much USDT is on this wallet?" gettransactions Recent transactions: values, senders, fees "Did my payment arrive?" getaccountstate Status, deployment flags, last-tx pointer "Is this contract deployed?" rungetmethod Read-only get-methods on contracts "Call getjettondata on this master" parseaddress Convert/validate EQ…/UQ…/raw forms, offline "Are these two addresses the same?" getmasterchaininfo Masterchain head: seqno, shard, hashes "Is the network (or my endpoint) alive?"

The package also ships a Streamable-HTTP entry for remote deployments (this is what powers mcp.tonnode.io):

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/tonnode--mcp.html)

Related MCP servers