Paradex MCP server for AI agents

MCP Paradex Server is a bridge between AI assistants (like Claude) and the Paradex perpetual futures trading platform. It enables AI assistants to retrieve market data, manage trading accounts and vaults, place orders, and monitor positions through the Model Context Protocol (MCP) standard.

Prerequisites

Python 3.10+

Installation Options

Via Smithery

The easiest way to install for Claude Desktop is through Smithery:

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

Manual Installation with UV

git clone https://github.com/sv/mcp-paradex-py.git
cd mcp-paradex-py
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Configuration

Create and edit your configuration file:

cp .env.template .env

Edit the .env file with your Paradex credentials.

Running the Server

Using Docker (Recommended)

Build the Docker image:

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

Run in public mode (read-only):

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

Run with trading enabled:

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

Claude Desktop Integration

To use this server with Claude Desktop:

Open Claude Desktop and enable Developer Mode
Go to Settings > Developer and click "Edit Config"
Add the following 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"
      }
    }
  }
}

Replace your_private_key with your actual Paradex private key
Save and restart Claude Desktop

Available Resources

System Resources

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

Market Resources

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

Vault Resources

paradex://vaults - List all vaults
paradex://vaults/config - Get global vault configuration
paradex://vaults/balance/{vault_id} - Get vault balance
paradex://vaults/summary/{vault_id} - Get vault summary
paradex://vaults/transfers/{vault_id} - Get deposit/withdrawal history
paradex://vaults/positions/{vault_id} - Get trading positions
paradex://vaults/account-summary/{vault_id} - Get account information

Available Tools

System Tools

paradex_system_config - Get system configuration
paradex_system_state - Get system state

Market Tools

paradex_markets - Get market information
paradex_market_summaries - Get price, volume, 24h change
paradex_funding_data - Get funding rate data
paradex_orderbook - Get market orderbook
paradex_klines - Get candlestick (OHLCV) 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 open orders
paradex_create_order - Create a new order
paradex_cancel_orders - Cancel existing orders
paradex_order_status - Get order status
paradex_orders_history - Get order history

Vault Tools

paradex_vaults - Get vault information
paradex_vaults_config - Get vault configuration
paradex_vault_balance - Get vault balance
paradex_vault_summary - Get vault performance summary
paradex_vault_transfers - Get deposit/withdrawal history
paradex_vault_positions - Get trading positions
paradex_vault_account_summary - Get account information

Trading Analysis Prompts

The server provides structured prompts for trading analysis:

Market Analysis

market_overview - Get comprehensive market overview
market_analysis - Get detailed technical analysis

Position Management

position_management - Analyze existing positions
create_optimal_order - Design optimal order parameters
hedging_strategy - Develop hedging strategies
portfolio_risk_assessment - Perform risk analysis
liquidation_protection - Identify liquidation risks

Investment Strategies

vault_analysis - Analyze vaults for investment decisions
funding_rate_opportunity - Identify funding rate opportunities
trading_consultation - Get personalized trading advice

Documentation MCP

For better results, give Claude access to Paradex documentation:

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

How to add this MCP server to 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 > MCP and click "Add new global MCP server".

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

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

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 explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.