# MCP Paradex Server
[](https://smithery.ai/server/@sv/mcp-paradex-py)
Model Context Protocol (MCP) server implementation for the Paradex trading platform.
<a href="https://glama.ai/mcp/servers/cq4bz5ljqj">
<img width="380" height="200" src="https://glama.ai/mcp/servers/cq4bz5ljqj/badge" alt="Paradex Server MCP server" />
</a>
## 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](https://smithery.ai/server/@sv/mcp-paradex-py):
```bash
npx -y @smithery/cli install @sv/mcp-paradex-py --client claude
```
### Using uv (faster alternative)
1. Clone this repository:
```bash
git clone https://github.com/sv/mcp-paradex-py.git
cd mcp-paradex-py
```
2. Create a virtual environment:
```bash
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
```
3. Install dependencies:
```bash
uv pip install -e .
```
### Configuration
Set up your configuration:
```bash
cp .env.template .env
```
Then edit the `.env` file with your Paradex credentials.
## Running the Server
### Docker (recommended)
```bash
docker build . -t sv/mcp-paradex-py
```
### In Cursor add MCP as command
Public only
```bash
docker run --rm -i sv/mcp-paradex-py
```
Allow trading
```bash
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](https://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`:
```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:
```bash
# 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](https://smithery.ai/docs).
## Available Resources and Tools
### Resources
#### 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
#### 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
```json
"paradex-docs-mcp": {
"command": "uvx",
"args": [
"--from",
"mcpdoc",
"mcpdoc",
"--urls",
"Paradex:https://docs.paradex.trade/llms.txt",
"--transport",
"stdio"
]
}
```
## Contributing
Please see [CONTRIBUTING.md](CONTRIBUTING.md) for information on how to
contribute to this project, development setup, and our coding standards.
## License
[MIT License](LICENSE)