MCP Paradex Py

🚀 MCP Paradex Server

A Model Context Protocol (MCP) server implementation for the Paradex trading platform, bridging AI assistants and the trading world.

🚀 Quick Start

This project serves as a bridge between AI assistants (such as Claude) and the Paradex perpetual futures trading platform. By leveraging the MCP standard, AI assistants can perform the following operations:

• Retrieve market data from Paradex.
• Manage trading accounts and vaults.
• Place and manage orders.
• Monitor positions and balance.

✨ Features

• Connects AI assistants with the Paradex trading platform.
• Enables a wide range of trading - related operations through the MCP standard.
• Provides structured prompts for complex trading analysis and strategy generation.

📦 Installation

Prerequisites

• Python 3.10+

Installing via Smithery

To automatically install mcp - paradex - py for Claude Desktop via Smithery, use the following command:

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

Using uv (faster alternative)

1. Clone this repository:

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

2. Create a virtual environment:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies:

uv pip install -e .

Configuration

Set up your configuration:

cp .env.template .env

Then edit the .env file with your Paradex credentials.

💻 Usage Examples

Running the Server

Docker (recommended)

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

In Cursor add MCP as command

Public only

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

Allow trading

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

Smithery.ai Integration

This MCP server is compatible with Smithery.ai, a platform for discovering and deploying MCP servers.

Claude Desktop Configuration

To use this server with Claude Desktop via Smithery.ai:

1. Open Claude Desktop and enable Developer Mode from the menu.
2. Go to Settings > Developer and click "Edit Config".
3. Add the following configuration 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"
      }
    }
  }
}

4. Replace your_ethereum_private_key with your actual Paradex private key.
5. Save the file and restart Claude Desktop.

Smithery.ai Registry

The server includes a smithery.yaml file with metadata for the Smithery.ai registry. If you want to publish this server to Smithery.ai, you can use the Smithery CLI:

# Install Smithery CLI
npm install -g @smithery/cli

# Login to Smithery
smithery login

# Publish the server
smithery publish

For more information about publishing to Smithery.ai, see the Smithery documentation.

📚 Documentation

Available Resources and Tools

Resources

Tools

Trading Analysis Prompts

This MCP server provides structured prompts that AI assistants can use to perform complex trading analysis and generate trading strategies.

Market Analysis

• market_overview: Get comprehensive overview of the crypto market, including top gainers/losers, high - volume markets, funding rate anomalies, and market microstructure analysis.
• market_analysis: Detailed technical and microstructure analysis of a specific market, with support/resistance levels, chart patterns, orderbook analysis, and position recommendations.

Position and Portfolio Management

• position_management: Comprehensive analysis of existing positions, including portfolio heat, correlation, risk metrics, and specific recommendations for profit - taking and loss management.
• create_optimal_order: Design optimal order parameters for a market based on volatility, liquidity, risk tolerance, and ideal entry strategy.
• hedging_strategy: Develop effective hedging strategies for specific positions using correlation analysis, hedge ratio calculation, and implementation planning.
• portfolio_risk_assessment: Thorough risk analysis of trading portfolio, including exposure analysis, correlation assessment, VaR calculations, and risk reduction recommendations.
• liquidation_protection: Identify and mitigate liquidation risks for open positions with severity classification and protection strategies.

Investment Strategies

• vault_analysis: Comprehensive analysis of vaults for investment decision - making, with performance metrics, risk profiles, and suitability assessment.
• funding_rate_opportunity: Identify and evaluate funding rate arbitrage opportunities across markets, including yield calculations and implementation strategies.
• trading_consultation: Interactive prompt sequence for personalized trading advice and consultation.

Documentation MCP

We have seen significantly better results with giving client access to Paradex documentation.

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

📄 License

MIT License

🔗 Contributing

Please see CONTRIBUTING.md for information on how to contribute to this project, development setup, and our coding standards.