hoton-mcp

Buy Telegram Stars & Premium, and top up your Telegram GRAM balance — all from a single prompt like "buy 100 stars for @alice" — with any AI agent.

hoton-mcp is a small, keyless MCP server: it builds the order, and your agent's wallet pays. It never holds your keys or your money.

How it works

Three steps, all driven by your agent:

you:    "buy 100 stars for @alice"
agent:  hoton  → builds the order (shows the price + an unsigned transaction)
agent:  wallet → signs & pays  →  txHash
agent:  hoton  → confirms it settled on-chain, returns a tonviewer link  ✅

What you need

Two MCP servers, running side by side. You don't install either one — your agent fetches them automatically on first use via npx:

You only need Node.js on your machine (you already have it if you run any of these agents). npx pulls the package from npm the first time and caches it — no npm install, no clone, no build.

The config (identical for every agent)

MCP is a standard, so every agent uses the same two servers. Only where you paste this changes (below).

{
  "mcpServers": {
    "hoton": {
      "command": "npx",
      "args": ["-y", "hoton-mcp"],
      "env": { "HOTON_BACKEND_URL": "https://hoton.up.railway.app" }
    },
    "ton": { "command": "npx", "args": ["-y", "@ton/mcp@alpha"] }
  }
}

Add it to your agent

Telegram agents

OpenClaw — add the two servers to the mcpServers section of your openclaw.json, then restart. (MCP guide)

Hermes — run hermes mcp add, or paste this into your config's mcp_servers: block (docs):

mcp_servers:
  hoton:
    command: npx
    args: ["-y", "hoton-mcp"]
    env:
      HOTON_BACKEND_URL: "https://hoton.up.railway.app"
  ton:
    command: npx
    args: ["-y", "@ton/mcp@alpha"]

Desktop / coding agents

Claude — Claude Code: claude mcp add hoton -- npx -y hoton-mcp and claude mcp add ton -- npx -y @ton/mcp@alpha. Claude Desktop: paste the JSON above into claude_desktop_config.json.

Codex — add the servers to ~/.codex/config.toml under [mcp_servers].

Cursor — paste the JSON above into .cursor/mcp.json.

Then just talk to it

• "is hoton online?"

• "buy 100 stars for @alice"

• "gift @bob 3 months of premium"

• "top up @carol with 5 GRAM"

• "buy 50 stars each for @a, @b and @c" — bulk, up to 10 in one signature

Tools

hoton_use_wallet · hoton_use_referrer · hoton_find_recipient · hoton_buy_stars (+_bulk) · hoton_buy_premium (+_bulk) · hoton_topup_gram (+_bulk) · hoton_confirm · hoton_status

Settings

Referrals

The referrer comes from your prompt. "buy 50 stars for @monk on hoton.tg/damx" → damx earns 35% of the fee. No link → no commission. (First-referrer-wins, enforced by the backend.)

Run from source (for contributors)

To hack on the server, run it from a local clone instead of npm:

git clone https://github.com/hotonlabs/hoton-mcp.git
cd hoton-mcp
yarn install
yarn build

Then point your agent at node /absolute/path/to/hoton-mcp/dist/index.js instead of npx -y hoton-mcp.

Safety

• Keyless. hoton-mcp only builds orders — it never holds keys or funds. Your wallet signs.

• Fund the agent wallet with only what you're willing to spend. You keep the master key and can revoke the agent anytime — see agents.ton.org.

• HOTON_MAX_ORDER caps any single order.

License

MIT — see LICENSE.