Paradex MCP server for AI agents

This MCP server provides a bridge between AI assistants and the Paradex perpetual futures trading platform, enabling assistants to retrieve market data, manage trading accounts, place orders, and monitor positions through the Model Context Protocol (MCP) standard.

Installation Options

Quick Installation Methods

Using uvx (Recommended)

uvx mcp-paradex

Using PyPI

pip install mcp-paradex

Using Smithery (for Claude Desktop)

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

Using Claude Code CLI

claude mcp add paradex uvx mcp-paradex

Docker Installation

# Run with public access 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

Configuration

Essential Environment Variables

To authenticate and use the server, you need to set these environment variables:

PARADEX_ENVIRONMENT: Set to testnet or mainnet
PARADEX_ACCOUNT_PRIVATE_KEY: Your Paradex account private key

Setting Up with a .env File

cp .env.template .env
# Edit .env with your credentials

Claude Desktop Configuration

Add to your claude_desktop_config.json:

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

Available Resources

System Resources

paradex://system/config - Get Paradex system configuration
paradex://system/time - Get current system time
paradex://system/state - Get system operational state

Market Resources

paradex://markets - List of available markets
paradex://market/summary/{market_id} - Detailed market information

Vault Resources

paradex://vaults - List all vaults
paradex://vaults/config - Global vault configuration
paradex://vaults/balance/{vault_id} - Vault balance
paradex://vaults/summary/{vault_id} - Comprehensive vault summary
paradex://vaults/transfers/{vault_id} - Deposit/withdrawal history
paradex://vaults/positions/{vault_id} - Current trading positions
paradex://vaults/account-summary/{vault_id} - Trading account information

Available Tools

System Tools

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

Market Tools

paradex_markets - Get detailed market information
paradex_market_summaries - Get market summaries with metrics
paradex_funding_data - Get historical funding rate data
paradex_orderbook - Get current orderbook with customizable depth
paradex_klines - Get historical candlestick data
paradex_trades - Get recent trades
paradex_bbo - Get best bid and offer

Account Tools

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

Order Tools

paradex_open_orders - Get all open orders
paradex_create_order - Create new order
paradex_cancel_orders - Cancel existing orders
paradex_order_status - Get order status
paradex_orders_history - Get historical orders

Vault Tools

paradex_vaults - Get detailed vault information
paradex_vaults_config - Get global vault configuration
paradex_vault_balance - Get vault balance
paradex_vault_summary - Get comprehensive vault summary
paradex_vault_transfers - Get deposit/withdrawal history
paradex_vault_positions - Get current vault positions
paradex_vault_account_summary - Get vault trading account info

Trading Analysis Capabilities

Market Analysis

market_overview - Comprehensive crypto market overview
market_analysis - Detailed technical and microstructure analysis

Position and Portfolio Management

position_management - Comprehensive position analysis
create_optimal_order - Design optimal order parameters
hedging_strategy - Develop effective hedging strategies
portfolio_risk_assessment - Thorough portfolio risk analysis
liquidation_protection - Identify and mitigate liquidation risks

Investment Strategies

vault_analysis - Comprehensive vault analysis for investment decisions
funding_rate_opportunity - Identify funding rate arbitrage opportunities
trading_consultation - Interactive trading advice and consultation

Enhanced Documentation Access

Add Paradex documentation access with this configuration:

"paradex-docs-mcp": {
   "command": "uvx",
   "args": [
      "--from",
      "mcpdoc",
      "mcpdoc",
      "--urls",
      "Paradex:https://docs.paradex.trade/llms.txt",
      "--transport",
      "stdio"
   ]
}

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

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

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect