Tongateway

@tongateway/mcp

适用于 Agent Gateway 的 MCP 服务，可通过 Model Context Protocol 为 AI Agent 提供对 TON 区块链的完整访问权限。

**16 个工具：**钱包信息、jetton、NFT、交易、转账、.ton DNS、价格、DEX 订单、Agent 钱包等。

快速开始

Claude Code

claude mcp add-json tongateway '{
  "command": "npx",
  "args": ["-y", "@tongateway/mcp"],
  "env": {
    "AGENT_GATEWAY_API_URL": "https://api.tongateway.ai"
  }
}' --scope user

Cursor

添加到 Cursor 设置 → MCP 服务：

{
  "mcpServers": {
    "tongateway": {
      "command": "npx",
      "args": ["-y", "@tongateway/mcp"],
      "env": {
        "AGENT_GATEWAY_API_URL": "https://api.tongateway.ai"
      }
    }
  }
}

OpenClaw

openclaw config set --strict-json plugins.entries.acpx.config.mcpServers '{
  "tongateway": {
    "command": "npx",
    "args": ["-y", "@tongateway/mcp"],
    "env": {
      "AGENT_GATEWAY_API_URL": "https://api.tongateway.ai"
    }
  }
}'

初始无需令牌——Agent 通过 auth.request 进行身份验证（生成一次性链接，用户连接钱包）。令牌会保存在 ~/.tongateway/token 中，重启后仍然有效。

工具

身份验证

工具	描述
auth.request	生成用于连接钱包的一次性链接
auth.get_token	用户连接钱包后获取令牌

钱包

工具	描述
wallet.info	钱包地址、TON 余额、账户状态
wallet.jettons	所有代币余额（USDT、NOT、DOGS 等）
wallet.transactions	最近的交易记录
wallet.nfts	钱包持有的 NFT

转账（安全——需要钱包批准）

工具	描述
transfer.request	请求转账 TON（to、amountNano、payload?、stateInit?）
transfer.status	按 ID 检查转账状态
transfer.pending	列出所有待处理请求

查询

工具	描述
lookup.resolve_name	将 .ton 域名解析为地址
lookup.price	当前 TON 对 USD/EUR 的价格

DEX（open4dev 订单簿）

工具	描述
dex.create_order	下限价单（fromToken、toToken、amount、price）
dex.pairs	列出可用的交易对

Agent 钱包（自主模式——无需批准）

工具	描述
agent_wallet.deploy	为 Agent 部署专用钱包合约
agent_wallet.transfer	直接从 Agent 钱包发送 TON
agent_wallet.info	余额、seqno、Agent 密钥状态

工作原理

You: "Send 1 TON to alice.ton"

Agent: lookup.resolve_name("alice.ton") → 0:83df...
       transfer.request(to="0:83df...", amountNano="1000000000")
       → Transfer request created. Approve in your wallet app.

对于 Agent 钱包（自主模式）：

You: "Send 0.5 TON from my agent wallet to 0:abc..."

Agent: agent_wallet.transfer(wallet, to, amount)
       → Transfer executed. No approval needed.

从源代码构建

如果你不想使用 npx，可以在本地构建并运行：

git clone https://github.com/tongateway/mcp
cd mcp
npm install
npm run build

然后将 MCP 客户端配置为使用本地构建版本：

{
  "mcpServers": {
    "tongateway": {
      "command": "node",
      "args": ["/path/to/mcp/dist/index.js"],
      "env": {
        "AGENT_GATEWAY_API_URL": "https://api.tongateway.ai"
      }
    }
  }
}

完整的安全模型请参阅 SECURITY.md。

链接

• tgw CLI — 在终端中使用 TON 区块链（npm i -g @tongateway/cli）
• tongateway.ai — 落地页和安装指南
• Dashboard — 连接钱包并管理令牌
• API Docs — Swagger UI
• Agent Wallet Contract — FunC 智能合约
• Skill File — AI Agent 的上下文文件
• Smithery — MCP 市场列表
• MCP HTTP Endpoint — 远程 MCP 传输

许可证

MIT