TON MCP + Codex CLI

Simple flow how to run TON MCP Server with Codex CLI.

Quick start

Run MCP Server

First: node scripts/ton-mcp-stdio.mjs --http 3001

Add MCP Server to Codex CLI

codex mcp add --url http://localhost:3001/mcp ton-wallet

Run Codex CLI

codex

Commands

1. show my wallet balance

Called ton-wallet.get_balance({})
  └ {"success": true, "address": "UQCSm2q2mFmTY8L73KFJAzk-AV-sqOsogh4YwSvpR8cRW6jt", "balance": "1.987803165 TON", "balanceNano":
        "1987803165"}

2. exchange on DeDust 0.1 TON to EQBlqsm144Dq6SjbPI4jjZvA1hqTIP3CvHovbIfW_t-SCALE (DUST) token

• I’ll fetch a swap quote on DeDust for 0.1 TON first.

• Called
  └ ton-wallet.get_swap_quote({"amount":"0.1","fromToken":"TON","toToken":"EQBlqsm144Dq6SjbPI4jjZvA1hqTIP3CvHovbIfW_t-SCALE"})

Useful resources

docs ton ai/mcp