
The official Model Context Protocol server for GDEX, Gemach DAO's multi-chain trading terminal. It
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.
·
The official Model Context Protocol server for GDEX, Gemach DAO's multi-chain trading terminal. It gives AI agents 162 tools: 153 that execute trades and read account state, plus 9 documentation tools.
buy_token, sell_token, limit_buy, limit_sell)open_perp_position, place_perp_order, close_perp_position, get_perp_positions)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.
| 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) |
From npm:
npx -y @gemachdao/gdex-mcp-serverFrom source (repo root):
npm ci
npm run build:mcp
node mcp-server/dist/index.jsWith Docker, from source (repo root):
docker build -t gdex-mcp-server .
docker run -i --rm gdex-mcp-serverWrite a client config automatically:
npx @gemachdao/gdex-mcp-server init --client claude # or cursor, vscode, codex, opencodeAn 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.
| 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 |
cd mcp-server
npm ci
npx tsc --noEmit
npm testMIT © GemachDAO. See LICENSE.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/gdex-mcp-server to learn what the "GDEX MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y @gemachdao/gdex-mcp-server
npx @gemachdao/gdex-mcp-server init --client claude # or cursor, vscode, codex, opencode
npx tsc --noEmitdocker run -i --rm gdex-mcp-server| Name | What it does |
|---|---|
search_gdex_docs | Search GDEX documentation and skill files by keyword. Returns matching skill sections. |
get_sdk_pattern | Get TypeScript code patterns for common GDEX SDK operations. Returns working code examples. |
get_api_info | Get GDEX API endpoint details — URL, method, parameters, and response format. |
explain_workflow | Explain an end-to-end GDEX trading workflow with step-by-step instructions and code. |
get_chain_info | Get supported chains, chain IDs, DEXes, and capabilities. |
get_trading_guide | Get a complete trading guide for spot, perp, or limit order trading. |
get_copy_trade_guide | Get a copy trading guide for Solana spot or HyperLiquid perp copy trading. |
get_component_guide | Get React UI component patterns for GDEX trading interfaces. |
auth_login | Authenticate with a GDEX API key. Sets the Bearer token for all subsequent requests. |
generate_session_keypair | Generate a secp256k1 session keypair for managed-custody trade signing. Returns sessionPrivateKey and sessionKey (compressed public key). |
managed_sign_in | Sign in to GDEX managed-custody system using encrypted computedData payload. |
build_sign_in_payload | Build the encrypted sign-in computedData payload from raw credentials. Returns the payload to use with managed_sign_in. |
buy_token | Buy a token on any supported chain (Solana, Sui, Ethereum, Base, Arbitrum, BSC, etc.) using the best DEX route. |
sell_token | Sell a token on any supported chain. Amount can be absolute ('100') or percentage ('50%'). |
open_perp_position | Open a perpetual futures position on HyperLiquid with leverage, TP/SL. Supports market and limit orders. |
place_perp_order | Place a simple perp order on HyperLiquid without TP/SL. |
close_perp_position | Close a specific perp position using a reduce-only market order. |
close_all_positions | Close all open perpetual positions on HyperLiquid. Note: may be unreliable — prefer closing per-coin. |
cancel_perp_order | Cancel a specific open perp order on HyperLiquid. |
cancel_all_perp_orders | Cancel all open perp orders on HyperLiquid. |
set_leverage | Set leverage for a specific asset on HyperLiquid. Supports cross and isolated margin modes. |
perp_deposit | Deposit USDC into the HyperLiquid perpetual account from Arbitrum. |
perp_withdraw | Withdraw USDC from the HyperLiquid perpetual account. |
get_account_state | Get full HyperLiquid account state: positions, margin, balance, withdrawable amount. No auth required. |
get_perp_positions | Get all open perpetual positions for a wallet on HyperLiquid. No auth required. |
get_mark_price | Get the current mark price for a HyperLiquid asset. No auth required. |
get_all_mid_prices | Get all current mid prices across all HyperLiquid assets. No auth required. |
get_usdc_balance | Get USDC balance on HyperLiquid for a wallet. No auth required. |
get_hl_open_orders | Get all open orders on HyperLiquid for a wallet. No auth required. |
get_hl_trade_history | Get trade history on HyperLiquid for a wallet. No auth required. |
get_hl_spot_state | Get HyperLiquid spot trading state for a wallet. No auth required. |
get_trader_leverage | Get the active leverage setting a trader uses for a specific coin on HyperLiquid. |
execute_cross_perp | Execute a cross-margin perpetual trade directly with a private key (no managed custody). Supports TP/SL and builder fees. |
execute_isolated_perp | Execute an isolated-margin perpetual trade directly with a private key. Requires explicit leverage. |
execute_spot | Execute a spot trade directly on HyperLiquid with a private key. |
direct_cancel_order | Cancel an open order directly with a private key on HyperLiquid. |
limit_buy | Create a limit buy order — buy a token when price drops to target. Uses ABI-encoded + AES-encrypted computedData. |
limit_sell | Create a limit sell order — sell a token when price reaches target. Auto-classifies as TP or SL. |
update_order | Update or delete an existing limit order. Set isDelete=true to cancel. |
get_limit_orders | List active limit orders for a user on a specific chain. Requires session-key auth. |
get_copy_trade_wallets | Get top 300 wallets ranked by totalPnl for Solana spot copy trade leaderboard. No auth. Cached 2 min. |
get_copy_trade_custom_wallets | Get top 300 wallets ranked by net received. No auth. Cached 2 min. |
get_copy_trade_gems | Get hot new tokens heavily traded by top wallets. No auth. Cached 20s. |
get_copy_trade_dexes | List supported DEXes for a chain (e.g. Raydium, Pumpfun on Solana). No auth. |
get_copy_trade_list | List all copy trade configurations for a user. Requires session-key auth. |
get_copy_trade_tx_list | List copy trade transaction history with PnL. Requires session-key auth. |
create_copy_trade | Create a new copy trade to auto-mirror a Solana trader's buys/sells. Solana only. |
update_copy_trade | Update or delete a Solana copy trade. WARNING: Both isDelete and isChangeStatus permanently delete. |
get_hl_top_traders | Get top HyperLiquid perp traders by volume, trade count, or deposit. No auth. Cached 15 min. |
get_hl_top_traders_by_pnl | Get top 30 HyperLiquid perp traders ranked by PnL. Data by day/week/month. No auth. Cached 15 min. |
Read live from the server on October 8, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/gdex-mcp-server)Nothing comparable is listed yet.
v5.4.1Release notesv5.4.0Release notesv5.3.0Release notesv5.2.1Release notesv5.2.0Release notesv5.1.0Release notesv5.0.0Release notesv4.12.0Release notesv4.11.4Release notesv4.11.3Release notesv4.11.2Release notesv4.11.1Release notesv4.11.0v4.11.0 — anomaly events in the contract column shapeRelease notesv4.10.0v4.10.0 — risk & market data skills, anomaly events, harnessRelease notesv4.9.0v4.9.0 — MCP agent-ergonomicsRelease notesv4.7.0v4.7.0 — Managed-custody EVM swapsRelease notesv4.6.0v4.6.0 — Builder-dex position readsRelease notesv4.5.0Release notesv4.4.0Release notesv4.3.1Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "gdex-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.