TONNODE

Model Context Protocol

The TON MCP server

One package turns Claude, ChatGPT, Cursor, Codex or any MCP-compatible agent into a TON native — balances, account state, transactions and contract get-methods over raw ADNL, no HTTP gateways in between.

npm: @tonnode/mcp ↗GitHub: tonnode/mcp ↗
Quick start

Local · free

works today

Runs on your machine over the public global config. One block in the agent config — that's the whole integration.

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

Local · your private endpoint

works today

Same package, pointed at a TONNode liteserver: guaranteed throughput, archive depth for transaction history, no shared queues.

claude_config.json
{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@tonnode/mcp"],
      "env": {
        "TON_LITESERVERS": "[{\"ip\":\"<your-node>\",\"port\":41000,\"key\":\"<base64>\"}]"
      }
    }
  }
}

Hosted · mcp.tonnode.io

coming soon

Nothing to install: a remote MCP endpoint with your key, backed by our fleet. Plans below.

claude_config.json
{
  "mcpServers": {
    "ton": {
      "url": "https://mcp.tonnode.io/sse",
      "headers": { "Authorization": "Bearer tn_live_…" }
    }
  }
}
Tools
get_masterchain_infoCurrent masterchain head: seqno, shard, block hashes — network liveness at a glance
get_balanceGRAM balance of any address — in GRAM and nanoGRAM (GRAM is the renamed Toncoin)
get_account_stateStatus (active/frozen/uninit), balance, last-tx pointer, code and data flags
get_transactionsRecent transactions: logical time, value, fees — archive depth with a private endpoint
run_get_methodRead-only get-methods on contracts: seqno, get_wallet_address and friends
Why agents need this
  • Agents can't npm-install a library mid-conversation — they call tools. MCP is the standard socket.
  • Agents query in bursts: 40 calls to trace one jetton transfer. Public gateways throttle exactly that pattern.
  • History questions (“what did this wallet do in March?”) need archive depth — public liteservers keep none.
Hosted plans
HobbyFor experiments
$0
ProFor agents in production
$29/month
ScaleFor fleets of agents
$199/month
All pricing →