Paradex MCP Server — Claude Code MCP server: market data and trading
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.
MIT 3,556 installs ★ 2 updated 2026-10-14
claude mcp add --transport http mcp-paradex-py https://mcp-paradex.run.toolsWhat Paradex MCP Server 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.
What it helps with
- 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 for the agent
- Show the order book for
ETH-USD-PERPand the best bid/offer - Load daily candles for the last 30 days for
BTC-USD-PERP - List positions and balance for vault
12345
How to install Paradex MCP Server
Platform CLI: remote server
claude mcp add --transport http mcp-paradex-py https://mcp-paradex.run.toolsPlatform CLI: remote server
codex mcp add paradex-mcp-server --url https://mcp-paradex.run.toolsConfig file
{
"mcpServers": {
"paradex-mcp-server": {
"url": "https://mcp-paradex.run.tools"
}
}
}Config file
{
"servers": {
"paradex-mcp-server": {
"type": "http",
"url": "https://mcp-paradex.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http paradex-mcp-server https://mcp-paradex.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Paradex MCP Server
How do I install Paradex MCP Server in Claude Code?
Run claude mcp add --transport http mcp-paradex-py https://mcp-paradex.run.tools. The server will appear in Claude Code's MCP list.
What does Paradex MCP Server do?
It links an AI agent to the Paradex exchange: returns market data such as order books, candles, trades and funding rates, and with a private key can manage accounts, vaults and positions.
Do I need a private key?
No. Without PARADEX_ACCOUNT_PRIVATE_KEY the server only serves public data. Trading requires the key, or use signer mode through a proxy that holds it.