GT Protocol MCP Server — connect Claude, Cursor, Claude Code, or any MCP-compatible AI agent to your GT Protocol trading account.

Manage bots, run backtests, check balances, and automate trading strategies — all through natural language.

Model Context Protocol is an open standard that lets AI agents call external tools. This server exposes the GT Protocol REST API as a set of tools that any MCP-compatible AI can use.

Add this to your .mcp.json (or ~/.claude.json for global access):

{
  "mcpServers": {
    "gt-protocol": {
      "command": "node",
      "args": ["/path/to/gt-protocol/mcp-server/index.js"]
    }
  }
}

No env variables needed.

On first use, call the authenticate tool:

Authenticate with GT Protocol using email@example.com and my password

The server calls /auth/sign_in, saves tokens to ~/.gt-mcp-auth.json, and confirms with your account email.

Tokens auto-refresh as long as you use the server at least once every 7 days. After 7 days of total inactivity, call authenticate again.

Signed up with Google? You don't have a password. Open the GT Protocol web app, open DevTools → Application → Local Storage, copy access_token and refresh_token, and add them to .mcp.json as env vars:

"env": {
  "GT_TOKEN": "<access_token>",
  "GT_REFRESH_TOKEN": "<refresh_token>"
}

The server will pick them up on startup and auto-refresh from there.

List my active bots
What's my Binance balance?
Create a BTC/USDT long bot with $50 start order and 2% take profit
Close the deal on bot 12345
Run a backtest for ETH/USDT with MACD strategy, 3% TP, 1% SL

Note: Backtest requests are routed through a proxy. The proxy key is fetched automatically after authenticate — no extra env vars needed.

What's the status of all my bots? Which ones have active deals?
Show me my total profit this week.
What's my available USDT balance on Binance?

Run a backtest for BTC/USDT on Binance with bollinger strategy,
long direction, 2.5% TP, 1% SL, 5m timeframe, last 30 days.
Compare with MACD strategy same params.

Stop all my losing bots (those with negative total profit).
Update bot 12345 — increase take profit to 3% and add a 5% stop loss.
Start a deal on bot 12345 right now without waiting for a signal.

GT Protocol supports paper (demo) trading — test strategies without real capital.

• Set paper: true in create_bot to create a demo bot from scratch
• Use paper_clone to copy an existing live bot into demo mode

Paper bots run on real market data but don't place real orders.

Tokens are stored in ~/.gt-mcp-auth.json after the first authenticate call.

When the refresh token expires (~7 days of total inactivity), call authenticate again. Normal usage keeps tokens alive indefinitely through automatic refresh.

You can still set GT_TOKEN / GT_REFRESH_TOKEN in .mcp.json env to override the saved tokens — useful for CI/automation.

• Binance (SPOT + FUTURES)
• Hyperliquid (FUTURES)

• Node.js 18+ (dependencies are bundled — no npm install needed)
• A GT Protocol account — sign up at gt-protocol.io
• A connected exchange account (Binance or Hyperliquid)

MIT — free to use, fork, and extend.

Built by GT Protocol.