Model Context Protocol (MCP) server implementation for the Paradex trading platform.
Quickstart
New here? See the Quickstart Guide for step-by-step setup instructions for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Claude.ai web, and ChatGPT.
MCP server for Paradex perp trading. Market data, accounts, orders, positions, and vaults.
API 키
PARADEX_ACCOUNT_PRIVATE_KEY, PARADEX_ENVIRONMENT
마지막 확인
2026-11-10
스타
—
도구
—
가동 시간
—
Need a remote HTTP endpoint for ChatGPT or Claude.ai web? See the HTTP Deployment Guide for Railway, Render, Fly.io, AWS Lambda, and Docker/VPS options.
Overview
This project provides a bridge between AI assistants (like Claude) and
Paradex, a privacy-preserving multi-asset exchange on Starknet with spot,
perpetuals, options, and commodity futures. Using the MCP standard,
AI assistants can:
macOS: Install via brew install uv so the binary lands in /usr/local/bin, which GUI apps like Claude Desktop can find. The curl-pipe install puts uv in ~/.local/bin, which GUI apps cannot see.
Installation
Quick Start
Cursor IDE
Click to automatically configure this MCP server in Cursor:
Claude Code CLI
claude mcp add paradex uvx mcp-paradex
Smithery (Claude Desktop)
npx -y @smithery/cli@latest mcp add @tradeparadex/mcp-paradex-py --client claude
Standard Installation
PyPI
pip install mcp-paradex
uvx (Recommended)
uvx mcp-paradex
Development Setup
Clone the repository:
git clone https://github.com/tradeparadex/mcp-paradex-py.git
cd mcp-paradex-py
Install development dependencies:
uv sync --dev --all-extras
Run locally:
uv run mcp-paradex
Configuration
Environment Variables
Set these environment variables for authentication:
PARADEX_ENVIRONMENT: Set to prod, testnet, or nightly (default: prod)
PARADEX_ACCOUNT_PRIVATE_KEY: Your Paradex account private key
Signer mode (no private key)
To trade through a signing proxy that holds the key, set these four and leave
PARADEX_ACCOUNT_PRIVATE_KEY unset:
PARADEX_SIGNER_HEADER: the header the server puts each message hash in, base64
PARADEX_SIGNER_SIGNATURE: the placeholder the server sends as the signature, for the proxy to replace
PARADEX_ACCOUNT_ADDRESS: your Paradex account address
PARADEX_ACCOUNT_PUBLIC_KEY: the public key of the key the proxy signs with
Every tool call returns a configuration error while any of the four is missing. If a private key is
also set, the server uses the signer and logs a warning. Block-trade tools are not available
in signer mode.
Outbound proxy
The server sends Paradex API requests through HTTPS_PROXY, HTTP_PROXY or ALL_PROXY
when set, skips the hosts listed in NO_PROXY, and trusts the CA bundle in SSL_CERT_FILE.
Using .env File
cp .env.template .env
# Edit .env with your credentials
# Build image
docker build . -t tradeparadex/mcp-paradex-py
# Run (public only)
docker run --rm -i tradeparadex/mcp-paradex-py
# Run with trading capabilities
docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=your_key -i tradeparadex/mcp-paradex-py
Docker (AWS Lambda / HTTP)
Use Dockerfile.aws for remote deployments via AWS Lambda with the
Lambda Web Adapter.
The adapter bridges Lambda invocations to the server's HTTP endpoint,
so no Lambda-specific code is needed.