tonnode/mcp

Overview

TON MCP server that exposes liteserver queries over native ADNL to any MCP client. It provides balances, account state, transaction history, and get-methods, with support for private and archive endpoints.

Best for

Best for
Developers building TON tools that need MCP-accessible on-chain data

Use cases

• Query TON wallet balances
• Inspect account state and transaction history
• Call smart contract get-methods

How to use

Install

TONNODE_KEYS=tn_live_abc,tn_live_def PORT=8808 npx -y @tonnode/mcp --http

Tools exposed

• get_balance
• get_jetton_balance
• get_jetton_info
• get_transactions
• get_account_state
• run_get_method
• parse_address
• get_masterchain_info
• get_swap_quote
• build_swap_tx
• get_crosschain_quote
• build_crosschain_swap_tx
• track_crosschain_swap
• disclose_crosschain_secret
• build_crosschain_refund
• generate_wallet
• TON_LITESERVERS
• TON_CONFIG_URL
• TONNODE_KEYS
• TONNODE_KEYS_FILE

Tested with

Claude Desktop, Claude Code, Cursor, ChatGPT

Example client config

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

Notes

TON MCP server that exposes liteserver queries over native ADNL to any MCP client. It provides balances, account state, transaction history, and get-methods, with support for private and archive endpoints.

31 stars on GitHub. Last updated 2026-08-04. Licensed MIT.

Use cases

• Query TON wallet balances
• Inspect account state and transaction history
• Call smart contract get-methods

Pros

• Works with Claude, ChatGPT, Cursor, Codex and any MCP client
• Supports private and archive TON endpoints
• Native ADNL queries keep requests direct

Cons

• Read-only operations, no transaction sending
• Small community with only 31 stars
• Requires access to TON liteservers

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.