Bepul TON MCP: AI agentni TONga npx yoki Hobby orqali ulash

Claude yoki Cursorʼdan «bu TON hamyonining balansini tekshir va oxirgi tranzaksiyalarni koʻrsat» deb soʻraysiz — agent esa astoydil urinib koʻradi. Global configdagi ommaviy liteserverga soʻrov yuboradi, not ready javobini oladi, qayta urinadi, ADNL taymautiga duch keladi. Yoki kalitsiz toncenterʼga boradi, taxminan sekundiga bitta soʻrov limitiga tiralib qoladi va HTTP 429 Too Many Requests javobini oladi. Agent TONni oʻzicha oʻqiy olmaydi — unga vositalar kerak. Koʻpchilik dasturchilar shu bosqichda node koʻtarish, configlar bilan ovora boʻlish va kirish uchun pul toʻlash kerak deb oʻylaydi. Aslida bunday emas: agentni TONga bepul va bu boshogʻriqlarsiz ulash mumkin — ikki xil usulda, ikkalasi ham kartani talab qilmaydi.

Agentga TONʼda ishlash uchun «qoʻl» berishning eng tez yoʻli — MCP. Model Context Protocol — bu AI agentlar (Claude, Cursor, ChatGPT/Codex va har qanday MCP mijozi) tashqi vositalarni chaqirishi uchun moʻljallangan standart. Agentni xom JSON-RPCʼni oʻzi chaqirishga va cellʼlarni parse qilishga oʻrgatish oʻrniga, siz unga get_balance yoki get_jetton_balance kabi tayyor vositalar toʻplamini berasiz — qachon chaqirishni esa u oʻzi hal qiladi. TONNode — TON uchun hosted MCP server (tonnode.io sayti). U orqali bepul TON MCPʼni ikki xil yoʻl bilan ulash mumkin — ularning hech biri karta talab qilmaydi. Ikkalasini ham koʻrib chiqamiz.

Bepul TON MCP: ikki yoʻl — lokal npx va Hobby kaliti

Agentni TONga bepul ulash uchun sizda tanlov bor:

1. npx orqali lokal ishga tushirish — ommaviy configda, umuman kalitsiz va roʻyxatdan oʻtmasdan. Paket sizning mashinangizga yuklab olinadi va oʻsha yerda ishga tushadi.
2. Bepul Hobby kaliti — saytga kirasiz, kalit darhol, kartasiz beriladi, hosted endpoint orqali daqiqasiga 60 soʻrov.

Ular oʻrtasidagi farq vositalar toʻplamida emas, balki jarayon qayerda ishlashida va oʻtkazuvchanlik qayerdan kelishida. Eng oddiysidan boshlaymiz.

1-usul: ommaviy configda npx orqali lokal ishga tushirish (kalitsiz)

Bu tom maʼnoda MCP mijozingiz configidagi bitta blok. Hech qanday oldindan oʻrnatish shart emas — npx paketni oʻzi yuklab oladi.

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

Tamom. Mijoz ishga tushganda lokal @tonnode/mcp jarayoni koʻtariladi, TONga native protokol boʻyicha ulanadi va agentga oʻqish vositalarining toʻliq toʻplamini beradi. Kalit kerak emas, karta kerak emas, akkaunt ham kerak emas.

Ichkarida nima borligi haqida muhim tafsilot: @tonnode/mcp paketi — open source (MIT), u npm va GitHubʼda (tonnode/mcp) joylashgan hamda agentingiz bilan tarmoq oʻrtasida hech qanday HTTP qatlamisiz, TONning native ADNL protokoli boʻyicha ishlaydi. Yaʼni bu birovning REST APIʼsi ustiga yasalgan va oʻsha birovning rate limitiga tiralib qoladigan wrapper emas — bu tarmoq bilan bevosita ishlaydigan mijoz.

Bu configni qayerga qoʻyish kerak

