TON MCP: AI agentga TONga kirish berish — toʻliq qoʻllanma

Sizda AI agent bor — Cursordagi Claude, Codexdagi skript, oʻzingiz yozgan bot — va siz uning TON bilan chinakam ishlashini istaysiz: yuborishdan oldin hamyon balansini tekshirsin, tranzaksiyalar tarixini oʻqisin, swap kotirovkasini hisoblasin, cross-chain ayirboshlashni tayyorlasin. Lekin agent qanchalik aqlli boʻlmasin, u koʻr: blokcheynda uning koʻzi yoʻq. Odatdagi yoʻl — uni HTTP orqali toncenter yoki tonapi.io ga murojaat qilishga oʻrgatish. Va aynan shu yerda azob boshlanadi: kalitsiz limit taxminan sekundiga bitta soʻrov, yuk ostida HTTP 429 Too Many Requests uchib keladi, global configdagi ommaviy liteserverlar not ready deb javob beradi yoki ADNL taymauti bilan uziladi, chuqur tarix esa ularda umuman yoʻq. «Shunchaki balansni koʻrsin» deb yoʻlga qoʻyilgan agent infratuzilmaga qoqilib qoladi.

Yechim — agentni APIga qoʻlda borishga oʻrgatish emas, balki unga TON uchun MCP-server berish. Quyida — toʻliq qoʻllanma: MCP nima, agentga u nega kerak, bitta buyruq bilan qanday qilib bepul ulanish va TONNodeʼning 16 tooli nima qila oladi.

MCP nima va AI agentga u nega kerak

MCP (Model Context Protocol) — bu AI agentlar tashqi toollarni chaqiradigan ochiq standart. Uni Claude, Cursor, ChatGPT/Codex va istalgan boshqa MCP-klient tushunadi: siz toollar toʻplamini eʼlon qilasiz, agent esa ularning tavsiflarini koʻradi va qaysi birini, qanday parametrlar bilan chaqirishni oʻzi hal qiladi.

Oʻxshatish oddiy: agent uchun MCP — kompyuter uchun USB-port kabi. Modelning oʻzida na tarmoqqa, na blokcheynga kirish imkoni bor. Lekin MCP-serverni ulang — va agentda «rozetkalar» toʻplami paydo boʻladi: balansni oʻqish, tranzaksiya yigʻish, bitimni kuzatish. Siz «X hamyonida qancha USDT bor» deysiz — model get_jetton_balance tooli kerakligini tushunadi, manzilni qoʻyadi va tuzilgan javob oladi.

«Agentga HTTP-endpoint ber» yondashuvidan farqi tubdan. Xom API bilan ishlaganda agent soʻrovlarni qanday shakllantirish, javoblarni qanday parse qilish, manzillar va raw-birliklarni qanday konvertatsiya qilishni kontekstda ushlab turishi kerak. Bularning hammasi — gallyutsinatsiyalar uchun joy. MCP bu mantiqni serverga olib chiqadi: agent tushunarli signaturaga ega get_balance toolini koʻradi va tayyor javob oladi. Kamroq xato, kontekstda kamroq token, bashorat qilinadigan xatti-harakat.

TONNode (sayt: tonnode.io) — bu aynan TON (The Open Network) uchun tayyor hosted MCP-server. Bitta endpoint, oʻqish, swap, cross-chain va hamyonlar bilan ishlash uchun 16 ta tool — oraliq HTTP-qatlamlarsiz, TONning nativ protokoli ustida.

Agentga nega ommaviy HTTP-shlyuzlar emas, TON uchun MCP-server kerak

Oʻrinli savol: toncenter va tonapi.io kabi ommaviy APIlar bor ekan, alohida server nimaga kerak? Gap shundaki, ommaviy shlyuzlar bir martalik qoʻlda soʻrovlar uchun yaraydi, lekin daqiqasiga oʻnlab chaqiruv qiladigan agentning yukiga moʻljallanmagan.

• Limitlar va 429. Kalitsiz toncenter va tonapi.io sekundiga taxminan bitta soʻrov beradi va chegara oshib ketganda HTTP 429 Too Many Requests bilan javob qaytaradi. «Holatni oʻqidim → qaror qabul qildim → yana oʻqidim» siklidagi agent shiftga bir zumda urilib qoladi — va javob oʻrniga foydalanuvchiga xato koʻrsatadi.
• Ommaviy liteserverlar ishonchsiz. Global configdagi liteserverlar (TONga ADNL orqali toʻgʻridan-toʻgʻri borsangiz) umumiy va limitlangan. Yuk ostida ular not ready deb javob beradi, ADNL taymauti bilan uziladi va tranzaksiyalarning chuqur tarixini saqlamaydi.
• Xom javob ≠ agentga javob. Hatto muvaffaqiyatli JSON ham koʻpincha keyingi ishlovni talab qiladi: jetton-hamyon manzilini hisoblash, raw-birliklarni decimals boʻyicha qayta sanash, manzilni formatlar orasida konvertatsiya qilish. Modelga topshirilgan har bir bunday qadam — potensial xato va ortiqcha tokenlar.

