Mcp Paradex Py

What is Mcp Paradex Py about?

Mcp Paradex Py provides a bridge between AI assistants (e.g., Claude) and the Paradex perpetual futures trading platform. By implementing the Model Context Protocol (MCP) server, it enables AI agents to query market data, manage vaults and accounts, place and cancel orders, and monitor positions directly from the Paradex ecosystem.

How to use Mcp Paradex Py?

Install the package:

pip install mcp-paradex
# or, recommended
uvx mcp-paradex

Configure authentication via environment variables:
```
PARADEX_ENVIRONMENT= testnet | mainnet
PARADEX_ACCOUNT_PRIVATE_KEY= <your_private_key>
```
You can place these in a .env file based on the provided template.
Run the MCP server locally:
```
uv run mcp-paradex
```
Integrate with your AI client (Claude Desktop, Cursor IDE, or Docker) using the documented command and environment settings.

Key features of Mcp Paradex Py

System resources: configuration, time, state
Market resources: market listings, summaries, orderbooks, klines, trades, funding data
Vault resources: balances, transfers, positions, account summaries
Comprehensive toolset for system, market, account, order, and vault operations
Ready‑made trading analysis prompts (market overview, position management, hedging, risk assessment, funding‑rate arbitrage, etc.)
Flexible deployment: standard install, Docker image, or direct integration in development environments

Use cases of Mcp Paradex Py

Automated trading bots powered by LLMs that can react to market conditions in real time.
Portfolio management assistants that fetch positions, calculate risk metrics, and suggest rebalancing actions.
Research analysts that query historic funding rates and market data for strategy back‑testing.
Education platforms that demonstrate live crypto‑trading interactions through a safe testnet environment.
Custom dashboards that surface Paradex vault and account information via AI‑driven natural‑language queries.

FAQ from the Mcp Paradex Py

Q: Which Python version is required? A: Python 3.10 or newer.

Q: How do I switch between testnet and mainnet? A: Set the PARADEX_ENVIRONMENT environment variable to testnet or mainnet.

Q: Can I run the server without exposing my private key? A: Yes. Running without PARADEX_ACCOUNT_PRIVATE_KEY limits the server to read‑only operations (market data, system state). Trading actions require the key.

Q: Is there a Docker image available? A: Yes. Build with docker build . -t sv/mcp-paradex-py and run the container, optionally passing the private key via -e.

Q: How do I integrate with Claude Desktop? A: Add a server entry in claude_desktop_config.json with the command (uvx) and the required environment variables as shown in the README.

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

Mcp Paradex Py Overview