엔지니어링 노트
MCP와 AI 에이전트로 다루는 TON 실전 가이드: rate limit, 제톤, USDT 결제, 논커스터디얼 스왑, 크로스체인.
2026년 tonapi.io 대안을 솔직하게 정리했습니다. 공개 API의 한도와 429 오류, 그리고 읽기·스왑·크로스체인·지갑을 MCP로 다루는 TONNode까지.
2026년 toncenter 대안을 정직하게 짚어봅니다. 공개 config, 자체 라이트서버, TON용 MCP를 비교하고 보장된 처리량과 논커스터디얼 도구까지 다룹니다.
TON USDT 결제 감지: get_transactions로 제톤 transfer_notification과 internal_transfer 파싱, get_jetton_info의 decimals, 금액 검증과 멱등성까지 정리했습니다.
generate_wallet 호출 한 번으로 TON 지갑을 프로그래밍 방식으로 만드는 법. v3r2, v4, v5r1, highload 버전과 니모닉·키·주소, 그리고 첫 입금을 안전하게 받는 방법까지.
MCP로 실행하는 TON → Avalanche 크로스체인 스왑. 원자적 HTLC 에스크로, 비수탁, 서버에 키를 보관하지 않습니다. 다섯 개 도구와 실전 시나리오.
MCP로 실행하는 TON → Polygon 크로스체인 스왑. 원자적 HTLC 에스크로가 TON의 가치를 Polygon으로 비수탁 이전하며, 서버는 키를 보관하지 않습니다.
TON BNB 크로스체인 스왑: 원자적 HTLC 에스크로가 TONNode의 MCP 도구를 통해 TON의 가치를 BNB Chain으로 비수탁 방식으로 옮기는 방법을 정리했습니다.
MCP로 실행하는 TON → Base 크로스체인 스왑: HTLC 에스크로, 완전 논커스터디얼, 5개 도구. 커스터디 브리지 없이 에이전트가 TON의 가치를 Base로 옮기는 방법.
MCP로 실행하는 TON → Arbitrum 크로스체인 스왑. 원자적 HTLC 에스크로, 완전 비수탁, 키 보관 없음. 전체 흐름과 지원 네트워크를 정리했습니다.
원자적 HTLC 에스크로로 구현하는 TON → Ethereum 크로스체인 스왑: quote, build, track, disclose, refund. 비수탁 방식이라 키와 자금은 여러분이 그대로 보유합니다.
TONNode는 AI 에이전트가 TON을 읽는 데 그치지 않고 논커스터디얼 스왑과 6개 EVM 네트워크로의 크로스체인 스왑까지 실행하는 첫 MCP입니다. TON 위의 DeFAI 에이전트.
AI 에이전트가 TON에서 논커스터디얼 토큰 스왑을 하는 방법. Omniston 기반 get_swap_quote와 build_swap_tx, 서버는 개인키를 보관하지도 서명하지도 않습니다.
TON 주소 형식 EQ, UQ, raw의 차이와 bounceable 대 non-bounceable 플래그, 그리고 새 지갑으로 보낸 첫 입금이 왜 발신자에게 되돌아오는지 정리했습니다.
TON Jetton의 decimals 완전 정리 — USDT는 왜 6이고 대부분의 Jetton은 9인지, get_jetton_info가 decimals를 어떻게 돌려주는지, 잔액에 왜 치명적인지
TON 지갑의 USDT 잔액을 get_jetton_balance 호출 한 번으로 가져오는 법 — Jetton 지갑 주소는 온체인에서 계산되므로 별도 인덱서가 필요 없습니다.
MCP 기반 TON 트레이딩 에이전트: 에이전트가 잔액을 읽고 확정 견적을 받아 논커스터디얼 방식으로 스왑을 조립하는 방법 — get_balance, get_swap_quote, build_swap_tx.
tonapi.io는 rate limit을 넘으면 HTTP 429를 돌려줍니다. 429 오류를 없애는 방법, 「228」이 왜 커뮤니티 밈인지, TONNode MCP로 전용 키를 받는 법까지 정리했습니다.
TON 트랜잭션 히스토리의 구조 — 논리 시간(lt), 해시, 마지막 트랜잭션 포인터. MCP로 에이전트가 히스토리를 읽는 법과 깊은 히스토리에 아카이브 노드가 필요한 이유를 정리했습니다.
toncenter의 429 Too Many Requests 오류가 왜 AI 에이전트를 가장 세게 때리는지, 백오프로 빠르게 줄이는 법, 그리고 보장된 처리량을 주는 전용 키라는 진짜 해법까지 정리했습니다.
MCP로 Claude Desktop, Claude Code, Cursor, Codex를 TON에 연결하는 방법: 정확한 설정 파일, 무료 npx 실행, 한도에 부딪혔을 때 쓰는 TONNode hosted 키까지 정리했습니다.
TON MCP 비교: 공식 @ton/mcp와 TONNode는 무엇이 다른가. 커스터디얼 에이전트 지갑 vs 크로스체인을 지원하는 논커스터디얼 MCP. 비교표와 선택 기준까지.
커스터디얼 MCP는 operator 키를 쥐고 직접 서명하고, 논커스터디얼 에이전트 지갑은 서명되지 않은 트랜잭션을 반환합니다. 키를 누가 쥐고 리스크는 무엇인지 정리했습니다.
run_get_method로 TON 컨트랙트의 모든 get 메서드를 SDK 없이 호출하기 — seqno, get_jetton_data, get_sale_data, 인자 전달, exit_code, 스택 파싱까지
무료 TON MCP 사용법 — 키 없이 npx로 AI 에이전트를 TON에 붙이거나, 카드 없는 무료 Hobby 플랜(분당 60 요청)을 받는 방법을 설정 파일과 함께 단계별로 정리했습니다.
TON 라이트서버가 not ready나 ADNL 타임아웃을 돌려주나요? 공개 config 라이트서버에서 원인을 짚고, 재시도와 TONNode hosted 키로 오류를 없애는 방법을 정리했습니다.
TON MCP 서버 완벽 가이드. MCP란 무엇인지, AI 에이전트에게 왜 TON 접근이 필요한지, npx나 hosted 키로 무료 연결하는 방법, 그리고 TONNode의 16개 도구 정리.
