TONNode — TON blockchain access: Claude Code MCP server
Gives AI assistants direct liteserver access to TON via native ADNL. Checks GRAM or jetton balances, queries smart contracts, and prepares non-custodial DEX swaps.
claude mcp add --transport http mcp https://mcp.tonnode.io/mcpWhat TONNode — TON blockchain access does
The server connects straight to TON liteservers without relying on intermediate web gateways. By speaking the native ADNL protocol, it inspects account states, fetches transaction logs, and tracks balances for GRAM and TEP-74 jettons. It also runs read-only contract get-methods without paying gas fees.
Trading operations pull liquidity quotes through Omniston. The agent receives an unsigned payload formatted for TonConnect wallets, covering DEX swaps and cross-chain HTLC escrows toward networks like Ethereum or Arbitrum. The process stays strictly non-custodial: signing authority never leaves the user.
Wallet creation outputs a 24-word seed phrase straight into the agent session. Storing significant funds on such generated addresses is unsafe, making them suitable only for disposable bot tasks. Run the tool locally via npx or route requests through the hosted HTTP endpoint.
What it helps with
- query account balances for GRAM and TEP-74 jettons
- execute read-only smart contract get-methods without network fees
- fetch DEX swap quotes and construct unsigned TonConnect payloads
- create disposable keypairs and wallet addresses for testing
Example prompts for the agent
- Check the GRAM balance and recent transfers for address
EQ... - Get a swap quote for 100 GRAM to USDT and prepare the unsigned transaction
- Run the
get_jetton_datamethod on this contract address
How to install TONNode — TON blockchain access
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.tonnode.io/mcp2Platform CLI
claude mcp add --env TON_LITESERVERS=<TON_LITESERVERS> --env TON_NETWORK=<TON_NETWORK> --transport stdio tonnode-ton-blockchain-access -- npx -y @tonnode/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add tonnode-ton-blockchain-access --url https://mcp.tonnode.io/mcp2Platform CLI
codex mcp add tonnode-ton-blockchain-access --env TON_LITESERVERS=<TON_LITESERVERS> --env TON_NETWORK=<TON_NETWORK> -- npx -y @tonnode/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"tonnode-ton-blockchain-access": {
"url": "https://mcp.tonnode.io/mcp"
}
}
}{
"mcpServers": {
"tonnode-ton-blockchain-access": {
"command": "npx",
"args": [
"-y",
"@tonnode/mcp"
],
"env": {
"TON_LITESERVERS": "<TON_LITESERVERS>",
"TON_NETWORK": "<TON_NETWORK>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tonnode-ton-blockchain-access": {
"type": "http",
"url": "https://mcp.tonnode.io/mcp"
}
}
}{
"servers": {
"tonnode-ton-blockchain-access": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tonnode/mcp"
],
"env": {
"TON_LITESERVERS": "<TON_LITESERVERS>",
"TON_NETWORK": "<TON_NETWORK>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http tonnode-ton-blockchain-access https://mcp.tonnode.io/mcp2Platform CLI
gemini mcp add -e TON_LITESERVERS=<TON_LITESERVERS> -e TON_NETWORK=<TON_NETWORK> tonnode-ton-blockchain-access npx -y @tonnode/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about TONNode — TON blockchain access
How to install TONNode — TON blockchain access in Claude Code?
Run claude mcp add --transport http tonnode-ton-blockchain-access https://mcp.tonnode.io/mcp. For local execution over stdio, run `claude mcp add --env TON_LITESERVERS=<TON_LITESERVERS> --env TON_NETWORK=<TON_NETWORK> --transport stdio tonnode-ton-blockchain-access -- npx -y @tonnode/mcp`.
Can the server broadcast transactions on its own?
No, operations are entirely non-custodial. The tool prepares unsigned messages, leaving authorization and signing strictly to your external wallet.
What makes ADNL access different from standard REST APIs?
It queries TON liteservers over the chain's native wire protocol. This bypasses centralized public gateways and avoids intermediary rate limits.
