Overview
What is Tongateway?
Tongateway is an MCP (Model Context Protocol) server for Agent Gateway that gives AI agents full access to the TON blockchain. It provides 16 tools covering wallet info, jettons, NFTs, transactions, transfers, .ton DNS resolution, prices, DEX orders, and agent wallets. It is built for developers and AI agents that need to interact with the TON blockchain through natural language.
How to use Tongateway?
Install and configure Tongateway by adding it as an MCP server to your client (e.g., Claude Code, Cursor, OpenClaw) using npx -y @tongateway/mcp and setting the environment variable AGENT_GATEWAY_API_URL to https://api.tongateway.ai. No API token is needed upfront; the agent initiates authentication via auth.request, which generates a one-time link for the user to connect their wallet. The token is then stored in ~/.tongateway/token and persists across restarts.
Key features of Tongateway
- 16 tools for TON blockchain interactions
- Safe transfers require wallet approval
- Autonomous agent wallet mode (no approval needed)
- .ton DNS domain resolution
- DEX limit orders via open4dev order book
- Token persistence across restarts
Use cases of Tongateway
- Send TON to a .ton domain using natural language
- Query wallet balances, token holdings, and NFTs
- Place limit orders on a DEX
- Deploy an agent wallet for autonomous transfers
- Resolve .ton domain names to blockchain addresses
FAQ from Tongateway
How does authentication work in Tongateway?
No API token is needed upfront. The agent uses auth.request to generate a one-time link; after the user connects their wallet, the token is retrieved with auth.get_token and saved to ~/.tongateway/token.
What is the difference between safe transfers and agent wallet transfers?
Safe transfers use transfer.request and require the user to approve the transaction in their wallet. Agent wallet transfers use agent_wallet.transfer and execute autonomously without approval, but require a dedicated agent wallet contract to be deployed first.
Do I need an API key to use Tongateway?
No. Authentication is handled through the wallet connection flow; no API key is required.
Can I run Tongateway from source instead of using npx?
Yes. Clone the repository, run npm install and npm run build, then point your MCP client to the local dist/index.js file with the same environment variable.
What TON features does Tongateway support?
Tongateway supports wallet info, jetton balances, NFTs, transaction history, TON transfers, .ton DNS resolution, TON price queries, and DEX limit orders. It also supports deploying and operating an autonomous agent wallet.
