Paradex Server

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

Remote Shell Execution
Database Interaction
AI Integration Systems
Data & App Analysis
Visit Server

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

smithery badge

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

  1. Clone this repository:

    git clone https://github.com/sv/mcp-paradex-py.git
    cd mcp-paradex-py
    
  2. Create a virtual environment:

    python -m venv .venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
    
  3. Install dependencies:

    pip install -e .
    

Using uv (faster alternative)

  1. Clone this repository:

    git clone https://github.com/sv/mcp-paradex-py.git
    cd mcp-paradex-py
    
  2. Create a virtual environment:

    uv venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
    
  3. 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:

  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:
{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["--with-editable", ".", "mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}
  1. Replace your_ethereum_private_key with your actual Paradex private key
  2. 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 connection
  • system://version - Get detailed version information about the server and dependencies
  • system://health - Perform a basic health check of the server

Market Resources

  • market://public/markets - Get a list of available markets from Paradex
  • market://public/info - Get general market information and status

Vault Resources

  • vaults://list - List all vaults associated with the account
  • vaults://balance - Get the balance of a specific vault
  • vaults://details - Get detailed information about a vault

Tools

System Tools

  • paradex-system-config - Get global Paradex system configuration
  • paradex-system-time - Get current Paradex server time
  • paradex-system-state - Get current system state

Market Tools

  • paradex-market-names - Get a list of available markets from Paradex
  • paradex-market-details - Get detailed information about a specific market
  • paradex-market-summaries - Get summaries for all markets or a specific market
  • paradex-funding-data - Get funding rate data for a market
  • paradex-orderbook - Get the current orderbook for a market
  • paradex-klines - Get historical candlestick data for a market
  • paradex-trades - Get recent trades for a market
  • paradex-bbo - Get best bid and offer 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-account-open-orders - Get all open orders for an account
  • paradex-create-order - Create a new order on Paradex
  • paradex-cancel-order - Cancel an existing order
  • paradex-cancel-order-by-client-id - Cancel an order by client ID
  • paradex-cancel-all-orders - Cancel all open orders
  • paradex-get-order-status - Get the status of an order
  • paradex-get-order-by-client-id - Get order status by client ID
  • paradex-get-orders-history - Get historical orders for an account

Vault Tools

  • paradex-vault-list - List all available vaults
  • paradex-vault-details - Get detailed information about a vault
  • paradex-vaults-config - Get vault configuration options
  • paradex-vault-balance - Get the balance of a vault
  • paradex-vault-summary - Get a summary of a vault's status
  • paradex-vault-transfers - Get transfer history for a vault
  • paradex-vault-positions - Get current positions in a vault
  • paradex-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

MIT License

Recommended Servers

playwright-mcp

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.

Official
Featured
TypeScript
VeyraX MCP

VeyraX MCP

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

Official
Featured
Local
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

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.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured
AIO-MCP Server

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

Featured
Local
Persistent Knowledge Graph

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.

Featured
Local
Hyperbrowser MCP Server

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

Featured
Local
React MCP

React MCP

react-mcp integrates with Claude Desktop, enabling the creation and modification of React apps based on user prompts

Featured
Local