Перший MCP, який дає агентам рухати цінність між мережами

DeFAI-агент на TON: чому агенту замало читати блокчейн

Ваш ШІ-агент уміє відповідати на запитання про TON — баланс гаманця, статус контракту, історію транзакцій. Користувач пише: «У мене 500 USDT у TON, хочу зайти в позицію на Base». І агент зупиняється. Він усе бачить, але нічого не може зробити. Між «прочитати блокчейн» і «посунути цінність» лежить прірва, яку звичайний read-only MCP не перестрибне. Агент, що лише читає, — це дашборд із чатом. DeFAI (DeFi + AI) починається там, де агент рухає цінність, а не просто дивиться на неї.

Друга стіна — довіра. Більшість «розумних гаманців для агентів» кастодіальні: щоб агент міг щось відправити, хтось має тримати ключ і підписувати. Для автономного бота це означає, що приватний або operator-ключ лежить там, де ви ним не керуєте. Для продакшену з чужими грошима це неприйнятно.

TONNode — hosted MCP-сервер для TON (сайт tonnode.io), у якому рівно 16 інструментів: читання, своп, кросчейн і генерація гаманця. Ключове: інструменти свопу, кросчейну та гаманця строго некастодіальні. Сервер ніколи не підписує і не зберігає кошти та приватні ключі — він повертає непідписані TonConnect-повідомлення, які підписує гаманець користувача. Це і є MCP кросчейн TON без компромісу щодо контролю над ключами.

Щоб дія була безпечною, потрібні дві речі:

• Агент готує транзакцію, але не підписує її. Підпис ставить гаманець користувача через TonConnect. Сервер не торкається ключів.
• Агент уміє працювати за межами однієї мережі. Цінність у крипті живе в кількох мережах одночасно, і «тільки TON» — це половина завдання.

TONNode робить і те, й інше. Нижче — як із цих інструментів зібрати справжнього DeFAI-агента.

Некастодіальний своп: get_swap_quote і build_swap_tx через Omniston

Своп у TONNode — це два інструменти, розділені за відповідальністю: спершу котирування, потім збирання.

• get_swap_quote — тверде котирування обміну GRAM⇄жетон через протокол Omniston, який агрегує ліквідність STON.fi і DeDust. Тобто агент одразу отримує найкращу ціну з двох найбільших DEX, а не вгадує, де вигідніше.
• build_swap_tx — збирає непідписану транзакцію свопу, готову для TonConnect. Саме цей крок і є суттю некастодіальності: сервер віддає повідомлення, а підписує його гаманець користувача.

Аналогія проста. get_swap_quote — це цінник в обміннику. build_swap_tx — заповнена квитанція, яку ви читаєте й підписуєте самі. Касир (сервер) не лізе вам у гаманець.

У діалозі з агентом це виглядає так:

Користувач: обміняй 100 GRAM на USDT, покажи курс перед підтвердженням

Агент → get_swap_quote (GRAM → USDT, 100)
Агент: отримаєш ≈ X USDT за курсом Y (маршрут Omniston). Зібрати транзакцію?

Користувач: так

Агент → build_swap_tx
Агент: готово, підпиши в гаманці ↓ (TonConnect)

Важлива деталь для коректних сум: жетони зберігаються в raw-одиницях, і перерахунок залежить від decimals. У USDT decimals = 6, у більшості жетонів — 9. Перед показом балансу чи суми агент має викликати get_jetton_info (метадані жетона: назва, символ, decimals, емісія) і get_jetton_balance (баланс жетона; жетон-гаманець обчислюється он-чейн). Інакше агент покаже користувачеві «50000000» замість «50».

Ключі не залишають пристрій користувача на жодному кроці. Детальніше про цю схему — у розборі некастодіального свопу для агентів.

MCP кросчейн для TON: атомарний HTLC-ескроу і шлях у 6 EVM-мереж

Тепер те, чого немає в жодного іншого MCP для TON: кросчейн-своп із TON в EVM-мережі без моста-кастодіана. TONNode робить це через атомарний HTLC-ескроу (Hashed TimeLock Contract).

Механіка схожа на угоду через банківську комірку з двома замками:

