mcp-paradex-py
Connect AI agents to the Paradex trading platform. Retrieve market data, manage accounts, and execute trades seamlessly. Enhance your trading experience...
Up to date supported version can be found here https://github.com/tradeparadex/mcp-paradex-py
Model Context Protocol (MCP) server implementation for the Paradex trading platform.
This project provides a bridge between AI assistants (like Claude) and the Paradex perpetual futures trading platform. Using the MCP standard, AI assistants can:
- Retrieve market data from Paradex
- Manage trading accounts and vaults
- Place and manage orders
- Monitor positions and balance
- Python 3.10+
Click to automatically configure this MCP server in Cursor:
claude mcp add paradex uvx mcp-paradex
npx -y @smithery/cli install @sv/mcp-paradex-py --client claude
pip install mcp-paradex
uvx mcp-paradex
-
Clone the repository:
git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py -
Install development dependencies:
uv sync --dev --all-extras
-
Run locally:
uv run mcp-paradex
Set these environment variables for authentication:
PARADEX_ENVIRONMENT: Set toprod,testnet, ornightly(default:prod)PARADEX_ACCOUNT_PRIVATE_KEY: Your Paradex account private key
cp .env.template .env
# Edit .env with your credentialsAdd to your claude_desktop_config.json:
{
"mcpServers": {
"paradex": {
"command": "uvx",
"args": ["mcp-paradex"],
"env": {
"PARADEX_ENVIRONMENT": "testnet",
"PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
}
}
}
}# Build image docker build . -t sv/mcp-paradex-py # Run (public only) docker run --rm -i sv/mcp-paradex-py # Run with trading capabilities docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=your_key -i sv/mcp-paradex-py
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.
# Build docker build -f Dockerfile.aws -t sv/mcp-paradex-py-aws . # Test locally (mirrors Lambda config) docker run --rm -p 8080:8080 \ -e MCP_TRANSPORT=streamable-http \ -e MCP_STATELESS=true \ -e MCP_PORT=8080 \ -e PARADEX_ENVIRONMENT=prod \ sv/mcp-paradex-py-aws
The server will be available at http://localhost:8080/mcp.
Deploying to Lambda:
- Push the image to ECR
- Create a Lambda function from the container image
- Set the Lambda Function URL invoke mode to
RESPONSE_STREAM - Set environment variables on the Lambda function:
MCP_TRANSPORT=streamable-httpMCP_STATELESS=truePARADEX_ENVIRONMENT=prod(ortestnet)PARADEX_ACCOUNT_PRIVATE_KEY=your_key(optional, for trading)
paradex://system/config- Get Paradex system configurationparadex://system/time- Get current system timeparadex://system/state- Get system operational state
paradex://markets- List of available marketsparadex://market/summary/{market_id}- Detailed market information
paradex://vaults- List all vaultsparadex://vaults/config- Global vault configurationparadex://vaults/balance/{vault_id}- Vault balanceparadex://vaults/summary/{vault_id}- Comprehensive vault summaryparadex://vaults/transfers/{vault_id}- Deposit/withdrawal historyparadex://vaults/positions/{vault_id}- Current trading positionsparadex://vaults/account-summary/{vault_id}- Trading account information
paradex_system_config- Get global system configurationparadex_system_state- Get current system state
paradex_markets- Get detailed market informationparadex_market_summaries- Get market summaries with metricsparadex_funding_data- Get historical funding rate dataparadex_orderbook- Get current orderbook with customizable depthparadex_klines- Get historical candlestick dataparadex_trades- Get recent tradesparadex_bbo- Get best bid and offer
paradex_account_summary- Get account summaryparadex_account_positions- Get current positionsparadex_account_fills- Get trade fillsparadex_account_funding_payments- Get funding paymentsparadex_account_transactions- Get transaction history
paradex_open_orders- Get all open ordersparadex_create_order- Create new orderparadex_cancel_orders- Cancel existing ordersparadex_order_status- Get order statusparadex_orders_history- Get historical orders
paradex_vaults- Get detailed vault informationparadex_vaults_config- Get global vault configurationparadex_vault_balance- Get vault balanceparadex_vault_summary- Get comprehensive vault summaryparadex_vault_transfers- Get deposit/withdrawal historyparadex_vault_positions- Get current vault positionsparadex_vault_account_summary- Get vault trading account info
market_overview- Comprehensive crypto market overviewmarket_analysis- Detailed technical and microstructure analysis
position_management- Comprehensive position analysiscreate_optimal_order- Design optimal order parametershedging_strategy- Develop effective hedging strategiesportfolio_risk_assessment- Thorough portfolio risk analysisliquidation_protection- Identify and mitigate liquidation risks
vault_analysis- Comprehensive vault analysis for investment decisionsfunding_rate_opportunity- Identify funding rate arbitrage opportunitiestrading_consultation- Interactive trading advice and consultation
Enhanced results with Paradex documentation access:
"paradex-docs-mcp": { "command": "uvx", "args": [ "--from", "mcpdoc", "mcpdoc", "--urls", "Paradex:https://docs.paradex.trade/llms.txt", "--transport", "stdio" ] }
Please see CONTRIBUTING.md for information on how to contribute to this project, development setup, and our coding standards.
Features
Rate this server
Related MCP servers
- mcp-wikidataA server implementation for Wikidata API using the Model Context Protocol (MCP).
- mcp-teradataMCP Server for Teradata database
- mcp-soccer-dataAn MCP server that provides real-time football data based on the SoccerDataAPI.
- redis-mcp-serverA Redis MCP server (pushed to https://github.com/modelcontextprotocol/servers/tree/main/src/redis) implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.
- mcp-hubspotA Model Context Protocol (MCP) server that enables AI assistants to interact with HubSpot CRM data, providing built-in vector storage and caching mechanisms help overcome HubSpot API limitations while improving response times.
- mcp-dblpA Model Context Protocol (MCP) server that provides access to the DBLP computer science bibliography database for Large Language Models.