# TONNode — TON blockchain access

Gives AI assistants direct liteserver access to TON via native ADNL. Checks GRAM or jetton balances, queries smart contracts, and prepares non-custodial DEX swaps.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 27
- Author: tonnode
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tonnode/mcp
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/tonnode-ton-blockchain-access

## What it does

The server connects straight to TON liteservers without relying on intermediate web gateways. By speaking the native ADNL protocol, it inspects account states, fetches transaction logs, and tracks balances for GRAM and TEP-74 jettons. It also runs read-only contract get-methods without paying gas fees.

Trading operations pull liquidity quotes through Omniston. The agent receives an unsigned payload formatted for TonConnect wallets, covering DEX swaps and cross-chain HTLC escrows toward networks like Ethereum or Arbitrum. The process stays strictly non-custodial: signing authority never leaves the user.

Wallet creation outputs a 24-word seed phrase straight into the agent session. Storing significant funds on such generated addresses is unsafe, making them suitable only for disposable bot tasks. Run the tool locally via `npx` or route requests through the hosted HTTP endpoint.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.tonnode.io/mcp`
- Environment variables: `TON_LITESERVERS`, `TON_NETWORK` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.tonnode.io/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env TON_LITESERVERS=<TON_LITESERVERS> --env TON_NETWORK=<TON_NETWORK> --transport stdio tonnode-ton-blockchain-access -- npx -y @tonnode/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add tonnode-ton-blockchain-access --url https://mcp.tonnode.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add tonnode-ton-blockchain-access --env TON_LITESERVERS=<TON_LITESERVERS> --env TON_NETWORK=<TON_NETWORK> -- npx -y @tonnode/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tonnode-ton-blockchain-access": {
            "url": "https://mcp.tonnode.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tonnode-ton-blockchain-access": {
            "command": "npx",
            "args": [
                "-y",
                "@tonnode/mcp"
            ],
            "env": {
                "TON_LITESERVERS": "<TON_LITESERVERS>",
                "TON_NETWORK": "<TON_NETWORK>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tonnode-ton-blockchain-access": {
            "type": "http",
            "url": "https://mcp.tonnode.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tonnode-ton-blockchain-access": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tonnode/mcp"
            ],
            "env": {
                "TON_LITESERVERS": "<TON_LITESERVERS>",
                "TON_NETWORK": "<TON_NETWORK>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http tonnode-ton-blockchain-access https://mcp.tonnode.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e TON_LITESERVERS=<TON_LITESERVERS> -e TON_NETWORK=<TON_NETWORK> tonnode-ton-blockchain-access npx -y @tonnode/mcp
```
Replace <…> with your own values

## When to use it
- query account balances for GRAM and TEP-74 jettons
- execute read-only smart contract get-methods without network fees
- fetch DEX swap quotes and construct unsigned TonConnect payloads
- create disposable keypairs and wallet addresses for testing

## Example prompts
- Check the GRAM balance and recent transfers for address `EQ...`
- Get a swap quote for 100 GRAM to USDT and prepare the unsigned transaction
- Run the `get_jetton_data` method on this contract address

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md