AI 에이전트를 위해
읽고, 스왑하고, 체인 간에 가치를 옮기기 — 엔드포인트 하나로.
TONNode MCP 서버는 Claude, Cursor 등 어떤 MCP 클라이언트에도 네이티브 ADNL 기반 TON 풀 툴킷을 제공합니다: 네트워크 상태 읽기, DEX 스왑 확정 견적, Ethereum을 오가는 크로스체인 스왑 구성, 지갑 생성. 논커스터디얼 — 서버는 서명하지 않고 자금을 보관하지 않습니다.
{
"mcpServers": {
"ton": {
"command": "npx",
"args": ["-y", "@tonnode/mcp"]
}
}
}MCP 설정에 블록 하나, 퍼블릭 설정에서는 무료. 보장된 처리량이 필요해지면 hosted 키를 지정하세요.
퍼블릭 설정 vs TONNode
퍼블릭 설정은 무료입니다. 다만 여기까지입니다.
TON의 퍼블릭 라이트서버는 공유되고, 제한되고, 읽기 전용입니다. TONNode 키는 에이전트에게 보장된 처리량과 16가지 도구를 제공합니다 — 퍼블릭 설정에는 없는 스왑, 크로스체인, 지갑 도구까지.
| 퍼블릭 global config | TONNode | |
|---|---|---|
| 접근 | 공유 퍼블릭 라이트서버 | 내 키로 쓰는 Hosted MCP 엔드포인트 |
| Rate limit | 익명 ~1 요청/초, 버스트는 스로틀링 | 60–1200 요청/분, 보장 |
| 도구 | 읽기 전용, 직접 조립하는 만큼 | 16가지 도구: 읽기 · 스왑 · 크로스체인 · 지갑 |
| 스왑 & 크로스체인 | 불가 | 논커스터디얼 DEX·크로스체인 스왑 |
| 설정 | 직접 구성하고 유지보수 | 설정 블록 하나 또는 무료 npx 패키지 |
| 히스토리 깊이 | 최근 블록만 | 최근 블록 (아카이브는 요청 시) |
→ npx로 퍼블릭 설정에서 무료로 시작하세요. 에이전트에 처리량이나 스왑·크로스체인 도구가 필요해지면 키로 넘어오면 됩니다.
실전 워크로드를 위해
에이전트와 앱이 이 위에서 만드는 것들
TON을 읽는 AI 에이전트
에이전트는 잔액, 제톤, NFT, 트랜잭션, get 메서드를 필요할 때마다 요청합니다 — 그것도 버스트로, 전송 하나를 분석하는 데 40번을 호출하면서. MCP 키 하나로 Claude나 Cursor가 이 모든 것을 네이티브 ADNL과 보장된 처리량으로 사용합니다.
스왑하고 가치를 옮기는 에이전트
읽기만이 아닙니다: DEX 스왑 확정 견적, 서명되지 않은 스왑 트랜잭션, TON과 Ethereum을 오가는 크로스체인 스왑 — 모두 논커스터디얼이며, 서명은 에이전트의 지갑이 합니다. 경쟁하는 어떤 TON MCP에도 없는 기능입니다.
Telegram Mini Apps & 봇
미니앱이 입소문을 타는 순간이 곧 rate limit 장애입니다. Hosted 키는 분당 요청 수를 보장해, 대박 난 날이 퍼블릭 설정의 스로틀링으로 끝나지 않게 합니다.
지갑 & 스크립트
임의 주소의 잔액과 히스토리 조회, 새 지갑 생성, 주소 검증과 변환 — 읽기 도구 전체를 하나의 엔드포인트로, npx 셀프호스트는 무료입니다.
FAQ
엔지니어들이 실제로 묻는 질문들
TONNode MCP 서버란 무엇인가요?
Claude, Cursor, ChatGPT, Codex 등 어떤 MCP 클라이언트든 TON의 네이티브 참여자로 만들어 주는 단일 엔드포인트입니다. 16가지 도구를 제공합니다: 네이티브 ADNL로 잔액, 제톤, NFT, 트랜잭션, get 메서드 읽기, 그리고 DEX 스왑 견적, EVM 체인으로의 크로스체인 스왑, 지갑 생성까지.
커스터디얼인가요? 제 키는 안전한가요?
스왑, 크로스체인, 지갑 도구는 엄격하게 논커스터디얼입니다. 서버는 절대 서명하지 않고 자금을 보관하지 않습니다 — 서명되지 않은 TonConnect 메시지를 반환하고, 서명은 당신의 지갑이 합니다. 생성된 지갑은 만들어져 당신에게 전달될 뿐, 서버는 아무것도 저장하지 않습니다.
키는 얼마나 빨리 받을 수 있나요?
무료 Hobby 키는 TON 지갑 또는 Telegram 로그인 직후 바로 발급됩니다. Pro와 Scale 키는 온체인 결제 한 번으로 즉시 활성화됩니다 — 보통 1분 이내입니다.
결제 수단은 무엇인가요?
TON Connect를 통한 TON 네트워크의 GRAM과 USDT(GRAM은 리브랜딩된 Toncoin), 또는 Telegram 안의 xRocket 인보이스로 BTC, ETH, SOL 등을 지원합니다. 결제가 확인되는 즉시 키가 자동 발급됩니다.
무료로 셀프호스트할 수 있나요?
네. `npx -y @tonnode/mcp`가 TON 퍼블릭 글로벌 설정으로 서버를 로컬에서 실행합니다 — 읽기 도구 전체를 가입도 키도 없이. Hosted 키는 보장된 처리량과 원격 엔드포인트를 더해, 직접 아무것도 돌릴 필요가 없게 해 줍니다.
그냥 퍼블릭 설정을 쓰면 안 되나요?
주말 프로젝트라면 충분합니다. 퍼블릭 라이트서버는 공유되고 제한되며 깊은 히스토리를 보관하지 않는데, 에이전트는 퍼블릭 게이트웨이가 스로틀링하는 바로 그 버스트 패턴으로 호출합니다. Hosted 키는 정확히 이 패턴을 위해 저희 노드에서 보장된 처리량을 제공합니다.
제 요청을 로깅하나요?
청구와 용량 계획을 위해 집계된 카운터 — 요청량과 오류율 — 만 보관합니다. 요청 내용, 조회하는 주소, 클라이언트 IP는 어뷰즈 방지 수준을 넘어 로깅하지 않습니다.
환불과 가동률은요?
유료 월간 요금제는 처음 7일 안에 취소하면 결제한 수단 그대로 전액 환불됩니다. 현재는 단일 리전에서 best-effort로 운영 중이며, 예비 인프라가 마련되는 대로 상태 페이지와 서면 SLA를 공개하겠습니다.