# TONNode — TON blockchain access

> TONNode — TON blockchain access is a freemium MCP server for finance and payments. Read TON blockchain data and build non-custodial swaps and wallets with 16 tools. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, CLI
- **Website:** https://tonnode.io/mcp
- **Repository:** https://github.com/tonnode/mcp
- **MCP Registry name:** io.github.tonnode/mcp
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-16

## About

The package talks to TON liteservers over the native ADNL protocol, with no HTTP gateway in between, and also runs as a hosted endpoint. Read tools return GRAM balances, jetton balances and metadata, transactions, account state, masterchain info and contract get-method results; the README notes the native coin was renamed from Toncoin to GRAM in June 2026.

Action tools stay non-custodial. get_swap_quote and build_swap_tx use Omniston for firm DEX quotes and unsigned TonConnect-ready transactions, and a set of cross-chain tools builds, tracks, settles or refunds escrow-based transfers between TON and Ethereum, Arbitrum, Base, BNB, Polygon and Avalanche. The server never signs or broadcasts. generate_wallet mints a new mnemonic and keys, which are returned to the caller, so the README says to treat them as hot wallets, and operators can disable the tool.

The free public configuration is throttled and read-focused; hosted plans run from $0 at 60 requests a minute to $199 at 1,200.

## Features

- **Native chain reads:** Balances, jettons, transactions, account state and get-methods via liteservers.
- **DEX quotes:** Firm swap quotes and unsigned transactions for the user to sign.
- **Cross-chain actions:** Build, track, settle and refund escrow transfers to other chains.
- **Wallet generation:** Create new wallets in several contract versions, with a kill switch for operators.
- **Mempool stream:** A separate paid WebSocket product for pending external messages.

## Good for

- Check whether a payment arrived at an address
- Get a USDT quote for 100 GRAM
- Prepare an unsigned swap for a wallet to sign
- Create a wallet for an agent's ephemeral use

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.tonnode.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.tonnode.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.tonnode.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.tonnode.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp"
    }
  }
}
```

## Tools

- `get_balance`: Returns the GRAM balance of an address.
- `get_jetton_balance`: Returns a jetton or token balance.
- `get_jetton_info`: Returns token name, symbol, decimals and supply.
- `get_transactions`: Lists recent transactions with values, senders and fees.
- `get_account_state`: Returns account status and deployment flags.
- `run_get_method`: Calls a read-only get-method on a contract.
- `parse_address`: Converts and validates address forms offline.
- `get_masterchain_info`: Returns the masterchain head.
- `get_swap_quote`: Returns a firm DEX swap quote.
- `build_swap_tx`: Builds an unsigned swap transaction.
- `get_crosschain_quote`: Quotes a transfer from TON to another chain.
- `build_crosschain_swap_tx`: Builds an unsigned escrow transaction and its secret.
- `track_crosschain_swap`: Shows the phases of a cross-chain trade.
- `disclose_crosschain_secret`: Reveals the secret to settle both sides.
- `build_crosschain_refund`: Builds an unsigned cancellation to reclaim escrowed funds.
- `generate_wallet`: Creates a new TON wallet with mnemonic, keys and address.

## FAQ

### Does it hold or sign with my funds?

No. Swap and cross-chain tools return unsigned messages; the server never signs, broadcasts or stores keys.

### Is generate_wallet safe?

It returns secret key material, so treat generated wallets as hot; operators can set TONNODE_DISABLE_WALLET_GEN=1.

### What does it cost?

A free tier at 60 requests a minute, Pro at $29 a month and Scale at $199.

### Which networks does it support?

TON mainnet by default, with TON_NETWORK=testnet available.

### Is TONNode — TON blockchain access free?

TONNode — TON blockchain access has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

### How do I add TONNode — TON blockchain access to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.tonnode.io/mcp

### What are the best alternatives to TONNode — TON blockchain access?

The closest alternatives to TONNode — TON blockchain access are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tonnode-ton-blockchain-access
