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+

To install mcp-paradex-py for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @sv/mcp-paradex-py --client claude

1. Clone this repository:

   git clone https://github.com/sv/mcp-paradex-py.git
   cd mcp-paradex-py

2. Create a virtual environment:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies:

   uv pip install -e .

Set up your configuration:

cp .env.template .env

Then edit the .env file with your Paradex credentials.

docker build . -t sv/mcp-paradex-py

Public only

docker run --rm -i sv/mcp-paradex-py

Allow trading

docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=0xprivatekey -i sv/mcp-paradex-py

This MCP server is compatible with Smithery.ai, a platform for discovering and deploying MCP servers.

To use this server with Claude Desktop via Smithery.ai:

1. Open Claude Desktop and enable Developer Mode from the menu
2. Go to Settings > Developer and click "Edit Config"
3. Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["--with-editable", ".", "mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

4. Replace your_ethereum_private_key with your actual Paradex private key
5. Save the file and restart Claude Desktop

The server includes a smithery.yaml file with metadata for the Smithery.ai registry. If you want to publish this server to Smithery.ai, you can use the Smithery CLI:

# Install Smithery CLI
npm install -g @smithery/cli

# Login to Smithery
smithery login

# Publish the server
smithery publish

For more information about publishing to Smithery.ai, see the Smithery documentation.

• paradex://system/config - Get Paradex system configuration and basic information about the exchange
• paradex://system/time - Get current system time in milliseconds since epoch
• paradex://system/state - Get the current Paradex system operational state

• paradex://markets - Get a list of available markets from Paradex
• paradex://market/summary/{market_id} - Get detailed market information for a specific trading pair

• paradex://vaults - List all vaults available on Paradex
• paradex://vaults/config - Get global configuration for vaults
• paradex://vaults/balance/{vault_id} - Get the balance of a specific vault
• paradex://vaults/summary/{vault_id} - Get comprehensive summary of a vault
• paradex://vaults/transfers/{vault_id} - Get deposit and withdrawal history for a vault
• paradex://vaults/positions/{vault_id} - Get current trading positions for a vault
• paradex://vaults/account-summary/{vault_id} - Get trading account information for a vault

• paradex_system_config - Get global Paradex system configuration
• paradex_system_state - Get current system state

• paradex_markets - Get detailed information about markets, including base/quote assets, tick size, and other trading parameters
• paradex_market_summaries - Get summaries with price, volume, 24h change, and other key market metrics
• paradex_funding_data - Get historical funding rate data for perpetual markets
• paradex_orderbook - Get the current orderbook for a market with customizable depth
• paradex_klines - Get historical candlestick (OHLCV) data for a market
• paradex_trades - Get recent trades for a market with price, size, and timestamp information
• paradex_bbo - Get best bid and offer (tightest spread) for a market

• paradex_account_summary - Get account summary information
• paradex_account_positions - Get current account positions
• paradex_account_fills - Get account trade fills
• paradex_account_funding_payments - Get account funding payments
• paradex_account_transactions - Get account transaction history

• paradex_open_orders - Get all open orders for an account
• paradex_create_order - Create a new order on Paradex
• paradex_cancel_orders - Cancel existing orders
• paradex_order_status - Get the status of an order
• paradex_orders_history - Get historical orders for an account

• paradex_vaults - Get detailed information about specific vaults or all vaults with filtering options
• paradex_vaults_config - Get global configuration for vaults including fees, limits, and other settings
• paradex_vault_balance - Get the current balance of a vault with available/locked funds information
• paradex_vault_summary - Get comprehensive summary of vault performance, balance, and activity
• paradex_vault_transfers - Get deposit and withdrawal history for a vault
• paradex_vault_positions - Get current trading positions for a vault with market, size, entry price details
• paradex_vault_account_summary - Get trading account information for a vault including margin and risk metrics

This MCP server provides structured prompts that AI assistants can use to perform complex trading analysis and generate trading strategies.

• market_overview - Get comprehensive overview of the crypto market, including top gainers/losers, high-volume markets, funding rate anomalies, and market microstructure analysis
• market_analysis - Detailed technical and microstructure analysis of a specific market, with support/resistance levels, chart patterns, orderbook analysis, and position recommendations

• position_management - Comprehensive analysis of existing positions, including portfolio heat, correlation, risk metrics, and specific recommendations for profit-taking and loss management
• create_optimal_order - Design optimal order parameters for a market based on volatility, liquidity, risk tolerance, and ideal entry strategy
• hedging_strategy - Develop effective hedging strategies for specific positions using correlation analysis, hedge ratio calculation, and implementation planning
• portfolio_risk_assessment - Thorough risk analysis of trading portfolio, including exposure analysis, correlation assessment, VaR calculations, and risk reduction recommendations
• liquidation_protection - Identify and mitigate liquidation risks for open positions with severity classification and protection strategies

• vault_analysis - Comprehensive analysis of vaults for investment decision-making, with performance metrics, risk profiles, and suitability assessment
• funding_rate_opportunity - Identify and evaluate funding rate arbitrage opportunities across markets, including yield calculations and implementation strategies
• trading_consultation - Interactive prompt sequence for personalized trading advice and consultation

We have seen significantly better results with giving client access to Paradex documentation

"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.

MIT License