MCP-server bularning barchasini bartaraf etadi: sizning kalitingizga bogʻlangan barqaror oʻtkazuvchanlik, server tomonidagi hisob-kitoblar va tayyor tuzilgan javoblarga ega yagona interfeys. Aytgancha, chatlarda «228-xato» ga duch kelsangiz — bu TON hamjamiyatining mem-raqami, API kodi emas; limitning haqiqiy kodi aynan 429.

Bepul yoʻlning batafsil tahlili alohida yozuvda: TONni agentga bepul qanday ulash.

Qanday ulanish: npx orqali bepul va hosted kalit

Ikki yoʻl bor, birinchisi esa toʻliq bepul.

1-variant. Lokal, npx orqali (bepul, oʻqishning toʻliq toʻplami)

Oʻqish toollarining toʻliq toʻplami roʻyxatdan oʻtmasdan va kalitsiz mavjud. @tonnode/mcp paketi — open source (MIT), npm va GitHubʼda (tonnode/mcp) yotadi, TONning nativ ADNL-protokoli boʻyicha ishlaydi. MCP-klient configiga qoʻshing:

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

Claude Desktop, Cursor yoki boshqa klientni qayta ishga tushiring — toollar oʻzi paydo boʻladi. Aniq klientlar uchun bosqichma-bosqich sozlash — Claude va Cursorni TONga qanday ulash qoʻllanmasida.

2-variant. Hosted kalit (kafolatlangan oʻtkazuvchanlik)

Agent prodda ishlayotganda va soʻrovlar koʻp boʻlganda oʻz kaliti hamda barqaror kanal kerak boʻladi:

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

Bepul Hobby kaliti tizimga kirgandan soʻng darhol, kartasiz beriladi va unda barcha 16 ta tool mavjud — tonnode.io/dashboard?plan=hobby.

TONNodeʼning 16 tooli guruhlar boʻyicha

Barcha tariflarda barcha toollar mavjud — siz faqat oʻtkazuvchanlik uchun toʻlaysiz. Guruhlar boʻyicha koʻrib chiqamiz.

Oʻqish (8 ta tool)

Tarmoqni kuzatadigan va hech nimani oʻzgartirmaydigan har qanday agent uchun poydevor:

• get_masterchain_info — masterchainning «boshi», tarmoqning joriy nuqtasi.
• get_balance — manzildagi GRAM balansi.
• get_account_state — akkaunt statusi, bayroqlar, oxirgi tranzaksiya.
• get_transactions — manzilning tranzaksiyalar tarixi.
• run_get_method — kontraktning istalgan read-only get-metodini chaqirish.
• get_jetton_balance — jetton balansi (masalan, USDT); jetton-hamyon manzili on-chain hisoblanadi, uni oldindan bilish shart emas.
• parse_address — manzillarni konvertatsiya qilish va tekshirish (EQ/UQ/raw), oflayn ishlaydi.
• get_jetton_info — jetton metadatasi: nomi, simvoli, emissiyasi va eng asosiysi — decimals. Decimals raw-birliklarni qayta sanash uchun kritik: USDTʼda ular 6 ta, koʻpchilik jettonlarda — 9 ta.

TONNode ulangan agentga beriladigan prompt namunasi:

UQ… hamyonidagi GRAM va USDT balansini tekshir, oxirgi 5 ta tranzaksiyani koʻrsat.

Agent get_balance, get_jetton_balance (avval get_jetton_info orqali decimalsni olib) va get_transactions ni oʻzi chaqiradi — bitta ham qoʻlda HTTP-soʻrovsiz.

Swap (2 ta tool)

TON ichidagi ayirboshlash STON.fi va DeDust likvidligini agregatsiya qiladigan Omniston protokoli orqali boradi:

• get_swap_quote — GRAM ⇄ jetton juftligi uchun DEXning qatʼiy kotirovkasi.
• build_swap_tx — TonConnect orqali imzolashga tayyor, imzolanmagan swap tranzaksiyasi.

«Imzolanmagan» soʻziga eʼtibor bering — unga nokastodiallik haqidagi boʻlimda qaytamiz.

Cross-chain (5 ta tool)

TON doim manba boʻlib xizmat qiladi, ayirboshlash esa atomar HTLC-eskrou orqali boradi — bu mexanizmda mablagʻ sekret heshi boʻyicha bloklanadi va faqat ikkala tarmoqdagi shartlar bajarilgandagina ochiladi. Qoʻllab-quvvatlanadi: Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche. TRON hozircha qoʻllab-quvvatlanmaydi.

