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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server implementation that enables AI assistants to interact with the Paradex perpetual futures trading platform, allowing for retrieving market data, managing trading accounts, placing orders, and monitoring positions.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Deriv API MCP Server
raju-deriv
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with the Deriv trading API, providing access to active trading symbols and account balance information.
Last updated -
2
Python
MCP-ODOS
IQAIcom
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants and applications to interact with decentralized exchanges (DEXs), allowing users to get quotes for token swaps and execute swap transactions.
Last updated -
3
2
1
TypeScript
MIT License
MCP Paradex Server
Habinar
A
security
A
license
A
quality
A bridge between AI assistants and the Paradex perpetual futures trading platform that enables retrieving market data, managing trading accounts, placing orders, and monitoring positions.
Last updated -
26
1
MIT License
AI Prediction MCP Server
phsphd
-
security
F
license
-
quality
A Model Context Protocol server that provides Claude with access to AI-powered trading predictions and analysis from the aiprediction.us API, handling authentication, date formatting, and data retrieval.
Last updated -
Python

View all related MCP servers