Access TON blockchain tools to check wallet info, tokens, send transfers, resolve .ton names, trade on DEX, and manage autonomous agent wallets.
Agent Gateway
Agent Gateway gives you 16 tools to interact with TON blockchain. Check balances, view tokens/NFTs, send transfers, resolve .ton names, place DEX orders, and deploy autonomous agent wallets.
MCP package: @tongateway/mcp (install via npx -y @tongateway/mcp)
Authentication
If you get "No token configured" errors, authenticate first:
- Call
auth.request— you'll get a one-time link - Ask the user to open the link and connect their wallet
- Call
auth.get_tokenwith the authId — you'll get a token - All other tools now work. Token persists across restarts.
Tools
Wallet
| Tool | Params | Description |
|---|---|---|
wallet.info | — | Wallet address, TON balance, account status |
wallet.jettons | — | All token balances (USDT, NOT, DOGS, etc.) |
wallet.transactions | limit? (number) | Recent transaction history |
wallet.nfts | — | NFTs owned by the wallet |
Transfers (Safe — requires wallet approval)
| Tool | Params | Description |
|---|---|---|
transfer.request | to, amountNano, payload?, stateInit? | Queue a TON transfer for owner approval |
transfer.status | id | Check status: pending, confirmed, rejected, expired |
transfer.pending | — | List all pending transfer requests |
Lookup
| Tool | Params | Description |
|---|---|---|
lookup.resolve_name | domain | Resolve .ton domain to address. ALWAYS use before transfer when user gives a .ton name |
lookup.price | currencies? | TON price in USD/EUR/etc. |
DEX (open4dev order book)
| Tool | Params | Description |
|---|---|---|
dex.create_order | fromToken, toToken, amount, price | Place a limit order. Price is human-readable (e.g. 20 = "1 USDT = 20 AGNT") |
dex.pairs | — | List available trading pairs |
Agent Wallet (Autonomous — NO approval needed)
| Tool | Params | Description |
|---|---|---|
agent_wallet.deploy | — | Deploy a dedicated wallet contract. WARNING: agent can spend funds without approval |
agent_wallet.transfer | walletAddress, to, amountNano | Send TON directly from agent wallet |
agent_wallet.info | walletAddress? | Balance, seqno, status. Omit address to list all |
Auth
| Tool | Params | Description |
|---|---|---|
auth.request | label? | Generate a one-time auth link |
auth.get_token | authId | Retrieve token after user connects wallet |
Amount conversion
Amounts are in nanoTON: 1 TON = 1,000,000,000 nanoTON
| TON | nanoTON |
|---|---|
| 0.1 | 100000000 |
| 0.5 | 500000000 |
| 1 | 1000000000 |
| 10 | 10000000000 |
Token decimals: TON/NOT/DOGS/BUILD/AGNT/PX/CBBTC = 9 decimals. USDT/XAUT0 = 6 decimals.
Usage examples
Check wallet and tokens
wallet.info()
→ Address: 0:9d43...0c02, Balance: 823.18 TON, Status: active
wallet.jettons()
→ USDT: 107.79, NOT: 3,186,370.60, BUILD: 45,277.57
Send TON to .ton domain
lookup.resolve_name({ domain: "alice.ton" })
→ alice.ton → 0:83df...31a8
transfer.request({ to: "0:83df...31a8", amountNano: "500000000" })
→ Transfer request created. Approve in your wallet app.
Place a DEX order
dex.create_order({ fromToken: "NOT", toToken: "TON", amount: "10000", price: 0.000289 })
→ Order placed on open4dev DEX. Approve in your wallet app.
Autonomous transfer (no approval)
agent_wallet.deploy()
→ Agent Wallet deployed at EQCT1...
agent_wallet.transfer({ walletAddress: "EQCT1...", to: "0:abc...", amountNano: "500000000" })
→ Transfer executed. No approval needed.
Important
- Safe mode (default): You request transfers, the wallet owner approves on their phone
- Autonomous mode: Agent wallet — agent signs directly, no approval. Only use when user explicitly asks
- Requests expire in 5 minutes if not approved
- Always use
lookup.resolve_namewhen the user gives a .ton domain - Token persists in
~/.tongateway/tokenacross restarts
Security
See SECURITY.md for full security model details.
Links
- Website: https://tongateway.ai
- API docs: https://api.tongateway.ai/docs
- MCP package: https://www.npmjs.com/package/@tongateway/mcp
- GitHub: https://github.com/tongateway/mcp
Related skills
- Downloads
- 893All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v0.9.3
- License
- MIT-0
