# TONNode — TON blockchain access

Подключает ИИ к блокчейну TON через протокол ADNL без промежуточных HTTP-шлюзов. Позволяет читать балансы, вызывать get-методы контрактов и готовить транзакции для обмена.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 27
- Автор: tonnode
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/tonnode/mcp
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/mcp/tonnode-ton-blockchain-access

## Что делает

MCP-сервер обращается напрямую к лайт-серверам сети The Open Network. Соединение идёт через нативный протокол ADNL, а не через сторонние веб-шлюзы. Ассистент запрашивает состояние адресов, баланс монеты GRAM и жетонов TEP-74, историю переводов и параметры мастерчейна. Для смарт-контрактов доступен запуск read-only методов без списания сетевых комиссий.

Для торговли инструмент задействует котировки Omniston. Модель собирает готовую неподписанную транзакцию для TonConnect: поддерживаются как обычные DEX-сделки, так и кроссчейн-обмен через эскроу HTLC на сети вроде Ethereum или Arbitrum. Сервер работает некастодиально: приватные ключи остаются у пользователя, а сам инструмент ничего в блокчейн не подписывает.

Функция выпуска новых кошельков передаёт 24 слова мнемоники прямо в контекст чата. Хранить крупные суммы на созданных таким путём адресах опасно, они годятся только для временных скриптов. Сервер работает локально через `npx` либо через удалённый защищённый HTTP-эндпоинт.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.tonnode.io/mcp`
- Переменные окружения: `TON_LITESERVERS`, `TON_NETWORK` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://mcp.tonnode.io/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env TON_LITESERVERS=<TON_LITESERVERS> --env TON_NETWORK=<TON_NETWORK> --transport stdio tonnode-ton-blockchain-access -- npx -y @tonnode/mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add tonnode-ton-blockchain-access --url https://mcp.tonnode.io/mcp
```

2. **Командой платформы**
```bash
codex mcp add tonnode-ton-blockchain-access --env TON_LITESERVERS=<TON_LITESERVERS> --env TON_NETWORK=<TON_NETWORK> -- npx -y @tonnode/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tonnode-ton-blockchain-access": {
            "url": "https://mcp.tonnode.io/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tonnode-ton-blockchain-access": {
            "command": "npx",
            "args": [
                "-y",
                "@tonnode/mcp"
            ],
            "env": {
                "TON_LITESERVERS": "<TON_LITESERVERS>",
                "TON_NETWORK": "<TON_NETWORK>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tonnode-ton-blockchain-access": {
            "type": "http",
            "url": "https://mcp.tonnode.io/mcp"
        }
    }
}
```
Файл `.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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http tonnode-ton-blockchain-access https://mcp.tonnode.io/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e TON_LITESERVERS=<TON_LITESERVERS> -e TON_NETWORK=<TON_NETWORK> tonnode-ton-blockchain-access npx -y @tonnode/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить баланс GRAM и жетонов TEP-74 на произвольном адресе
- вызвать get-метод смарт-контракта без комиссии за газ
- получить котировку обмена и собрать готовую транзакцию под TonConnect
- сгенерировать временный кошелёк с мнемонической фразой под тест

## Примеры запросов агенту
- Проверь баланс кошелька `EQ...` и покажи последние входящие переводы
- Узнай курс обмена 50 GRAM на USDT через Omniston и собери неподписанную транзакцию
- Вызови get-метод `get_jetton_data` для контракта жетона

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md