GDEX Trading
Let an agent trade spot and perpetuals across Solana, EVM chains and Hyperliquid
- 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-serverAdd 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 startupGDEX_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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government