Model Context Protocol
TON을 위한 MCP 서버
패키지 하나로 Claude, ChatGPT, Cursor, Codex 등 MCP 호환 에이전트가 TON 네이티브가 됩니다: raw ADNL로 네트워크 상태 읽기, DEX 스왑 확정 견적, Ethereum을 오가는 크로스체인 스왑 구성, 지갑 생성. 논커스터디얼: 서버는 서명하지 않고 자금을 보관하지 않습니다.
빠른 시작
로컬 · 무료
지금 바로 작동퍼블릭 글로벌 설정으로 내 머신에서 실행됩니다. 에이전트 설정의 블록 하나가 통합의 전부입니다.
claude_config.json
{
"mcpServers": {
"ton": {
"command": "npx",
"args": ["-y", "@tonnode/mcp"]
}
}
}로컬 · 나만의 프라이빗 엔드포인트
요청 시같은 패키지를 TONNode 전용 라이트서버로 지정한 구성입니다: 보장된 처리량, 공유 대기열 없음. 수동으로 개설해 드립니다 — 연락 주세요.
claude_config.json
{
"mcpServers": {
"ton": {
"command": "npx",
"args": ["-y", "@tonnode/mcp"],
"env": {
"TON_LITESERVERS": "[{\"ip\":\"<your-node>\",\"port\":41000,\"key\":\"<base64>\"}]"
}
}
}
}Hosted · mcp.tonnode.io
가동 중설치할 것이 없습니다: 저희 노드에서 내 키로 쓰는 원격 MCP 엔드포인트. 키는 아래 요금제에서 발급받으세요.
claude_config.json
{
"mcpServers": {
"ton": {
"type": "http",
"url": "https://mcp.tonnode.io/mcp",
"headers": { "Authorization": "Bearer tn_live_…" }
}
}
}16가지 도구 · 읽기 · 스왑 · 크로스체인 · 지갑
get_masterchain_info읽기 · 마스터체인 헤드: seqno, 샤드, 블록 해시 — 네트워크 상태를 한눈에get_balance읽기 · 임의 주소의 잔액을 GRAM과 나노GRAM으로 (GRAM은 리브랜딩된 Toncoin)get_account_state읽기 · 상태(active/frozen/uninit), 잔액, 마지막 트랜잭션 포인터, 코드·데이터 플래그get_transactions읽기 · 최근 트랜잭션: 논리 시간, 금액, 발신자, 수수료run_get_method읽기 · 임의 컨트랙트의 읽기 전용 get 메서드: seqno, get_jetton_data 등get_jetton_balance읽기 · USDT 등 모든 제톤 잔액 — 제톤 지갑을 온체인으로 계산, 인덱서 불필요get_jetton_info읽기 · 토큰 메타데이터: 이름, 심벌, decimals, 발행량 — raw 단위 환산에 필요한 decimals까지parse_address읽기 · EQ…/UQ…/raw 형식 간 주소 변환·검증 — 오프라인, 즉시get_swap_quote스왑 · Omniston 경유 DEX 확정 견적 (GRAM ⇄ 모든 제톤) — STON.fi + DeDust 유동성build_swap_tx스왑 · TonConnect용 서명되지 않은 스왑 트랜잭션 — 논커스터디얼, 서명은 지갑이 합니다get_crosschain_quote크로스체인 · TON에서 Ethereum, Arbitrum, Base, BNB, Polygon, Avalanche로의 스왑 견적build_crosschain_swap_tx크로스체인 · 서명되지 않은 HTLC 에스크로 트랜잭션과 그 시크릿 — 원자적, 논커스터디얼track_crosschain_swap크로스체인 · 양쪽 체인의 스왑 단계를 HTLC 시간 창과 함께 실시간 추적disclose_crosschain_secret크로스체인 · 온체인 상태 확인 후 양쪽 정산을 위한 시크릿 공개build_crosschain_refund크로스체인 · 스왑이 멈추면 에스크로 자금을 되찾는 서명되지 않은 환불 트랜잭션generate_wallet지갑 · 새 TON 지갑 생성 (v3r2/v4/v5r1/highload_v3): 니모닉, 키, 주소에이전트에게 왜 필요한가
- 에이전트는 대화 중에 npm install을 할 수 없습니다 — 도구를 호출할 뿐입니다. MCP가 바로 그 표준 소켓입니다.
- 에이전트는 버스트로 호출합니다: 제톤 전송 하나를 분석하는 데 40번. 퍼블릭 게이트웨이는 정확히 이 패턴을 잘라냅니다.
- 읽기만으로는 부족합니다 — 에이전트는 행동해야 합니다. 스왑, 크로스체인, 지갑 도구가 가치를 옮기게 해 줍니다. 논커스터디얼로.