Tongateway

by tongateway

315 downloads
Not rated
GitHub

Description

# @tongateway/mcp [![smithery badge](https://smithery.ai/badge/tongateway/agent)](https://smithery.ai/servers/tongateway/agent) MCP server for [Agent Gateway](https://tongateway.ai) — gives AI agents full access to the TON blockchain via Model Context Protocol. **16 tools:**…

About

# @tongateway/mcp [![smithery badge](https://smithery.ai/badge/tongateway/agent)](https://smithery.ai/servers/tongateway/agent) MCP server for [Agent Gateway](https://tongateway.ai) — gives AI agents full access to the TON blockchain via Model Context Protocol. **16 tools:** wallet info, jettons, NFTs, transactions…

Details

Author
tongateway
Downloads
315
Categories
Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Tongateway
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

@tongateway/mcp

smithery badge

MCP server for Agent Gateway — gives AI agents full access to the TON blockchain via Model Context Protocol.

16 tools: wallet info, jettons, NFTs, transactions, transfers, .ton DNS, prices, DEX orders, agent wallets, and more.

Quick Start

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

Add to Cursor Settings → MCP Servers:

{
  "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"
    }
  }
}'

No token needed upfront — the agent authenticates via auth.request (generates a one-time link, user connects wallet). Token persists in ~/.tongateway/token across restarts.

Tools

Auth

| Tool | Description |
|------|-------------|
| auth.request | Generate a one-time link for wallet connection |
| auth.get_token | Retrieve token after user connects wallet |

Wallet

| Tool | Description |
|------|-------------|
| wallet.info | Wallet address, TON balance, account status |
| wallet.jettons | All token balances (USDT, NOT, DOGS, etc.) |
| wallet.transactions | Recent transaction history |
| wallet.nfts | NFTs owned by the wallet |

Transfers (Safe — requires wallet approval)

| Tool | Description |
|------|-------------|
| transfer.request | Request a TON transfer (to, amountNano, payload?, stateInit?) |
| transfer.status | Check transfer status by ID |
| transfer.pending | List all pending requests |

Lookup

| Tool | Description |
|------|-------------|
| lookup.resolve_name | Resolve .ton domain to address |
| lookup.price | Current TON price in USD/EUR |

DEX (open4dev order book)

| Tool | Description |
|------|-------------|
| dex.create_order | Place a limit order (fromToken, toToken, amount, price) |
| dex.pairs | List available trading pairs |

Agent Wallet (Autonomous — no approval needed)

| Tool | Description |
|------|-------------|
| agent_wallet.deploy | Deploy a dedicated wallet contract for the agent |
| agent_wallet.transfer | Send TON directly from agent wallet |
| agent_wallet.info | Balance, seqno, agent key status |

How it works

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.

For agent wallets (autonomous mode):

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

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

Build from Source

If you prefer not to use npx, you can build and run locally:

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

Then configure your MCP client to use the local build:

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

See SECURITY.md for the full security model.

Links

- tongateway.ai — landing page + install guides
- Dashboard — connect wallet & manage tokens
- API Docs — Swagger UI
- Agent Wallet Contract — FunC smart contract
- Skill File — context file for AI agents
- Smithery — MCP marketplace listing
- MCP HTTP Endpoint — remote MCP transport

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.