home / mcp / mcp paradex server

MCP Paradex Server

Provides a dedicated MCP interface to Paradex data and trading actions including markets, vaults, and orders.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "habinar-mcp-paradex-py": {
      "command": "uv",
      "args": [
        "run",
        "mcp-paradex"
      ],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      }
    }
  }
}

You can run an MCP server that bridges AI assistants with Paradex to access market data, accounts, vaults, orders, and positions. This enables automated trading workflows, monitoring, and control from your agent while keeping Paradex as the data and action layer.

How to use

Connect your MCP client to the Paradex MCP server using the provided stdio command configuration. Once connected, you can query market data, retrieve vault and account information, place and manage orders, and monitor current positions and balances. Use the available resources to fetch system state, market summaries, order books, historical data, and your trading activity. You can also inspect vault configurations and deposits/withdrawals to maintain full visibility into your Paradex trading setup.

How to install

Prerequisites: ensure you have Python 3.10 or newer installed on your system.

Install the MCP Paradex server package from PyPI.

pip install mcp-paradex

Run the MCP Paradex server locally using the standard runtime command.

uv run mcp-paradex

Alternative: install via uvx and start the server using the MCP package name.

uvx mcp-paradex

If you prefer a development setup, you can clone the repository, install dependencies, and run locally.

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

uv sync --dev --all-extras

uv run mcp-paradex

Configuration and usage notes

Security and credentials are required to access Paradex accounts and vaults. Set your environment variables to provide the environment (testnet or mainnet) and your Paradex private key.

Additional configuration and environment

Environment variables you need to set for authentication and environment selection include PARADEX_ENVIRONMENT and PARADEX_ACCOUNT_PRIVATE_KEY. You can store these in a .env file and load them before starting the server.

Configuration examples and client setup

For Claude Desktop, configure the MCP server to start via uvx with the specified environment and private key in your client settings.

Troubleshooting and notes

If you encounter connection or authentication issues, verify that PARADEX_ENVIRONMENT is set to testnet or mainnet and that PARADEX_ACCOUNT_PRIVATE_KEY is valid for your Paradex account.

Available tools

paradex_system_config

Get global system configuration for Paradex MCP server.

paradex_system_state

Retrieve the current system state.

paradex_markets

Get detailed market information.

paradex_market_summaries

Fetch market summaries and metrics.

paradex_funding_data

Obtain historical funding rate data.

paradex_orderbook

Retrieve the current orderbook with configurable depth.

paradex_klines

Access historical candlestick data.

paradex_trades

Get recent trades for markets.

paradex_bbo

Fetch best bid and offer data.

paradex_account_summary

Get account summary.

paradex_account_positions

Query current positions.

paradex_account_fills

Retrieve trade fills.

paradex_account_funding_payments

Get funding payments.

paradex_account_transactions

Get transaction history.

paradex_open_orders

List all open orders.

paradex_create_order

Create a new order.

paradex_cancel_orders

Cancel existing orders.

paradex_order_status

Get the status of an order.

paradex_orders_history

Retrieve historical orders.

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.