1. Кошти замикаються в ескроу-контракті в обох мережах під один хеш секрету.
2. Поки секрет не розкрито, гроші нікуди не рухаються.
3. Розкриття секрету одночасно розблоковує обидві сторони — угода або проходить цілком, або не проходить узагалі. Проміжного «гроші пішли, а назад не прийшли» тут немає.
4. Якщо контрагент завис — після таймауту кошти повертаються власникові.

Підтримуються саме ці мережі, і TON завжди джерело:

• Ethereum
• Arbitrum
• Base
• BNB Chain
• Polygon
• Avalanche

TRON поки що не підтримується — важливо чесно казати це користувачеві, щоб агент не обіцяв неможливого.

Ключовий момент некастодіальності тут: build_crosschain_swap_tx повертає і непідписану HTLC-ескроу транзакцію, і секрет — секрет залишається в користувача/агента, а не на сервері. Розкриття секрету — окремий явний крок після перевірки готовності он-чейн. Повний розбір механіки — у статті про кросчейн-своп TON → Ethereum.

П'ять інструментів кросчейну: котирування, збирання, трекінг, розкриття, рефанд

Кросчейн-угода — це не одна кнопка, а скінченний автомат. Кожному стану відповідає свій інструмент:

1. get_crosschain_quote — котирування кросчейн-обміну: скільки отримає користувач у цільовій мережі, комісії, маршрут.
2. build_crosschain_swap_tx — непідписана HTLC-ескроу транзакція + секрет. Транзакцію підписує гаманець користувача, секрет залишається в нього.
3. track_crosschain_swap — фази угоди в обох мережах: чи замкнено в ескроу на TON, чи з'явилося зустрічне замикання на EVM-стороні, чи розкрито секрет, чи завершено розрахунок.
4. disclose_crosschain_secret — розкрити секрет для розрахунку, але лише після перевірки готовності он-чейн. Це захист від передчасного розкриття секрету й втрати контролю над угодою.
5. build_crosschain_refund — збирає транзакцію повернення коштів з ескроу, якщо угода зависла і спрацював таймаут.

Повний життєвий цикл угоди

Так виглядає потік, який агент проганяє від котирування до розрахунку чи повернення:

get_crosschain_quote        → котирування TON → Base
build_crosschain_swap_tx    → непідписана HTLC-ескроу tx + секрет
   (користувач підписує ескроу своїм гаманцем)
track_crosschain_swap       → чекаємо готовності зустрічної сторони
disclose_crosschain_secret  → розкриваємо секрет, іде розрахунок
   ── якщо зависло ──
build_crosschain_refund     → повернення з ескроу

Зверніть увагу: рефанд вбудований у дизайн, а не пришитий збоку. Саме build_crosschain_refund робить конструкцію безпечною для автономного агента: навіть якщо щось пішло не так, кошти не застрягають — є детермінований шлях повернення. Ця п'ятірка перетворює «страшний міст» на передбачуваний покроковий процес.

У чому рів TONNode: некастодіальність + кросчейн + hosted

Порівняймо чесно з офіційним пакетом. @ton/mcp від TON Foundation — це кастодіальний агент-гаманець зі split-key схемою: operator-ключ тримає агент, owner-ключ — користувач, і агент підписує сам. Він уміє багато — читання, відправлення GRAM/жетонів/NFT, своп через DEX-агрегатор, роботу з NFT і DNS, створення та імпорт агент-гаманців, і він офіційний. Це сильні сторони, і применшувати їх нема чого.

Але два обмеження суттєві:

• Він кастодіальний — operator-ключ в агента, тобто агент може витрачати автономно. Для одних сценаріїв це зручно, для інших — неприйнятний ризик.
• Він тільки TON — кросчейну немає.

TONNode відрізняється за трьома осями:

	Офіційний @ton/mcp	TONNode
Модель ключів	Кастодіальний (split-key, підписує сам)	Некастодіальний (повертає непідписані TonConnect-повідомлення)
Кросчейн	Ні, тільки TON	TON → 6 EVM-мереж, атомарний HTLC
Розгортання	Локально / HTTP / serverless	Локально (npx) і hosted-ендпоінт

