MCP Integration Tool: Connect AI Assistants to Paradex for Trading

MCP Paradex Py

This is an MCP server implementation that connects AI assistants with the Paradex perpetual contract trading platform, providing functions such as market data acquisition, account management, and order operations.

Finance Artificial intelligence chatbots #Trading platform #AI trading #Perpetual contracts #Market data .Python

rating : 2 points

downloads : 2

update time : 2025-07-25

What is the Paradex MCP Server?

This is a server based on the Model Context Protocol (MCP) standard that allows AI assistants (such as Claude) to interact with the Paradex trading platform. It provides a complete set of API interfaces, enabling AI to perform operations such as obtaining market data, managing accounts, and executing trades.

How to use the Paradex MCP Server?

It can be quickly deployed through a Docker container or run by directly installing the Python package. After configuration, the AI assistant can interact with the Paradex platform through the standard MCP protocol.

Applicable scenarios

Suitable for scenarios that require automated trading strategy analysis, real - time market monitoring, and intelligent trade execution, especially for quantitative traders and AI - assisted trading.

Main features

Market data queryObtain real - time market data, including price, depth, K - line, trading history, etc.

Account managementQuery account information such as account balance, positions, and historical trades.

Order executionSupport creating, modifying, and canceling orders, and querying order status.

Vault managementManage trading vaults, including fund transfer and position query.

Trading analysisProvide a variety of preset analysis templates to help AI generate trading strategies.

Advantages and limitations

Advantages

Standardized interface, easy to integrate with AI assistants

Complete coverage of trading functions

Support for rapid Docker deployment

Abundant market data analysis tools

Seamless integration with the Smithery.ai platform

Limitations

Requires basic server deployment knowledge

Trading functions require private key configuration, posing security risks

Currently only supports the Paradex platform

How to use

Installation preparation

Ensure that Python 3.10+ or a Docker environment is installed on the system

Install the server

Can be installed through Docker or by directly installing the Python package

Configure the environment

Copy and modify the .env configuration file to set Paradex account information

Run the server

Start the server and prepare to accept connections from AI assistants

AI assistant integration

Configure the MCP server connection in the AI assistant (such as Claude)

Usage examples

Market data analysisThe AI assistant obtains market data for BTC perpetual contracts through the MCP server and analyzes price trends

Automatic trade executionThe AI automatically executes trading strategies based on analysis results

Risk managementThe AI monitors account risks and adjusts automatically

Frequently Asked Questions

Is it safe to use the MCP server?

Which AI assistants are supported?

Is programming knowledge required to use it?

Does it support simulated trading?

How to handle API rate limits?

Related resources

Paradex official documentation

Official documentation and technical reference for the Paradex platform

Smithery.ai

MCP server discovery and deployment platform

GitHub repository

Project source code and issue tracking

MCP protocol documentation

Official documentation for the Model Context Protocol

🚀 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)

Clone this repository:

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

Create a virtual environment:

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

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:

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

Replace your_ethereum_private_key with your actual Paradex private key.
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

Property	Details
System Resources	- `paradex://system/config`: Get Paradex system configuration and basic information about the exchange. - `paradex://system/time`: Get current system time in milliseconds since epoch. - `paradex://system/state`: Get the current Paradex system operational state.
Market Resources	- `paradex://markets`: Get a list of available markets from Paradex. - `paradex://market/summary/{market_id}`: Get detailed market information for a specific trading pair.
Vault Resources	- `paradex://vaults`: List all vaults available on Paradex. - `paradex://vaults/config`: Get global configuration for vaults. - `paradex://vaults/balance/{vault_id}`: Get the balance of a specific vault. - `paradex://vaults/summary/{vault_id}`: Get comprehensive summary of a vault. - `paradex://vaults/transfers/{vault_id}`: Get deposit and withdrawal history for a vault. - `paradex://vaults/positions/{vault_id}`: Get current trading positions for a vault. - `paradex://vaults/account-summary/{vault_id}`: Get trading account information for a vault.

Tools

Property	Details
System Tools	- `paradex_system_config`: Get global Paradex system configuration. - `paradex_system_state`: Get current system state.
Market Tools	- `paradex_markets`: Get detailed information about markets, including base/quote assets, tick size, and other trading parameters. - `paradex_market_summaries`: Get summaries with price, volume, 24h change, and other key market metrics. - `paradex_funding_data`: Get historical funding rate data for perpetual markets. - `paradex_orderbook`: Get the current orderbook for a market with customizable depth. - `paradex_klines`: Get historical candlestick (OHLCV) data for a market. - `paradex_trades`: Get recent trades for a market with price, size, and timestamp information. - `paradex_bbo`: Get best bid and offer (tightest spread) for a market.
Account Tools	- `paradex_account_summary`: Get account summary information. - `paradex_account_positions`: Get current account positions. - `paradex_account_fills`: Get account trade fills. - `paradex_account_funding_payments`: Get account funding payments. - `paradex_account_transactions`: Get account transaction history.
Order Tools	- `paradex_open_orders`: Get all open orders for an account. - `paradex_create_order`: Create a new order on Paradex. - `paradex_cancel_orders`: Cancel existing orders. - `paradex_order_status`: Get the status of an order. - `paradex_orders_history`: Get historical orders for an account.
Vault Tools	- `paradex_vaults`: Get detailed information about specific vaults or all vaults with filtering options. - `paradex_vaults_config`: Get global configuration for vaults including fees, limits, and other settings. - `paradex_vault_balance`: Get the current balance of a vault with available/locked funds information. - `paradex_vault_summary`: Get comprehensive summary of vault performance, balance, and activity. - `paradex_vault_transfers`: Get deposit and withdrawal history for a vault. - `paradex_vault_positions`: Get current trading positions for a vault with market, size, entry price details. - `paradex_vault_account_summary`: Get trading account information for a vault including margin and risk metrics.

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