# GDEX Trading

> GDEX Trading is an open-source MCP server for finance and payments. Let an agent trade spot and perpetuals across Solana, EVM chains and Hyperliquid. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://gdex.pro
- **Repository:** https://github.com/gemachdao/gdex-skill/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.GemachDAO/gdex-mcp-server
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/gdex-trading
