MCP Paradex Server

by sv
MIT License
3
  • Linux
  • Apple

Integrations

  • Integrates with the Ethereum blockchain through the Paradex perpetual futures trading platform, requiring Ethereum private keys for authentication and trading functionality

MCP Paradex Server

Model Context Protocol (MCP) server implementation for the Paradex trading platform.

Overview

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

Prerequisites

  • Python 3.10+

Installation

Installing via Smithery

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

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

Using uv (faster alternative)

  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 .

Configuration

Set up your configuration:

cp .env.template .env

Then edit the .env file with your Paradex credentials.

Running the Server

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

In Cursor add MCP as command

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

Smithery.ai Integration

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

Claude Desktop Configuration

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" } } } }
  1. Replace your_ethereum_private_key with your actual Paradex private key
  2. Save the file and restart Claude Desktop

Smithery.ai Registry

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.

Available Resources and Tools

Resources

System Resources
  • 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
Market Resources
  • paradex://markets - Get a list of available markets from Paradex
  • paradex://market/summary/{market_id} - Get detailed market information for a specific trading pair
Vault Resources
  • 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

Tools

System Tools
  • paradex_system_config - Get global Paradex system configuration
  • paradex_system_state - Get current system state
Market Tools
  • 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
Account Tools
  • 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
Order Tools
  • 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
Vault Tools
  • 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

Trading Analysis Prompts

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

Market Analysis

  • 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 and Portfolio Management

  • 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

Investment 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

Documentation MCP

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" ] }

Contributing

Please see CONTRIBUTING.md for information on how to contribute to this project, development setup, and our coding standards.

License

MIT License

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server implementation that enables AI assistants to interact with the Paradex perpetual futures trading platform, allowing for retrieving market data, managing trading accounts, placing orders, and monitoring positions.

  1. Overview
    1. Prerequisites
      1. Installation
        1. Installing via Smithery
        2. Using uv (faster alternative)
        3. Configuration
      2. Running the Server
        1. Docker (recommended)
        2. In Cursor add MCP as command
      3. Smithery.ai Integration
        1. Claude Desktop Configuration
        2. Smithery.ai Registry
      4. Available Resources and Tools
        1. Resources
        2. Tools
      5. Trading Analysis Prompts
        1. Market Analysis
        2. Position and Portfolio Management
        3. Investment Strategies
      6. Documentation MCP
        1. Contributing
          1. License

            Related MCP Servers

            • A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that enables AI assistants to interact with the Deriv trading API, providing access to active trading symbols and account balance information.
              Last updated -
              2
              Python
              • Apple
            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.
              Last updated -
              JavaScript
              • Linux
              • Apple
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables AI agents to interact with Brex financial platform data, allowing retrieval of account information, expenses, budgets, and team data through standardized resource handlers.
              Last updated -
              2
              TypeScript
              MIT License
              • Apple
            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
              Last updated -
              1
              TypeScript

            View all related MCP servers

            ID: cq4bz5ljqj