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:

1. Call auth.request — you'll get a one-time link
2. Ask the user to open the link and connect their wallet
3. Call auth.get_token with the authId — you'll get a token
4. All other tools now work. Token persists across restarts.

Tools#

Wallet#

ToolParamsDescriptionwallet.info—Wallet address, TON balance, account statuswallet.jettons—All token balances (USDT, NOT, DOGS, etc.)wallet.transactions``limit? (number)Recent transaction historywallet.nfts—NFTs owned by the wallet

Transfers (Safe — requires wallet approval)#

ToolParamsDescriptiontransfer.request``to, amountNano, payload?, stateInit?Queue a TON transfer for owner approvaltransfer.status``idCheck status: pending, confirmed, rejected, expiredtransfer.pending—List all pending transfer requests

Lookup#

ToolParamsDescriptionlookup.resolve_name``domainResolve .ton domain to address. ALWAYS use before transfer when user gives a .ton namelookup.price``currencies?TON price in USD/EUR/etc.

DEX (open4dev order book)#

ToolParamsDescriptiondex.create_order``fromToken, toToken, amount, pricePlace 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)#

ToolParamsDescriptionagent_wallet.deploy—Deploy a dedicated wallet contract. WARNING: agent can spend funds without approvalagent_wallet.transfer``walletAddress, to, amountNanoSend TON directly from agent walletagent_wallet.info``walletAddress?Balance, seqno, status. Omit address to list all

Auth#

ToolParamsDescriptionauth.request``label?Generate a one-time auth linkauth.get_token``authIdRetrieve token after user connects wallet

Amount conversion#

Amounts are in nanoTON: 1 TON = 1,000,000,000 nanoTON

TONnanoTON0.11000000000.5500000000110000000001010000000000

Token decimals: TON/NOT/DOGS/BUILD/AGNT/PX/CBBTC = 9 decimals. USDT/XAUT0 = 6 decimals.

Usage examples#

Check wallet and tokens#

text

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#

text

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#

text

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)#

text

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_name when the user gives a .ton domain
• Token persists in ~/.tongateway/token across 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