Ton Cli

Direct command-line access to TON blockchain operations without spinning up an MCP server. You get wallet queries, balance checks, jetton transfers, NFT sends, DNS resolution, and even swap quotes, all via `npx @ton/mcp@alpha <tool_name>`. It supports both single-wallet mode (pass a mnemonic) and a local wallet registry at `~/.config/ton/config.json`. The emulate_transaction tool is smart for dry-running before you commit funds. Output is JSON to stdout, so it pipes cleanly into scripts. Honestly, this is what you reach for when you want TON operations in a shell script or need Claude to check balances and send transactions without the ceremony of a persistent server session.

skills.sh installs: 127
GitHub stars: 46
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add ton-connect/kit --skill ton-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

TON MCP Raw CLI Mode

Run any TON wallet MCP tool directly from the command line. The binary invokes the tool, prints the JSON result to stdout, and exits.

Invocation Modes

Command	Description
`npx @ton/mcp@alpha`	stdio MCP server (for Claude Desktop / MCP clients)
`npx @ton/mcp@alpha --http [port]`	HTTP MCP server
`npx @ton/mcp@alpha <tool_name> [--arg value ...]`	Raw CLI: call one tool and exit

Use exactly one mode for a given workflow: either MCP server mode (stdio/--http) or raw CLI. Do not combine them in the same task/session.

Raw CLI Usage

# No arguments
npx @ton/mcp@alpha get_balance

# Named arguments (--key value)
npx @ton/mcp@alpha get_transactions --limit 5
npx @ton/mcp@alpha get_jetton_balance --jettonAddress EQAbc...

# All values are passed as plain strings; JSON objects/arrays are also accepted
npx @ton/mcp@alpha get_transactions --limit 10
npx @ton/mcp@alpha build_ton_transfer --toAddress UQA... --amount 0.1 --comment "hi"
npx @ton/mcp@alpha generate_ton_proof --domain getgems.io --payload getgems-llm

SKILL.md on GitHub