@tonnode/mcp on npm →
TONNode

Connect AI agents to TON.

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

Start freeExplore 16 tools

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
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 Agent

Connected via MCP

You
TONNode 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.

get_balance

Read the TON balance of any account.

get_transactions

Fetch recent transactions for an address.

get_account_state

Inspect account status, code, and data.

run_get_method

Call any contract get-method with arguments.

get_masterchain_info

Read the latest masterchain block info.

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

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
Start free — no card required

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
Get free key

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
Choose Pro

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
Choose Scale

Questions developers actually ask

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.

Start freeRead the docs

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