Paradex MCP

What is mcp-paradex-py?

mcp-paradex-py is a Model Context Protocol (MCP) server implementation that acts as a bridge between AI assistants (like Claude) and the Paradex perpetual futures trading platform. It enables AI agents to interact with Paradex for various trading activities.

How to use mcp-paradex-py?

Installation:

Quick Start:
- Cursor IDE: Click the provided badge to automatically configure the MCP server in Cursor.
- Claude Code CLI: claude mcp add paradex uvx mcp-paradex
- Smithery (Claude Desktop): npx -y @smithery/cli install @sv/mcp-paradex-py --client claude
Standard Installation:
- PyPI: pip install mcp-paradex
- uvx (Recommended): uvx mcp-paradex

Configuration:

Environment Variables: Set PARADEX_ENVIRONMENT (testnet or mainnet) and PARADEX_ACCOUNT_PRIVATE_KEY.
.env File: Copy .env.template to .env and edit with your credentials.
Client Configuration (Claude Desktop): Add the provided JSON configuration to your claude_desktop_config.json.
Docker: Build and run the Docker image as shown in the README.

Key Features of mcp-paradex-py

Resources:

System Resources: Get Paradex system configuration, time, and operational state.
Market Resources: Access lists of available markets and detailed market information.
Vault Resources: Retrieve vault lists, configuration, balances, summaries, transfer history, positions, and account summaries.

Tools:

System Tools: Get global system configuration and current system state.
Market Tools: Access detailed market information, summaries, funding data, order books, candlestick data, recent trades, and best bid/offer.
Account Tools: Get account summaries, positions, fills, funding payments, and transaction history.
Order Tools: Manage open orders, create new orders, cancel orders, check order status, and view historical orders.
Vault Tools: Access detailed vault information, configuration, balance, summary, transfer history, positions, and account information.

Trading Analysis Prompts:

Market Analysis: Comprehensive crypto market overview and detailed technical/microstructure analysis.
Position and Portfolio Management: Comprehensive position analysis, optimal order design, hedging strategies, portfolio risk assessment, and liquidation protection.
Investment Strategies: Comprehensive vault analysis, funding rate arbitrage opportunities, and interactive trading consultation.

Use Cases of mcp-paradex-py

Automated Trading: Develop and deploy AI agents for automated trading strategies on Paradex.
Market Data Analysis: Retrieve and analyze real-time and historical market data for informed decision-making.
Account Management: Programmatically manage trading accounts, vaults, and positions.
Algorithmic Order Execution: Implement complex order placement and management algorithms.
Risk Management: Develop tools for portfolio risk assessment and liquidation prevention.
Investment Research: Utilize AI for identifying investment opportunities and developing strategies.

FAQ from mcp-paradex-py

What is MCP? Model Context Protocol (MCP) is a standard for connecting AI assistants to various platforms.
What are the prerequisites? Python 3.10+ is required.
How do I authenticate? Set PARADEX_ENVIRONMENT and PARADEX_ACCOUNT_PRIVATE_KEY environment variables.
Can I use Docker? Yes, Docker build and run commands are provided for deployment.
Where can I find documentation? Enhanced results are available with Paradex documentation access via paradex-docs-mcp configuration.
How can I contribute? Refer to the CONTRIBUTING.md file for contribution guidelines and development setup.

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

Quick Start

Cursor IDE

Click to automatically configure this MCP server in Cursor:

Claude Code CLI

claude mcp add paradex uvx mcp-paradex

Smithery (Claude Desktop)

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

Standard Installation

PyPI

pip install mcp-paradex

uvx (Recommended)

uvx mcp-paradex

Development Setup

Clone the repository:

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

Install development dependencies:
```
uv sync --dev --all-extras
```
Run locally:
```
uv run mcp-paradex
```

Configuration

Environment Variables

Set these environment variables for authentication:

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

Using .env File

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

Client Configuration

Claude Desktop

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

Docker

# Build image
docker build . -t sv/mcp-paradex-py

# Run (public 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

Available Resources and Tools

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

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 Prompts

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

Documentation MCP

Enhanced results with Paradex documentation access:

"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

Paradex MCP Overview