Некастодіальність — не галочка, а архітектурний рів. Сервер ніколи не підписує і не зберігає кошти та приватні ключі. Навіть generate_wallet (створює новий TON-гаманець версій v3r2 / v4 / v5r1 / highload_v3) віддає мнемоніку та ключі користувачеві — сервер їх не зберігає. Розгорнуте порівняння підходів — у матеріалі кастодіальний проти некастодіального MCP.

Невелика термінологічна деталь, щоб не плутатися: GRAM — це перейменований Toncoin (перейменування відбулося в червні 2026), сама мережа, як і раніше, називається TON.

Як підключити й зібрати свого DeFAI-агента

Почати можна безплатно й локально, без картки та без реєстрації. Пакет @tonnode/mcp — open source (MIT), працює через нативний ADNL-протокол TON без HTTP-прошарків.

Локальний і hosted-конфіг

Локальний конфіг (публічний набір, повне читання) — просто додайте в конфіг MCP-клієнта:

{
  "mcpServers": {
    "ton": { "command": "npx", "args": ["-y", "@tonnode/mcp"] }
  }
}

Hosted-ендпоінт (гарантована пропускна здатність, власний ключ):

{
  "mcpServers": {
    "ton": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp",
      "headers": { "Authorization": "Bearer tn_live_…" }
    }
  }
}

Конфіг підходить будь-якому MCP-клієнту: Claude, Cursor, ChatGPT/Codex.

Каркас DeFAI-агента

Каркас DeFAI-агента на інструментах TONNode — типовий потік «зайти в позицію в іншій мережі»:

Перевірити, що є в користувача:
  get_balance          → баланс GRAM
  get_jetton_info      → decimals жетона (USDT = 6, зазвичай 9)
  get_jetton_balance   → баланс USDT/жетона (гаманець обчислюється он-чейн)

Якщо користувач хоче обмін усередині TON:
  get_swap_quote → build_swap_tx → підпис у гаманці

Якщо користувач хоче вивести цінність у Base/Ethereum/…:
  get_crosschain_quote
  → build_crosschain_swap_tx (підпис, секрет у користувача)
  → track_crosschain_swap (чекаємо готовності)
  → disclose_crosschain_secret (розрахунок)
  → build_crosschain_refund (якщо зависло)

Далі все тримається на системному промпті — клієнт сам роутить виклики:

Ти — DeFAI-асистент для TON. Правила:
1. Перед будь-якою сумою жетона викликай get_jetton_info (decimals)
   і get_jetton_balance.
2. Для свопу: спершу get_swap_quote, покажи курс, потім build_swap_tx.
   Ніколи не проси приватні ключі — транзакцію підписує
   гаманець користувача через TonConnect.
3. Для кросчейну: get_crosschain_quote → build_crosschain_swap_tx →
   track_crosschain_swap → disclose_crosschain_secret.
   Джерело — завжди TON, ціль — одна з 6 EVM-мереж
   (Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche);
   TRON не підтримується.
4. Якщо угода зависла — запропонуй build_crosschain_refund.

Покрокове збирання торгового агента розбираємо окремо — як побудувати торгового агента на TON.

Тарифи

На всіх тарифах доступні всі 16 інструментів, платите лише за пропускну здатність:

• Hobby — безплатно назавжди, 60 запитів/хв
• Pro — $29/міс, 300 запитів/хв
• Scale — $199/міс, 1200 запитів/хв

Безплатний ключ Hobby видається одразу після входу, без картки. Оплатити Pro/Scale можна в GRAM або USDT у мережі TON через TonConnect, або в BTC/ETH/SOL та інших через рахунок xRocket у Telegram; ключ видається автоматично після розрахунку платежу.

---

Read-only MCP робить агента спостерігачем. Некастодіальний своп і кросчейн роблять його виконавцем — не забираючи в користувача ключі. Читати TON уміє багато хто; рухати цінність із TON у шість EVM-мереж, не віддаючи ключів, — поки що лише TONNode. Це і є DeFAI на TON: агент рухає цінність, а контроль залишається у власника.

Заберіть безплатний ключ Hobby і підключіть першого агента просто зараз → tonnode.io/dashboard?plan=hobby

Далі за темою: повний список інструментів на tonnode.io/mcp, ліміти й тарифи на tonnode.io/pricing.