Integrations
Integrates with the Ethereum blockchain through the Paradex perpetual futures trading platform, requiring Ethereum private keys for authentication and trading functionality
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
Installing via Smithery
To install mcp-paradex-py for Claude Desktop automatically via Smithery:
Using uv (faster alternative)
- Clone this repository:Copy
- Create a virtual environment:Copy
- Install dependencies:Copy
Configuration
Set up your configuration:
Then edit the .env
file with your Paradex credentials.
Running the Server
Docker (recommended)
In Cursor add MCP as command
Public only
Allow trading
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
:
- 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:
For more information about publishing to Smithery.ai, see the Smithery documentation.
Available Resources and Tools
Resources
System Resources
paradex://system/config
- Get Paradex system configuration and basic information about the exchangeparadex://system/time
- Get current system time in milliseconds since epochparadex://system/state
- Get the current Paradex system operational state
Market Resources
paradex://markets
- Get a list of available markets from Paradexparadex://market/summary/{market_id}
- Get detailed market information for a specific trading pair
Vault Resources
paradex://vaults
- List all vaults available on Paradexparadex://vaults/config
- Get global configuration for vaultsparadex://vaults/balance/{vault_id}
- Get the balance of a specific vaultparadex://vaults/summary/{vault_id}
- Get comprehensive summary of a vaultparadex://vaults/transfers/{vault_id}
- Get deposit and withdrawal history for a vaultparadex://vaults/positions/{vault_id}
- Get current trading positions for a vaultparadex://vaults/account-summary/{vault_id}
- Get trading account information for a vault
Tools
System Tools
paradex_system_config
- Get global Paradex system configurationparadex_system_state
- Get current system state
Market Tools
paradex_markets
- Get detailed information about markets, including base/quote assets, tick size, and other trading parametersparadex_market_summaries
- Get summaries with price, volume, 24h change, and other key market metricsparadex_funding_data
- Get historical funding rate data for perpetual marketsparadex_orderbook
- Get the current orderbook for a market with customizable depthparadex_klines
- Get historical candlestick (OHLCV) data for a marketparadex_trades
- Get recent trades for a market with price, size, and timestamp informationparadex_bbo
- Get best bid and offer (tightest spread) for a market
Account Tools
paradex_account_summary
- Get account summary informationparadex_account_positions
- Get current account positionsparadex_account_fills
- Get account trade fillsparadex_account_funding_payments
- Get account funding paymentsparadex_account_transactions
- Get account transaction history
Order Tools
paradex_open_orders
- Get all open orders for an accountparadex_create_order
- Create a new order on Paradexparadex_cancel_orders
- Cancel existing ordersparadex_order_status
- Get the status of an orderparadex_orders_history
- Get historical orders for an account
Vault Tools
paradex_vaults
- Get detailed information about specific vaults or all vaults with filtering optionsparadex_vaults_config
- Get global configuration for vaults including fees, limits, and other settingsparadex_vault_balance
- Get the current balance of a vault with available/locked funds informationparadex_vault_summary
- Get comprehensive summary of vault performance, balance, and activityparadex_vault_transfers
- Get deposit and withdrawal history for a vaultparadex_vault_positions
- Get current trading positions for a vault with market, size, entry price detailsparadex_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 analysismarket_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 managementcreate_optimal_order
- Design optimal order parameters for a market based on volatility, liquidity, risk tolerance, and ideal entry strategyhedging_strategy
- Develop effective hedging strategies for specific positions using correlation analysis, hedge ratio calculation, and implementation planningportfolio_risk_assessment
- Thorough risk analysis of trading portfolio, including exposure analysis, correlation assessment, VaR calculations, and risk reduction recommendationsliquidation_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 assessmentfunding_rate_opportunity
- Identify and evaluate funding rate arbitrage opportunities across markets, including yield calculations and implementation strategiestrading_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
Contributing
Please see CONTRIBUTING.md for information on how to contribute to this project, development setup, and our coding standards.
License
You must be authenticated.
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.
Tools
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.
- Overview
- Prerequisites
- Installation
- Running the Server
- Smithery.ai Integration
- Available Resources and Tools
- Trading Analysis Prompts
- Documentation MCP
- Contributing
- License
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA 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 -2Python
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to access Flow blockchain data and perform operations such as checking balances, resolving domains, executing scripts, and submitting transactions.Last updated -JavaScript
- -securityAlicense-qualityA Model Context Protocol server that enables AI agents to interact with Brex financial platform data, allowing retrieval of account information, expenses, budgets, and team data through standardized resource handlers.Last updated -2TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.Last updated -1TypeScript