Skip to content
MCP server

GDEX Trading

Let an agent trade spot and perpetuals across Solana, EVM chains and Hyperliquid

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
5.4.1
Listing updated
3 days ago

About GDEX Trading

GDEX Trading is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

The README counts 162 tools in this server: 153 that execute trades or read account state and 9 that search and read GDEX documentation. Spot swaps cover Solana, Sui and ten EVM chains, with market and limit orders. Perpetuals run on Hyperliquid, including tokenized equities, FX and commodities. Copy trading, cross-chain bridging, portfolio views and token discovery are also included.

This server can move real funds, so treat access carefully. It reads GDEX_API_KEY at startup and authenticates automatically; the API base URL can be overridden with GDEX_API_URL. It runs over stdio from npm or Docker, and an init command writes the entry into the config for Claude, Cursor, VS Code, Codex or OpenCode, merging with existing settings and saving a .bak backup.

The documentation tools are embedded in the bundle, including hand-written explain_workflow guides, so an agent can look up how a workflow works before it trades. The website describes GDEX as a multi-chain trading terminal from Gemach DAO with copy trading, sniping and up to 50x leverage on perps; those are marketing claims, not guarantees.

Install

Run in a terminal

claude mcp add gdex-mcp-server --env GDEX_API_KEY='<GDEX_API_KEY>' -- npx -y @gemachdao/gdex-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gdex-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gemachdao/gdex-mcp-server"
      ],
      "env": {
        "GDEX_API_KEY": "<GDEX_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gdex-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gemachdao/gdex-mcp-server"
      ],
      "env": {
        "GDEX_API_KEY": "<GDEX_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "gdex-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gemachdao/gdex-mcp-server"
      ],
      "env": {
        "GDEX_API_KEY": "<GDEX_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gdex-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gemachdao/gdex-mcp-server"
      ],
      "env": {
        "GDEX_API_KEY": "<GDEX_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gdex-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gemachdao/gdex-mcp-server"
      ],
      "env": {
        "GDEX_API_KEY": "<GDEX_API_KEY>"
      }
    }
  }
}

Configuration

  • GDEX_API_KEYGDEX API key; the server auto-authenticates with it on startup
  • GDEX_API_URLOverride the GDEX API base URL (default: https://trade-api.gemach.io/v1)

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

buy_token
Buy a token with a spot swap.
sell_token
Sell a token with a spot swap.
limit_buy
Place a limit buy order.
limit_sell
Place a limit sell order.
open_perp_position
Open a Hyperliquid perpetual position.
place_perp_order
Place a perpetual order.
close_perp_position
Close a perpetual position.
get_perp_positions
Read open perpetual positions.
explain_workflow
Return a written guide for a GDEX workflow.

What it does

Spot trading
Buy, sell and place limit orders on Solana, Sui and ten EVM chains.
Hyperliquid perps
Open, order, close and read perpetual positions, including tokenized equities.
Copy trading
Mirror other wallets' trades through dedicated copy-trade tools.
Cross-chain bridging
Move assets between supported chains.
Embedded docs
Nine tools search and read GDEX skills and workflow guides.
Client init command
One command writes the config entry for several MCP clients.

Good for

  • Have an agent place a limit buy on a token while you watch
  • Read open perp positions and account state
  • Set up copy trading from a chat
  • Look up a GDEX workflow before running it

Pricing

Open source

MIT-licensed server; trading on GDEX itself may carry fees not published

Prices change. Check gdex.pro before you buy.

GDEX Trading FAQ

Does it need an API key?

The registry lists GDEX_API_KEY as optional configuration; the server authenticates with it on startup when set.

How many tools does it expose?

162: 153 for trading and account state plus 9 documentation tools.

Which clients can init set up?

Claude, Cursor, VS Code, Codex and OpenCode.

What licence is it under?

MIT.

Is GDEX Trading free?

Yes. GDEX Trading is open source, so you can use and self-host it for free.

How do I add GDEX Trading to Claude Code?

Run this command in your terminal: claude mcp add gdex-mcp-server --env GDEX_API_KEY='<GDEX_API_KEY>' -- npx -y @gemachdao/gdex-mcp-server

What are the best alternatives to GDEX Trading?

The closest alternatives to GDEX Trading are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to GDEX Trading

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government