• Claude Desktop / Claude Code — MCP konfiguratsiya faylining mcpServers boʻlimiga.
• Cursor — loyihaning MCP serverlari sozlamalariga yoki global sozlamalarga.
• ChatGPT/Codex va boshqa MCP mijozlari — ularning MCP ulash boʻlimiga.

Har bir mijoz boʻyicha rasmlar bilan batafsil tahlil — alohida qoʻllanmada: Claude va Cursorni TONga qanday ulash.

Bepul nimalar mavjud: TONni oʻqishning toʻliq toʻplami

Lokal bepul rejim — bu qirqilgan demo emas. Sizga oʻqishning toʻliq toʻplami ochiq — sakkizta vosita, ular agent vazifalarining aksariyati uchun yetarli:

• get_masterchain_info — masterchainning «boshi»: agent tarmoq «hozir qayerda turganini» shu orqali tushunadigan joriy tarmoq holati.
• get_balance — hamyon balansi GRAMʼda (bu 2026-yil iyunida nomi oʻzgartirilgan Toncoin; tarmoqning oʻzi hamon TON deb ataladi).
• get_account_state — akkaunt holati, flaglar, oxirgi tranzaksiya. Kontrakt deploy qilinganmi va hamyon faolmi — buni bilish uchun foydali.
• get_transactions — manzil boʻyicha tranzaksiyalar tarixi.
• run_get_method — ixtiyoriy kontraktning istalgan read-only get-metodini chaqirish. Smart-kontraktlar uchun «istalgan narsani oʻqiy oladigan» universal vositangiz.
• get_jetton_balance — jetton balansi, jumladan USDT; jetton-hamyon manzili on-chain hisoblanadi, uni oldindan bilishingiz shart emas.
• get_jetton_info — jetton metamaʼlumotlari: nomi, belgisi, emissiyasi va hisob-kitoblar uchun eng muhimi — decimals. USDTʼda decimals = 6, koʻpchilik jettonlarda = 9 — bu raqamsiz siz raw birliklarni odam oʻqiydigan summaga aylantira olmaysiz.
• parse_address — manzillarni (EQ/UQ/raw) konvertatsiya qilish va tekshirish, oflayn ishlaydi, tarmoqqa murojaat qilmasdan.

Amaliy misol. «USDT balansini bitta chaqiruv bilan koʻrsat» degan klassik vazifa get_jetton_info (decimalsʼni bilib olish) + get_jetton_balance bogʻlamasi bilan hal boʻladi. Agentga odam tilidagi prompt yetarli:

UQAbc...xyz manzilidagi USDT balansini tekshir
va uni toʻgʻri kasr xonalari bilan koʻrsat.

Agent get_jetton_info ni oʻzi chaqiradi, decimals: 6 ni koʻradi, keyin get_jetton_balance ni chaqiradi va toʻgʻri summani beradi — sizning bironta ham kod qatoringizsiz. Tahlil TON uchun MCP qoʻllanmasida, alohida misol esa — TONʼda USDT balansini bitta chaqiruv bilan qanday bilish mumkin.

2-usul: bepul Hobby kaliti — kartasiz, daqiqasiga 60 soʻrov

Lokal npx ishlab chiqish va yakka vazifalar uchun yaxshi, lekin uning chegarasi bor: u TONning global configidagi ommaviy liteserverlar orqali ishlaydi. Ular umumiy va limitli, yuk ostida koʻpincha not ready yoki ADNL taymauti bilan javob beradi hamda chuqur tarixni saqlamaydi. Haqiqiy foydalanuvchilarga javob beradigan prod-agent uchun bu — lotereya.

