GDEX Trading

GDEX MCP Server

The official Model Context Protocol server for GDEX, Gemach DAO's multi-chain trading terminal. It gives AI agents 154 tools: 145 that execute trades and read account state, plus 9 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, usdc
src/knowledge.ts	Documentation tools: search and read the GDEX skills, which build:mcp embeds in dist/index.js (the npm package and Docker image ship no skills/ directory)
src/workflowGuides.ts	Hand-written explain_workflow guides (type-checked against the SDK by tests/docs/docExamples.test.ts)
src/init.ts	init --client <name> [--force]: merges the GDEX entry into the MCP config for Claude, Cursor, VS Code, Codex, OpenCode (JSONC helpers in src/jsonc.ts, TOML in src/tomlLite.ts)
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:

npx -y @gemachdao/gdex-mcp-server

From source (repo root):

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

With Docker, from source (repo root):

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

Write a client config automatically:

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

An existing config file is merged, not overwritten: other servers and settings stay, comments in VS Code's JSONC and Codex's TOML are kept, the previous file is saved as <file>.bak, and the write is atomic. Rerunning is a no-op. If a different gdex-mcp-server entry already exists, init prints the current and new entry and exits non-zero; pass --force to replace it. A file that doesn't parse is left untouched and init exits non-zero.

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

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

License

MIT © GemachDAO. See LICENSE.