Connect AI agents to TON.

Read blockchain data, swap tokens, move assets across chains, and create wallets through one non-custodial MCP endpoint.

No card required · Working key in under 60 seconds

PUBLIC ROUTE~480 ms · 3 hops · queueHOP 1HOP 2HOP 3MCP CLIENTTONNodeMCP → ADNLDIRECT ROUTE~45 ms · dedicatedTON

The TONNode MCP server is a hosted Model Context Protocol endpoint that gives Claude, Cursor, Codex or any MCP client 16 TON tools: chain reads, jetton reads, DEX and cross-chain swap building, and wallet generation. It is non-custodial: swap tools return unsigned messages — the server never signs, broadcasts, or stores keys.

TONNode is a crypto MCP server built for one chain done deeply: real on-chain actions — DEX swaps, cross-chain transfers, wallet generation — not read-only queries.

The tools read sealed state. An agent that must react to a transfer before it is in a block can also read the TON mempool stream: pending external messages over WebSocket, filtered by wallet, recipient, op code or DEX pool, with early messages marked unverified.

16 MCP tools
Native ADNL
Non-custodial
Ready in under 60 seconds

Everything an agent needs to act on TON

Sixteen production-ready tools, exposed through a single authenticated MCP endpoint.

Chain data

Balances, jettons, NFTs, transactions, account state, and get-methods.

Explore tools

DEX swaps

Firm quotes and unsigned swap transactions through leading TON liquidity sources.

Explore tools

Cross-chain

Build and track non-custodial actions between TON and Ethereum.

Explore tools

Wallet tools

Generate wallets, validate addresses, and prepare transactions.

Explore tools

From installation to your first TON action in under a minute

Connect TONNode to any MCP-compatible client and give your agent access to 16 TON tools through one authenticated endpoint.

01

Install

Add TONNode to Claude, Cursor, or another MCP-compatible client.

02

Connect

Use the free public configuration or authenticate with a TONNode key for production throughput.

03

Act on TON

Read blockchain state, request DEX quotes, build cross-chain actions, and generate wallets.

One request. The complete TON workflow.

An agent can understand the request, select the appropriate TONNode tools, and return everything required for the user to sign the transaction.

claude_config.json

One configuration block. Start on the free public configuration and add a hosted key when you need production throughput.

View setup guide
TONNode

TONNode Agent

Connected via MCP

You
TONNodeTONNode Agent
You approve and sign in your own wallet. TONNode never holds funds or signs on your behalf.

Sixteen tools. One MCP endpoint.

Everything an agent needs to read TON, prepare transactions, move assets across chains, and work with wallets.

Start free. Scale when your agent needs more.

The public TON configuration is useful for experimentation. TONNode adds authenticated access, predictable throughput, and the complete action toolkit.

Public TON configuration

For testing and experiments

  • Shared public liteservers
  • Intended primarily for reading chain state
  • Anonymous access may be throttled
  • Swap and cross-chain tools are not included
  • Manual infrastructure assembly
  • Useful for testing and experiments
TONNode

TONNode

Production-ready in under 60 seconds

  • One authenticated MCP endpoint
  • 60–1200 requests per minute, depending on plan
  • All 16 tools
  • DEX swap tools
  • Cross-chain tools
  • Wallet generation
  • Non-custodial
  • Ready in under 60 seconds

Built for agents and apps that act on TON

From blockchain research to swaps and production Telegram products, TONNode gives every application the same reliable MCP toolkit.

AI agents that read TON

Give Claude, Cursor, Codex, or any MCP client instant access to balances, jettons, NFTs, transactions, account state, and get-methods.

Chain dataNative ADNLBurst-safe
Explore tools

Agents that swap and move value

Request firm DEX quotes, prepare unsigned swap transactions, and build non-custodial cross-chain actions between TON and Ethereum.

DEX swapsCross-chainNon-custodial
Explore tools

Telegram Mini Apps and bots

Handle traffic bursts with predictable throughput instead of depending entirely on shared public liteservers.

TelegramProduction trafficPredictable throughput
Explore tools

Wallets and automation

Read balances and history, generate wallets, validate addresses, and prepare transactions through one endpoint.

WalletsScriptsAutomation
Explore tools

Start free. Scale when your agent needs more.

All plans include the complete 16-tool TONNode MCP toolkit. Choose the throughput your application needs.

Hobby

For experiments and personal projects

$0Free forever
  • 60 requests per minute
  • All 16 tools
  • One API key
  • No credit card required
  • Key issued immediately after sign-in

Pro

For agents in production

$29per month
  • 300 requests per minute
  • All 16 tools
  • Priority throughput
  • Hosted authenticated endpoint
  • Non-custodial swap and cross-chain tools

Scale

For high-volume applications

$199per month
  • 1200 requests per minute
  • All 16 tools
  • Highest available throughput
  • Hosted authenticated endpoint
  • Built for sustained production traffic

Questions developers actually ask

One endpoint that turns any MCP client — Claude, Cursor, ChatGPT, or Codex — into a TON-native client. It exposes 16 tools for reading balances, jettons, NFTs, transactions, and get-methods over native ADNL, plus DEX swap quotes, cross-chain swaps, and wallet generation.

The swap, cross-chain, and wallet tools are strictly non-custodial. TONNode never signs transactions and never holds funds. It returns unsigned TonConnect messages that your wallet signs. Generated wallets are returned directly to you; the server keeps nothing.

The free Hobby key is issued as soon as you sign in with a TON wallet or Telegram. Pro and Scale keys activate after payment settles, typically in under a minute.

GRAM and USDT on the TON network are supported through TON Connect. BTC, ETH, SOL, and other currencies are available through an xRocket invoice inside Telegram. The key is issued automatically after payment settles.

Yes. `npx -y @tonnode/mcp` runs the server locally using TON's public global configuration, with the complete read toolkit and no signup or API key. A hosted TONNode key adds predictable throughput and a remote endpoint, so you do not need to operate the infrastructure yourself.

The public configuration works well for experiments. Public liteservers are shared and rate-limited, keep limited history, and may throttle the burst-style queries agents commonly make. A hosted TONNode key provides predictable throughput on dedicated infrastructure.

We retain aggregate request and error counters for billing and capacity planning. We do not log query payloads, blockchain addresses you inspect, or client IP addresses beyond what is required for abuse protection.

A paid monthly plan may be cancelled within the first seven days for a full refund in the currency used for payment. Live health for MCP, node access, and the API is published on the status page, so you can see the state of every component before and after you pay.

Give your agent the full TON toolkit.

Start with a free Hobby key. No credit card, all 16 tools, and a working connection in under a minute.

Non-custodial · Native ADNL · Ready in under 60 seconds