Shu yerda ikkinchi bepul yoʻl — Hobby tarifi ishga tushadi. U abadiy bepul, daqiqasiga 60 soʻrov beradi va kalit tizimga kirganingizdan soʻng darhol, kartasiz beriladi. Lokal rejimdan farqi shundaki, soʻrovlar sizning mashinangizdan umumiy ommaviy infratuzilma orqali emas, balki shaxsiy kalitingiz bilan TONNodeʼning hosted endpointi orqali ketadi — yaʼni sizda aynan sizga bogʻlangan, bashorat qilinadigan daqiqasiga 60 soʻrov limiti boʻladi.

Hosted ulanish uchun config quyidagicha koʻrinadi:

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

Lokal configdan ikkita farqi bor: jarayonni ishga tushirish oʻrniga type: "http" va kalitingiz tn_live_… bilan Authorization sarlavhasi. Agentning oʻzi esa hech qanday farqni sezmaydi — oʻsha vositalar, oʻsha nomlar, oʻsha parametrlar.

Muhimi shu: Hobbyʼda ham, xuddi qolgan barcha tariflardagi kabi, TONNodeʼning 16 ta vositasi ham mavjud — faqat oʻqish emas, balki swap, cross-chain va hamyon generatsiyasi ham. Aynan hosted kalitda sakkizta oʻqish vositasiga, xususan, generate_wallet qoʻshiladi — v3r2, v4, v5r1 yoki highload_v3 versiyalaridagi yangi TON hamyon yaratish: vosita mnemonika, kalitlar va manzilni toʻgʻridan-toʻgʻri sizga qaytaradi, server generatsiya qilingan hamyonlarni saqlamaydi. Tarif funksionallikni emas, oʻtkazuvchanlikni cheklaydi. Siz faqat throughput uchun, u kerak boʻlgandagina toʻlaysiz.

Hobby kalitini olish (kartasiz): tonnode.io/dashboard?plan=hobby.

Lokal yoki hosted: bepul rejim qayerda yetadi, throughput qayerda kerak

Qisqasi: gap ishlab chiqish, prototiplar va chaqiruvlar chastotasi past boʻlgan holatlar haqida ketsa, bepul rejim deyarli har doim yetarli. Rejimlar oʻrtasidagi farq vositalar toʻplamida emas, balki oʻtkazuvchanlikda.

Rejim	Kalit / karta	Oʻtkazuvchanlik	Nima uchun
Lokal npx	Kerak emas	Ommaviy liteserverlar (umumiy, limitli)	Ishlab chiqish, bir martalik vazifalar
Hobby (hosted)	Kalit, kartasiz	Kalitingizda daqiqasiga 60 soʻrov	Pet-loyihalar, yengil prod
Pro / Scale (hosted)	Kalit + toʻlov	Daqiqasiga 300 / 1200 soʻrov	Yuqori yuklamali prod

Asosiy fakt: barcha tariflarda 16 ta vositaning hammasi mavjud — swap va cross-chain ham. Siz faqat oʻtkazuvchanlik uchun toʻlaysiz, funksiyalarni «ochish» uchun emas. Pro oyiga $29 turadi va daqiqasiga 300 soʻrov beradi, Scale — oyiga $199 va daqiqasiga 1200 soʻrov. Pullik throughput roppa-rosa oʻshanda kerak boʻladi: daqiqasiga 60 soʻrov sizga kam boʻlganda yoki haqiqiy yuk ostida mcp.tonnode.io hosted endpointida bashorat qilinadigan oʻz limitingiz kerak boʻlganda. Toʻliq taqqoslash — tariflar sahifasida va vositalar sahifasida.

Bosqichma-bosqich: agentni ulaymiz va birinchi chaqiruvni qilamiz

Hammasini lokal ishga tushirish misolida yigʻamiz (Hobby uchun faqat config bloki farq qiladi).

1-qadam. Serverni MCP mijoz configiga qoʻshing. Yuqorida koʻrsatilgan npx -y @tonnode/mcp blokini oling va mijozingiz configiga joylashtiring (Claude, Cursor, Codex — yoʻl mijozga bogʻliq).

