dYdX Agent Gateway MCP server

dYdX Agent Gateway

<!-- mcp-name: io.github.alekskram/dydx-agent-gateway -->

One MCP server that gives any AI agent analytics access to dYdX v4: market data, funding analytics, verified trader PnL, leaderboards, anomaly detection. Read-only and keyless — the gateway holds no keys and cannot move funds.

Use cases

drawdown in USD, and phantom-PnL detection that flags unreliable equity curves

• Verify a trader before you copy them — deposit-adjusted PnL, day winrate,

context, OI-spike-without-price detectors, liquidation-cascade alerts

• Hunt funding and OI anomalies — funding heatmap ranked by |rate| with OI

discovery, farmer-bot flags so you don't copy a rewards farmer

• Find real smart money — verified leaderboard from on-chain trader

events + funding extremes + leaderboard top

• Check the book before entering — one-call market digest: latest anomaly

breakeven/trailing plan per side

• Plan the exit while you plan the entry — ATR-based stop/take-profit/

Full walkthroughs with real outputs: examples/use-cases.md.

Install

Claude Code:

claude mcp add dydx -- uvx dydx-agent-gateway

Claude Desktop / Cursor / any mcp.json:

{"mcpServers": {"dydx": {
  "command": "uvx",
  "args": ["dydx-agent-gateway"]}}}

Codex (~/.codex/config.toml)

[mcp_servers.dydx]
command = "uvx"
args = ["dydx-agent-gateway"]

ZCode — register the server and copy the agent skill (copy-paste)

# 1) start the gateway (keep it running)
uvx dydx-agent-gateway --http --port 8901 &

# 2) register it (merges into ~/.zcode/cli/config.json; workspace .zcode/config.json works too)
python3 - <<'PY'
import json, os
p = os.path.expanduser("~/.zcode/cli/config.json")
os.makedirs(os.path.dirname(p), exist_ok=True)
cfg = json.load(open(p)) if os.path.exists(p) else {}
cfg.setdefault("mcp", {}).setdefault("servers", {})["dydx"] = {
    "type": "http", "url": "http://127.0.0.1:8901/mcp"}
json.dump(cfg, open(p, "w"), indent=2)
print("dydx MCP server registered:", p)
PY

# 3) copy the agent skill (tool guide + data gotchas)
git clone -q --depth 1 https://github.com/alekskram/dydx-agent-gateway /tmp/dag
cp -r /tmp/dag/.agents/skills/dydx-gateway ~/.zcode/skills/ && rm -rf /tmp/dag
echo "ZCode setup done — restart your session and call any dydx tool"

Plain Python:

pip install dydx-agent-gateway
python -c "from dydx_mcp import server; import json; print(json.dumps(server.market_digest(), default=str)[:400])"

Hosted (streamable HTTP): dydx-agent-gateway --http --port 8901, then any client:

{"mcpServers": {"dydx": {"type": "http", "url": "http://host:8901/mcp"}}}

Requires Python ≥ 3.11. Deps (fastmcp, pycryptodome, ecdsa) install automatically. See examples/ for ready-made configs and a working autonomous agent script.

Tools (22 — read-only, keyless)

Shortened. The full README is on GitHub.