Finance Toolkit
500+ transparent financial methods calculated from raw statements, not third-party endpoints.
Description from the maker (original English)
GDEX (gdex.pro) trading for AI agents: spot, perps and HyperLiquid on Solana, EVM and more chains
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
GDEX_API_KEY, GDEX_API_URLValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"gdex": {
"command": "npx",
"args": [
"-y",
"@gemachdao/gdex-mcp-server"
],
"env": {
"GDEX_API_KEY": "your-value",
"GDEX_API_URL": "your-value"
}
}
}
}Run this in your terminal
claude mcp add gdex --env GDEX_API_KEY=your-value --env GDEX_API_URL=your-value -- npx -y @gemachdao/gdex-mcp-serverFill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"gdex": {
"command": "npx",
"args": [
"-y",
"@gemachdao/gdex-mcp-server"
],
"env": {
"GDEX_API_KEY": "your-value",
"GDEX_API_URL": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"gdex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gemachdao/gdex-mcp-server"
],
"env": {
"GDEX_API_KEY": "your-value",
"GDEX_API_URL": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.
Your choice stays on this device in a cookie; no account needed.
GDEX_API_URL envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026
The registry name was verified with the GitHub account GemachDAO, which owns the repo
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: GDEX_API_KEY
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed –, and the latest version (5.4.1) reached the registry yesterday.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: Finance Toolkit, SolidInvoice, Korea Tax Calculator
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
500+ transparent financial methods calculated from raw statements, not third-party endpoints.
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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 [--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-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 .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 test
MIT © GemachDAO. See LICENSE.