2-qadam. Mijozni qayta ishga tushiring. U @tonnode/mcp jarayonini koʻtaradi va vositalarni koʻradi. Koʻpchilik mijozlarda ulangan vositalar roʻyxati interfeysda koʻrinadi — ton paydo boʻlganiga ishonch hosil qiling.

3-qadam. Agentga vazifani oddiy matn bilan bering. Masalan:

TON masterchainining joriy boshini bil va shu bilan birga
UQAbc...xyz manzilining GRAMʼdagi balansini ayt.

Agent get_masterchain_info ni, keyin get_balance ni oʻzi chaqiradi va natijani odam tilida qaytaradi.

4-qadam. Murakkabroq vazifalar ham bitta prompt bilan. Aytaylik:

UQAbc...xyz hamyonida qancha USDT bor? Summani decimalsʼni hisobga olib qaytar.

Bu yerda agent USDTʼning decimals ini (=6) bilish uchun get_jetton_info ni, keyin raw balansni olish uchun get_jetton_balance ni chaqiradi va uni odam oʻqiydigan summaga aylantiradi. Jetton-hamyonni u on-chain hisoblab oladi — uning manzilini uzatishingiz shart emas.

5-qadam. Ommaviy liteserverlar limitiga urilganingizda (not ready yoki taymautlarni koʻrasiz) — blokni Hobby kaliti bilan hosted configga almashtiring. Faqat config oʻzgaradi, promptlar va agent logikasi oʻsha-oʻsha qoladi.

Nokastodiallik: bepul kirish nega xavfsiz

Mantiqiy savol: agar server bepul boʻlsa-yu, oʻsha server hamyonlarni generatsiya qilsa va tranzaksiyalarni tuzsa — kalitlarim xavf ostida qolmaydimi? Yoʻq, bu esa arxitekturaning prinsipial pozitsiyasi. TONNode qatʼiy nokastodial.

Server hech qachon imzo qoʻymaydi va mablagʻlar hamda maxfiy kalitlarni saqlamaydi. Oʻqish vositalari shunchaki ommaviy on-chain holatni oʻqiydi. Holatni oʻzgartiradigan vositalar — swap va cross-chain — esa sizning nomingizdan hech narsa yubormaydi: ular imzolanmagan TonConnect xabarlarini qaytaradi. Ularni foydalanuvchining hamyoni, lokal tarzda, oʻz kaliti bilan imzolaydi. generate_wallet bilan ham xuddi shunday (u hosted kalitda mavjud): generatsiya qilingan hamyon va uning mnemonikasi sizga beriladi, server ularni oʻzida qoldirmaydi.

Boshqacha aytganda, bepul kirish pullikdan zarracha ham xavfliroq emas: tranzaksiyalarni fizik jihatdan faqat hamyon egasi imzolay oladi — serverda biror narsani imzolash uchun kalitlar yoʻq. Bu — server operator-kalitni ushlab turadigan va oʻzi imzolaydigan kastodial modeldan prinsipial farq. Ikki yondashuv va ularning risklari tahlili — kastodial va nokastodial MCP haqidagi alohida materialda.

Xulosa

AI agentga TONʼda ishlash imkonini berish uchun na oʻz nodeʼingizni koʻtarish, na karta kerak. Lokal npx -y @tonnode/mcp hoziroq, kalitsiz, oʻqishning toʻliq toʻplamini beradi — sinab koʻrish uchun ideal. Ommaviy liteserverlar yetmay qolganda esa bepul Hobby tarifi hosted endpoint orqali kalitingizda bashorat qilinadigan daqiqasiga 60 soʻrov qoʻshadi, bu ham kartasiz. Ikkala rejim ham nokastodial, ikkalasi ham bir xil vositalardan foydalanadi va istalgan payt agent logikasida hech narsani qayta yozmasdan pullik throughputga oʻta olasiz.

Bepul Hobby kalitini oling (kartasiz): tonnode.io/dashboard?plan=hobby