Paradex Server
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.
sv
Tools
paradex-account-summary
Get account summary. Returns: Dict[str, Any]: Account summary.
paradex-account-positions
Get account positions. Returns: Dict[str, Any]: Account positions.
paradex-system-config
Get global Paradex system configuration. Retrieves the current system-wide configuration parameters from Paradex, including trading limits, fee schedules, and other global settings. This information is useful for understanding the current operating parameters of the exchange. Returns: Dict[str, Any]: Global Paradex system configuration with the following structure: - exchange (str): Exchange name ("Paradex") - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current environment (mainnet/testnet) - status (str): Current system status ("operational", "maintenance", etc.) - features (List[str]): Available trading features - trading_hours (str): Trading availability - website (str): Exchange website URL - documentation (str): Documentation URL - [Additional system parameters from Paradex API] If an error occurs, returns error information.
paradex-system-time
Get the current Paradex server time. Retrieves the current server time from Paradex. This is important for time-sensitive operations like trading, as local time might differ from the exchange's server time. Using the exchange time ensures accurate timestamp coordination for orders and other time-dependent operations. Returns: Dict[str, Any]: Current server time information with the following structure: - server_time (int): Current server time in milliseconds since epoch - iso_time (str): ISO-formatted timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message
paradex-system-state
Get the current Paradex system operational state. Retrieves the current operational state of the Paradex exchange, including information about system health, maintenance status, and any active alerts or notices. This is useful for checking if the exchange is fully operational before executing trades. Returns: Dict[str, Any]: Current system state information with the following structure: - status (str): Overall system status ("operational", "degraded", "maintenance", etc.) - components (Dict): Status of individual system components - maintenance (Dict, optional): Information about ongoing or scheduled maintenance - notices (List, optional): System-wide notices or alerts If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message
paradex-vault-list
Get a list of available vaults from Paradex. Retrieves all available vaults on Paradex, including their addresses and names. This tool requires no parameters and returns a comprehensive list of all vaults that can be accessed on Paradex. Returns: Dict[str, Any]: List of available vaults with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - vaults (List[Dict]): List of vault objects with address and name - count (int): Total number of vaults If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - vaults (List): Empty list - count (int): 0
paradex-vault-details
Get detailed information about a specific vault. Retrieves comprehensive details about a specific vault identified by its address, including configuration, permissions, and other vault-specific parameters. Returns: Dict[str, Any]: Detailed vault information with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - vaults (List[Dict]): List containing the vault details - count (int): Number of vaults returned (should be 1) If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - vaults (List): Empty list - count (int): 0
paradex-vaults-config
Get global configuration for vaults from Paradex. Retrieves system-wide configuration parameters for vaults on Paradex, including fee structures, limits, and other global settings that apply to all vaults on the platform. Returns: Dict[str, Any]: Global vault configuration with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - config (Dict): Global vault configuration parameters If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - config (None): Null value for config
paradex-market-names
Get a list of available markets from Paradex. Retrieves all available trading markets/pairs from the Paradex exchange. This tool requires no parameters and returns a comprehensive list of all markets that can be traded on Paradex. Returns: Dict[str, Any]: List of available markets with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - markets (List[str]): List of market symbols - count (int): Total number of markets
paradex-market-details
Get detailed information about a specific market. Retrieves comprehensive details about a specific market, including base and quote assets, tick size, minimum order size, and other trading parameters. Returns: Dict[str, Any]: Detailed market information with the following structure: - success (bool): Whether the request was successful - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment (mainnet/testnet) - details (Dict): Detailed market information including trading parameters - error (str, optional): Error message if request failed
paradex-vault-balance
Get the current balance of a specific vault. Retrieves the current balance information for a specific vault, including available funds, locked funds, and total balance. This is essential for understanding the financial state of a vault before executing trades or withdrawals. Returns: Dict[str, Any]: Balance information for the vault, including: - available (float): Available balance that can be used for trading - locked (float): Balance locked in open orders or positions - total (float): Total balance (available + locked) - currency (str): Currency of the balance (e.g., "USDC") If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - balance (None): Null value for balance
paradex-vault-summary
Get a comprehensive summary of a specific vault. Retrieves a summary of all important information about a vault, including balance, positions, recent activity, and performance metrics. This provides a high-level overview of the vault's current state. Returns: Dict[str, Any]: Summary information for the vault, including: - balance (Dict): Current balance information - positions (List): Current open positions - performance (Dict): Performance metrics - recent_activity (List): Recent transactions or trades If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - summary (None): Null value for summary
paradex-vault-transfers
Get a list of deposit and withdrawal transfers for a specific vault. Retrieves the history of all transfers (deposits and withdrawals) for a vault, including timestamps, amounts, transaction hashes, and status information. This is useful for auditing vault activity and tracking fund movements. Returns: Dict[str, Any]: List of transfers for the vault, each containing: - id (str): Transfer ID - type (str): "DEPOSIT" or "WITHDRAWAL" - amount (float): Transfer amount - currency (str): Currency of the transfer - timestamp (str): When the transfer occurred - status (str): Status of the transfer (e.g., "COMPLETED", "PENDING") - transaction_hash (str): Blockchain transaction hash If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - transfers (None): Null value for transfers
paradex-vault-positions
Get a list of current trading positions for a specific vault. Retrieves all open trading positions for a vault, including market, size, entry price, liquidation price, unrealized PnL, and other position-specific information. Returns: Dict[str, Any]: List of positions for the vault, each containing: - market_id (str): Market identifier (e.g., "ETH-PERP") - side (str): Position side ("LONG" or "SHORT") - size (float): Position size - entry_price (float): Average entry price - mark_price (float): Current mark price - liquidation_price (float): Price at which position would be liquidated - unrealized_pnl (float): Unrealized profit/loss - leverage (float): Current leverage If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - positions (None): Null value for positions
paradex-vault-account-summary
Get a summary of trading account information for a specific vault. Retrieves a comprehensive summary of the trading account associated with a vault, including margin information, account health, risk metrics, and trading statistics. Returns: Dict[str, Any]: Account summary information, including: - margin_ratio (float): Current margin ratio - account_health (float): Account health percentage - total_equity (float): Total account equity - available_margin (float): Available margin for new positions - used_margin (float): Margin currently in use - unrealized_pnl (float): Total unrealized profit/loss - realized_pnl_24h (float): Realized profit/loss in the last 24 hours - open_orders_count (int): Number of open orders - positions_count (int): Number of open positions If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - account_summary (None): Null value for account summary
paradex-market-summary
Get a summary of market statistics and current state. Retrieves current market summary information including price, volume, 24h change, and other key market metrics. Returns: Dict[str, Any]: Market summary information including: - Current price - 24h high/low - 24h volume - Price change percentage - Other market statistics If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - summary (None): Null value for summary
paradex-funding-data
Get historical funding rate data for a perpetual market. Retrieves funding rate history for a specified time period, which is essential for understanding the cost of holding perpetual positions. Returns: Dict[str, Any]: Historical funding rate data with timestamps. If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - funding_data (None): Null value for funding data
paradex-bbo
Get the Best Bid and Offer (BBO) for a market. Retrieves the current best bid and best offer (ask) prices and sizes for a specified market. This represents the tightest spread currently available. Returns: Dict[str, Any]: Best bid and offer information including: - bid price and size - ask price and size - timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message
paradex-orderbook
Get the current orderbook for a market. Retrieves the current state of the orderbook for a specified market, showing bid and ask orders up to the requested depth. Returns: Dict[str, Any]: Orderbook data including: - bids: List of [price, size] pairs - asks: List of [price, size] pairs - timestamp If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message - orderbook (None): Null value for orderbook
paradex-klines
Get candlestick (kline) data for a market. Retrieves historical price candlestick data for a specified market and time period. Each candlestick contains open, high, low, close prices and volume information. Returns: Dict[str, Any]: Candlestick data with the following structure for each candle: - timestamp - open price - high price - low price - close price - volume If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message
paradex-trades
Get recent trades for a market. Retrieves historical trade data for a specified market and time period. Each trade includes price, size, side (buy/sell), and timestamp information. Returns: Dict[str, Any]: List of trades with the following structure for each trade: - id: Trade ID - price: Execution price - size: Trade size - side: "buy" or "sell" - timestamp: Time of execution If an error occurs, returns: - success (bool): False - timestamp (str): ISO-formatted timestamp of the request - environment (str): Current Paradex environment - error (str): Error message
paradex-account-fills
Get account fills. Returns: Dict: Account fills.
paradex-account-funding-payments
Get account funding payments. Returns: Dict[str, Any]: Account funding payments.
paradex-account-open-orders
Get account open orders. Returns: Dict[str, Any]: Account orders.
paradex-create-order
Create a new order. Returns: Dict[str, Any]: Created order details.
paradex-cancel-order
Cancel an order. Returns: Dict[str, Any]: Cancelled order details.
paradex-cancel-all-orders
Cancel all orders.
paradex-get-order-status
Get order status. Returns: Dict[str, Any]: Order details.
README
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:
npx -y @smithery/cli install @sv/mcp-paradex-py --client claude
Using pip
-
Clone this repository:
git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-py
-
Create a virtual environment:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
-
Install dependencies:
pip install -e .
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.
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.
Available Resources and Tools
Resources
System Resources
system://status
- Get the current status of the system and Paradex connectionsystem://version
- Get detailed version information about the server and dependenciessystem://health
- Perform a basic health check of the server
Market Resources
market://public/markets
- Get a list of available markets from Paradexmarket://public/info
- Get general market information and status
Vault Resources
vaults://list
- List all vaults associated with the accountvaults://balance
- Get the balance of a specific vaultvaults://details
- Get detailed information about a vault
Tools
System Tools
paradex-system-config
- Get global Paradex system configurationparadex-system-time
- Get current Paradex server timeparadex-system-state
- Get current system state
Market Tools
paradex-market-names
- Get a list of available markets from Paradexparadex-market-details
- Get detailed information about a specific marketparadex-market-summaries
- Get summaries for all markets or a specific marketparadex-funding-data
- Get funding rate data for a marketparadex-orderbook
- Get the current orderbook for a marketparadex-klines
- Get historical candlestick data for a marketparadex-trades
- Get recent trades for a marketparadex-bbo
- Get best bid and offer 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-account-open-orders
- Get all open orders for an accountparadex-create-order
- Create a new order on Paradexparadex-cancel-order
- Cancel an existing orderparadex-cancel-order-by-client-id
- Cancel an order by client IDparadex-cancel-all-orders
- Cancel all open ordersparadex-get-order-status
- Get the status of an orderparadex-get-order-by-client-id
- Get order status by client IDparadex-get-orders-history
- Get historical orders for an account
Vault Tools
paradex-vault-list
- List all available vaultsparadex-vault-details
- Get detailed information about a vaultparadex-vaults-config
- Get vault configuration optionsparadex-vault-balance
- Get the balance of a vaultparadex-vault-summary
- Get a summary of a vault's statusparadex-vault-transfers
- Get transfer history for a vaultparadex-vault-positions
- Get current positions in a vaultparadex-vault-account-summary
- Get account summary for a vault
Contributing
Please see CONTRIBUTING.md for information on how to contribute to this project, development setup, and our coding standards.
License
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
AIO-MCP Server
🚀 All-in-one MCP server with AI search, RAG, and multi-service integrations (GitLab/Jira/Confluence/YouTube) for AI-enhanced development workflows. Folk from
Persistent Knowledge Graph
An implementation of persistent memory for Claude using a local knowledge graph, allowing the AI to remember information about users across conversations with customizable storage location.
Hyperbrowser MCP Server
Welcome to Hyperbrowser, the Internet for AI. Hyperbrowser is the next-generation platform empowering AI agents and enabling effortless, scalable browser automation. Built specifically for AI developers, it eliminates the headaches of local infrastructure and performance bottlenecks, allowing you to
React MCP
react-mcp integrates with Claude Desktop, enabling the creation and modification of React apps based on user prompts