Model Context Protocol
MCP server cho TON
Một package biến Claude, ChatGPT, Cursor, Codex hay bất kỳ agent tương thích MCP nào thành người bản xứ của TON: đọc trạng thái chuỗi qua ADNL thuần, lấy báo giá swap chắc chắn trên DEX, dựng swap cross-chain sang Ethereum và ngược lại, tạo ví. Phi lưu ký: server không bao giờ ký hay giữ tiền.
Bắt đầu nhanh
Local · miễn phí
chạy được ngayChạy trên máy của bạn qua global config công cộng. Một khối trong config của agent — toàn bộ phần tích hợp chỉ có vậy.
claude_config.json
{
"mcpServers": {
"ton": {
"command": "npx",
"args": ["-y", "@tonnode/mcp"]
}
}
}Local · endpoint riêng của bạn
theo yêu cầuCùng package đó, trỏ vào một liteserver TONNode chuyên dụng: thông lượng đảm bảo, không xếp hàng chung. Cấp phát thủ công — hãy liên hệ chúng tôi.
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
đang chạyKhông cần cài gì: endpoint MCP từ xa với key của bạn, chạy trên node của chúng tôi. Lấy key qua các gói bên dưới.
claude_config.json
{
"mcpServers": {
"ton": {
"type": "http",
"url": "https://mcp.tonnode.io/mcp",
"headers": { "Authorization": "Bearer tn_live_…" }
}
}
}16 công cụ · đọc · swap · cross-chain · ví
get_masterchain_infoĐọc · đầu masterchain: seqno, shard, hash block — nhìn qua là biết mạng còn sống hay khôngget_balanceĐọc · số dư của bất kỳ địa chỉ nào, theo GRAM và nanoGRAM (GRAM là Toncoin sau khi đổi tên)get_account_stateĐọc · trạng thái (active/frozen/uninit), số dư, con trỏ giao dịch cuối, cờ code và dataget_transactionsĐọc · giao dịch gần đây: logical time, giá trị, người gửi và phírun_get_methodĐọc · get-method chỉ đọc trên bất kỳ hợp đồng nào: seqno, get_jetton_data và những method tương tựget_jetton_balanceĐọc · số dư USDT và bất kỳ jetton nào — ví jetton được suy ra on-chain, không cần indexerget_jetton_infoĐọc · metadata của token: tên, ký hiệu, decimals, tổng cung — decimals để quy đổi đơn vị rawparse_addressĐọc · chuyển đổi và kiểm tra địa chỉ giữa các dạng EQ…/UQ…/raw — offline, tức thìget_swap_quoteSwap · báo giá DEX chắc chắn (GRAM ⇄ jetton bất kỳ) qua Omniston — thanh khoản STON.fi + DeDustbuild_swap_txSwap · giao dịch swap chưa ký, sẵn sàng cho TonConnect — phi lưu ký, ví là bên kýget_crosschain_quoteCross-chain · báo giá swap từ TON sang Ethereum, Arbitrum, Base, BNB, Polygon hoặc Avalanchebuild_crosschain_swap_txCross-chain · giao dịch escrow HTLC chưa ký kèm secret của nó — nguyên tử và phi lưu kýtrack_crosschain_swapCross-chain · các pha trực tiếp của thương vụ trên cả hai chain, kèm cửa sổ thời gian HTLCdisclose_crosschain_secretCross-chain · tiết lộ secret để tất toán cả hai bên, sau khi kiểm tra trạng thái on-chainbuild_crosschain_refundCross-chain · lệnh hủy chưa ký, thu hồi tiền từ escrow nếu thương vụ bị kẹtgenerate_walletVí · tạo ví TON mới (v3r2/v4/v5r1/highload_v3): mnemonic, khóa và địa chỉVì sao agent cần thứ này
- Agent không thể npm install một thư viện giữa cuộc hội thoại — nó gọi công cụ. MCP chính là ổ cắm tiêu chuẩn.
- Agent truy vấn theo loạt: 40 lần gọi để phân tích một giao dịch chuyển jetton. Gateway công cộng bóp đúng kiểu pattern đó.
- Đọc thôi chưa đủ — agent cần hành động. Các công cụ swap, cross-chain và ví cho phép nó di chuyển giá trị, theo cách phi lưu ký.