# Paradex MCP Server

MCP server for Claude Code and other agents that exposes Paradex market data and trading operations. It runs over the HTTP endpoint https://mcp-paradex.run.tools and returns order books, candles, positions and balances.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 3556 installs · ★ 2 repo stars
- Author: tradeparadex
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tradeparadex/mcp-paradex-py
- Updated: 2026-10-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/paradex-mcp-server

## What it does

The agent gets Paradex tools: `paradex_markets`, `paradex_orderbook`, `paradex_klines`, `paradex_trades`, `paradex_bbo` for market data, and `paradex_vaults`, `paradex_vault_balance`, `paradex_vault_positions` for accounts and positions.

Trading actions require an account private key in `PARADEX_ACCOUNT_PRIVATE_KEY`. Without it the server serves public data only. There is also a signer mode where a proxy holds the key and the server passes message hashes: set `PARADEX_SIGNER_HEADER`, `PARADEX_SIGNER_SIGNATURE`, `PARADEX_ACCOUNT_ADDRESS` and `PARADEX_ACCOUNT_PUBLIC_KEY`. Any missing variable makes every tool call fail with a configuration error.

Run it with `uvx mcp-paradex` or `pip install mcp-paradex`. Python 3.10+ and uv are required. Docker supports a local stdio server or an HTTP build for AWS Lambda from `Dockerfile.aws`, listening on `http://localhost:8080/mcp`. `PARADEX_ENVIRONMENT` takes `prod`, `testnet` or `nightly`; the default is `prod`.

## Requirements
- Remote server: `https://mcp-paradex.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-paradex-py https://mcp-paradex.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add paradex-mcp-server --url https://mcp-paradex.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "paradex-mcp-server": {
            "url": "https://mcp-paradex.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "paradex-mcp-server": {
            "type": "http",
            "url": "https://mcp-paradex.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http paradex-mcp-server https://mcp-paradex.run.tools
```

## When to use it
- fetch the order book and best bid/offer for a market
- load historical candles and funding rate data
- check vault balances and positions
- place an order from the agent with a private key
- connect Paradex to an agent without writing an API client

## Example prompts
- Show the order book for `ETH-USD-PERP` and the best bid/offer
- Load daily candles for the last 30 days for `BTC-USD-PERP`
- List positions and balance for vault `12345`

## Similar
- [crypto-quant-signal-mcp](https://affpapa.org/en/nevibecode/mcp/crypto-quant-signal-mcp.md) — MCP server · 2046 installs
- [tradingcalc-mcp](https://affpapa.org/en/nevibecode/mcp/tradingcalc-mcp.md) — MCP server · 4511 installs
- [VARRD — Statistically Validated Trading Edges + AI Research Engine](https://affpapa.org/en/nevibecode/mcp/varrd-statistically-validated-trading-edges-ai-research-engine.md) — MCP server · ★ 25 repo stars
- [Crypto.com](https://affpapa.org/en/nevibecode/mcp/cryptocom.md) — MCP server · 191 installs
- [blackforge](https://affpapa.org/en/nevibecode/skills/blackforge.md) — skill · 11500 installs
- [cot-contrarian-detector](https://affpapa.org/en/nevibecode/skills/cot-contrarian-detector.md) — skill · 2900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
