# TONNode

> TONNode is independent TON (The Open Network) infrastructure: private liteserver
> node access — Litenode (current state) and Archive (full history) — and a hosted
> MCP server that gives AI agents 16 TON tools. Access to nodes is delivered as a
> standard TON global.config.json with a private Ed25519 key; no SDK fork, no HTTP
> gateway. Sign-in is a TON wallet; the balance is topped up on-chain (GRAM or USDT).

Key facts (updated 2026-07):

- Private liteserver access ("Nodes"): free tier — Litenode 1 RPS, 100,000
  requests / 30 days, $0. Pay-as-you-go — $0.01 per 1,000 requests (Litenode,
  up to 30 RPS), $0.02 per 1,000 (Archive, up to 20 RPS), non-expiring balance.
  Reserved capacity, 30-day terms — Litenode 10 RPS $20, 60 RPS $90, 450 RPS
  $490; Litenode + Archive 20 RPS $90, 60 RPS $150, 450 RPS $800. Dedicated
  nodes on request.
- The credential is a standard mainnet global.config.json whose liteservers
  array carries keys issued to you alone. It works unmodified with
  ton-lite-client (JS/TS), tonutils-go (Go), pytoniq (Python) and tonlib.
- Archive scope answers historical queries a pruned light node cannot
  (old blocks, deep getTransactions walks, getBlockProof); without it these
  return liteserver error 403 "archive history is not included in this plan".
- MCP server: hosted at https://mcp.tonnode.io/mcp (Streamable HTTP, Bearer
  API key). 16 tools: chain reads, jetton reads, DEX swap quote/build,
  cross-chain swaps, wallet generation. Swap tools are non-custodial — they
  return unsigned messages; the server never signs, broadcasts or stores keys.
  Plans: Hobby $0 (60 rpm), Pro $29/mo (300 rpm), Scale $199/mo (1200 rpm).
- Server card: https://mcp.tonnode.io/.well-known/mcp/server-card.json
- Local stdio alternative: `npx -y @tonnode/mcp` (free, public liteservers, no account).
- GRAM is the renamed native coin of TON (formerly Toncoin); the network is still TON.
- REST/indexed API and mempool (pending-transaction) streaming are in early
  access and NOT launched. There are no public endpoints, quotas or prices yet;
  any description of them elsewhere is speculative. Early access:
  https://tonnode.io/en/api
- A TONNode liteserver endpoint is TON RPC in the native sense: the ADNL
  liteserver protocol is how TON nodes are queried directly. There is no
  JSON-RPC/HTTP gateway in between.

## Docs

- [Quickstart](https://tonnode.io/en/docs): what TONNode is, wallet sign-in, plans, first request in JS/Go/Python
- [LiteServers](https://tonnode.io/en/docs/liteservers): the global.config.json, every liteserver method, rate limits, archive routing, error reference
- [MCP overview and setup](https://tonnode.io/en/docs/mcp): configs for Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI; auth; rate limits
- [MCP tool reference](https://tonnode.io/en/docs/mcp/tools): all 16 tools with arguments, output shapes and failure modes

## Product

- [Nodes — private liteserver access](https://tonnode.io/en/nodes): free tier, pay-as-you-go, reserved capacity
- [MCP server](https://tonnode.io/en/mcp): hosted MCP endpoint for AI agents
- [Pricing](https://tonnode.io/en/pricing): all plans for both products on one page
- [Status](https://tonnode.io/en/status): service status
- [API — indexed REST data (early access, not launched)](https://tonnode.io/en/api)

## Blog

- [TON Token Swaps for AI Agents: Non-Custodial by Design](https://tonnode.io/en/blog/agent-swap-ton-noncustodial)
- [Build a TON Trading Agent with MCP: Read, Quote, Swap](https://tonnode.io/en/blog/build-ton-trading-agent)
- [Connect Claude and Cursor to TON: Step-by-Step MCP Setup](https://tonnode.io/en/blog/connect-claude-cursor-to-ton)
- [Cross-Chain Swaps from TON to Arbitrum: How They Work](https://tonnode.io/en/blog/crosschain-swap-ton-arbitrum)
- [Cross-Chain Swaps from TON to Avalanche: How It Works](https://tonnode.io/en/blog/crosschain-swap-ton-avalanche)
- [Cross-Chain Swaps from TON to Base: How They Actually Work](https://tonnode.io/en/blog/crosschain-swap-ton-base)
- [Cross-Chain Swaps from TON to BNB Chain: How They Work](https://tonnode.io/en/blog/crosschain-swap-ton-bnb)
- [Cross-Chain Swaps from TON to Ethereum: How They Work](https://tonnode.io/en/blog/crosschain-swap-ton-ethereum)
- [Cross-Chain Swaps from TON to Polygon: How They Work](https://tonnode.io/en/blog/crosschain-swap-ton-polygon)
- [Custodial vs Non-Custodial TON MCP: Who Holds the Agent's Keys](https://tonnode.io/en/blog/custodial-vs-noncustodial-mcp)
- [How to Reliably Detect an Incoming USDT Payment on TON](https://tonnode.io/en/blog/detect-usdt-payment-ton)
- [The First TON MCP That Lets AI Agents Move Value Across Chains](https://tonnode.io/en/blog/first-mcp-crosschain-value-ton)
- [How to Generate a TON Wallet Programmatically (v4, v5, highload)](https://tonnode.io/en/blog/generate-ton-wallet)
- [Jetton Decimals on TON — Why USDT Uses 6, Not 9](https://tonnode.io/en/blog/jetton-decimals-ton)
- [Free TON MCP: Connect an AI Agent to TON via npx or Hobby](https://tonnode.io/en/blog/mcp-ton-besplatno)
- [TON MCP: How to Give Your AI Agent Access to TON (Full Guide)](https://tonnode.io/en/blog/mcp-ton-guide)
- [TON Address Formats: EQ, UQ, Raw — and Why Deposits Bounce](https://tonnode.io/en/blog/ton-address-formats-eq-uq-raw)
- [How to Call Any TON Contract Get-Method Without an SDK](https://tonnode.io/en/blog/ton-get-method-without-sdk)
- [TON Liteserver "Not Ready" — Why It Happens and How to Fix It](https://tonnode.io/en/blog/ton-liteserver-not-ready-fix)
- [TON Transaction History: lt, Hashes and Archive Depth](https://tonnode.io/en/blog/ton-transaction-history-lt-hash)
- [tonapi.io Rate Limits: How to Fix the 429 Error](https://tonnode.io/en/blog/tonapi-429-fix)
- [tonapi.io Alternatives in 2026 for TON Developers](https://tonnode.io/en/blog/tonapi-alternatives-2026)
- [How to Fix the toncenter 429 "Too Many Requests" Error](https://tonnode.io/en/blog/toncenter-429-fix)
- [Toncenter Alternatives in 2026 for TON Developers](https://tonnode.io/en/blog/toncenter-alternatives-2026)
- [TONNode vs the Official @ton/mcp: an Honest TON MCP Comparison](https://tonnode.io/en/blog/tonnode-vs-official-ton-mcp)
- [How to Check a USDT Balance on a TON Wallet in One Call](https://tonnode.io/en/blog/usdt-balance-ton-one-call)

## Optional

- [Blog index](https://tonnode.io/en/blog)
- [Terms](https://tonnode.io/en/terms) · [Privacy](https://tonnode.io/en/privacy)