GDEX Trading

Official

by GemachDAO · TypeScript

GDEX (gdex.pro) trading for AI agents: spot, perps and HyperLiquid on Solana, EVM and more chains

io.github.GemachDAO/gdex-mcp-server (MCP)

The MCP server described by io.github.GemachDAO/gdex-mcp-server provides GDEX trading access for AI agents. It supports multiple trading types, including spot and perps, and targets HyperLiquid. The scope includes Solana plus EVM and other chains, as indicated by the server description.

🛠️ Key Features

GDEX (gdex.pro) trading for AI agents
Spot trading support
Perps trading support
HyperLiquid integration
Targets Solana, EVM, and more chains

🚀 Use Cases

Enable AI agents to trade via GDEX
Execute spot and perps trades on HyperLiquid
Operate across Solana and EVM environments

⚡ Developer Benefits

Clear coverage of spot and perps trading workflows
Multi-chain applicability (Solana, EVM, and more)

⚠️ Limitations

No further capabilities (e.g., tool list, configuration details, or constraints) are provided in the available source data

Topics

agent-skillsai-agentsclaude-codecryptodefigemachhyperliquidmcpmcp-servermodel-context-protocolsolanatradingtypescriptgdexclaude-code-plugingemini-cli-extension

mcp-server/README.md2 KBView on GitHub

GDEX MCP Server

The official Model Context Protocol server for GDEX, Gemach DAO's multi-chain trading terminal. It gives AI agents 117 tools: 109 that execute trades and read account state, plus 8 documentation tools.

Spot swaps on Solana, Sui and 10 EVM chains (buy_token, sell_token, limit_buy, limit_sell)
Hyperliquid perpetuals, including tokenized equities, FX and commodities (open_perp_position, place_perp_order, close_perp_position, get_perp_positions)
Copy trading, cross-chain bridging, portfolio and token discovery

The server is implemented in this directory. The npm package @gemachdao/gdex-mcp-server is built from it, and it is listed in the official MCP Registry as io.github.GemachDAO/gdex-mcp-server.

Source layout

Path	What it is
`src/index.ts`	Entry point: creates the `McpServer`, registers every tool, serves over stdio
`src/tools/`	Tool handlers by area: `spotTrade`, `perpTrade`, `perpRead`, `limitOrders`, `copyTrade`, `hlCopyTrade`, `bridge`, `portfolio`, `managed`, `directExec`, `auth`, `v110`
`src/knowledge.ts`	Documentation tools: search and read the bundled GDEX skills
`src/init.ts`	`init --client <name>`: writes MCP config for Claude, Cursor, VS Code, Codex, OpenCode
`src/sdk.ts`	Shared GDEX SDK client (the SDK lives in `../src`)
`tests/`	Jest tests
`dist/index.js`	Prebuilt single-file bundle (`npm run build:mcp` from the repo root)

Run

From npm:

bash

npx -y @gemachdao/gdex-mcp-server

From source (repo root):

bash

npm ci
npm run build:mcp
node mcp-server/dist/index.js

With Docker, from source (repo root):

bash

docker build -t gdex-mcp-server .
docker run -i --rm gdex-mcp-server

Write a client config automatically:

bash

npx @gemachdao/gdex-mcp-server init --client claude   # or cursor, vscode, codex, opencode

Configuration

Variable	Description	Required
`GDEX_API_KEY`	GDEX API key; the server authenticates with it on startup	Optional
`GDEX_API_URL`	Override the API base URL (default `https://trade-api.gemach.io/v1`)	Optional

Develop

bash

cd mcp-server
npm ci
npx tsc --noEmit
npm test

License

Install

Configuration

Environment variables

GDEX_API_KEYsecret

GDEX API key; the server auto-authenticates with it on startup

GDEX_API_URL

Override the GDEX API base URL (default: https://trade-api.gemach.io/v1)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

io.github.GemachDAO/gdex-mcp-server (MCP)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

GDEX MCP Server

Source layout

Run

Configuration

Develop

License

Install

Configuration

Related servers