• get_crosschain_quote — cross-chain ayirboshlash kotirovkasi.
• build_crosschain_swap_tx — imzolanmagan HTLC-eskrou tranzaksiyasi va sekret.
• track_crosschain_swap — bitimning ikkala tarmoqdagi fazalari.
• disclose_crosschain_secret — on-chain tayyorlik tekshirilgandan soʻng hisob-kitob uchun sekretni oshkor qilish.
• build_crosschain_refund — bitim osilib qolsa, eskroudan mablagʻni qaytarish.

HTLC-sxema shuni anglatadiki, ayirboshlash yo atomar tarzda oʻtadi, yo refund orqali qaytariladi — mablagʻ vositachida tiqilib qolmaydi.

Hamyon (1 ta tool)

• generate_wallet — v3r2, v4, v5r1 yoki highload_v3 versiyalaridagi yangi TON-hamyon yaratadi va mnemonika, kalitlar hamda manzilni qaytaradi. Yaratilgan hamyonni server saqlamaydi — u darhol sizga beriladi.

Toollarning parametrlari bilan toʻliq sharhi — tonnode.io/mcp sahifasida.

Nokastodiallik: server nega hech qachon kalitlaringizni ushlamaydi

Bu — prinsipial farq va agentni pulga yaqinlashtirishdan oldin uni tushunib olish muhim.

Swap, cross-chain va hamyon generatsiyasi toollari qatʼiy nokastodial. TONNode serveri tranzaksiyalarni hech qachon imzolamaydi va mablagʻ yoki xususiy kalitlarni hech qachon saqlamaydi. Agent build_swap_tx yoki build_crosschain_swap_tx ni chaqirganda, u javobda imzolanmagan TonConnect-xabarini — tranzaksiyaning tayyor qolipini oladi. Uni server emas, foydalanuvchining hamyoni imzolaydi. generate_wallet dan chiqqan hamyonlar ham sizga beriladi va serverda qolmaydi.

Oʻxshatish: MCP-server — bu marshrutni chizib beradigan va toʻlov qogʻozini toʻldiradigan shturman. Lekin «yuborish» tugmasini bosib, imzo qoʻya oladigan yagona odam — oʻz hamyoningiz rulida oʻtirgan siz. Agent buzib kirilgan yoki xato qilgan taqdirda ham u mablagʻni olib keta olmaydi — qoʻlida faqat imzolanmagan qoliplar bor.

Bu yerda TON Foundationʼning rasmiy @ton/mcp paketi bilan taqqoslash foydali. Bu kuchli va rasmiy paket: u oʻqishni, GRAM/jetton/NFT yuborishni, DEX-agregator orqali swapni, NFT va DNS bilan ishlashni, agent-hamyonlar yaratish va importini uddalaydi. Lekin tuzilishi boʻyicha bu split-key bilan ishlaydigan kastodial agent-hamyon: operator-kalitni agentning oʻzi ushlab turadi va u bilan imzolaydi, owner-kalit esa foydalanuvchida. Va unda cross-chain yoʻq — faqat TON. Farq halol: rasmiy paket agentga mablagʻni avtonom sarflash hamda NFT/DNS bilan ishlash imkonini beradi; TONNode esa nokastodiallik, cross-chain va hosted-variantga tayanadi. Batafsil tahlil — TONNode va rasmiy TON MCP hamda kastodial vs nokastodial MCP maqolalarida.

Tariflar va nimadan boshlash kerak

Barcha tariflarda 16 ta toolning hammasi mavjud — faqat oʻtkazuvchanlik farq qiladi:

Tarif	Narx	Limit
Hobby	abadiy bepul	60 soʻrov/min
Pro	$29/oy	300 soʻrov/min
Scale	$199/oy	1200 soʻrov/min

Pro va Scaleʼni TON tarmogʻida GRAM yoki USDTʼda TonConnect orqali, yoxud Telegramdagi xRocket hisobi orqali BTC/ETH/SOL va boshqa valyutalarda toʻlash mumkin. Kalit toʻlov hisob-kitobidan soʻng avtomatik beriladi. (Har ehtimolga qarshi: GRAM — bu 2026-yil iyunda qayta nomlangan Toncoin, tarmoqning oʻzi esa avvalgidek TON deb ataladi.)

Amaliy start yoʻli:

1. Bepul Hobby kalitini oling — kartasiz, tizimga kirgandan soʻng darhol, barcha 16 ta tool bilan: tonnode.io/dashboard?plan=hobby.
2. Hosted-configni yozib qoʻying (yoki npx -y @tonnode/mcp orqali lokal boshlang).
3. Agentga oʻqish boʻyicha birinchi promptni bering — balans, akkaunt holati, tarix — va 429 hamda not ready endi xalaqit bermayotganiga ishonch hosil qiling.

Keyinchalik prodda limitga urilganingizda tariflar va toollar sharhiga qarang. Bepul kalitdan boshlang va agentni bir necha daqiqada TONga ulang.