MCP Paradex Server
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.
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 pip
- Clone this repository:
- Create a virtual environment:
- Install dependencies:
Using uv (faster alternative)
- Clone this repository:
- Create a virtual environment:
- Install dependencies:
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
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
check_public_api
- Check the connection to Paradex public API without authenticationcheck_paradex_connection
- Verify connectivity with Paradex API using authentication
Market Tools
get_market_data
- Retrieve detailed market data for a specific marketget_orderbook
- Get the current orderbook for a marketget_recent_trades
- Retrieve recent trades for a market
Account Tools
get_account_info
- Get information about the connected accountget_account_balance
- Retrieve the account balance
Order Tools
place_order
- Place a new order on Paradexcancel_order
- Cancel an existing orderget_order_status
- Check the status of an order
Vault Tools
create_vault
- Create a new vaultdeposit_to_vault
- Deposit funds into a vaultwithdraw_from_vault
- Withdraw funds from a vault
Development
Project Structure
src/mcp_paradex/
- Main packageserver/
- MCP server implementationserver.py
- FastMCP server configuration
resources/
- Read-only data resourcessystem.py
- System status resourcemarket.py
- Market data resourcesvaults.py
- Vault management resources
tools/
- Action tools for operationssystem.py
- System management toolsmarket.py
- Market data toolsaccount.py
- Account management toolsorders.py
- Order management toolsvaults.py
- Vault management tools
utils/
- Utility functions and helpersconfig.py
- Configuration handlingparadex_client.py
- Paradex API client
Development Progress
- Step 1: Create Basic Project Structure
- Set up package configuration and dependencies
- Create initial FastMCP server configuration
- Implement basic system health checks
- Step 2: Implement Authentication Layer
- Design secure API key management system
- Create authentication flow for Paradex API
- Step 3: Deploy Basic Server with Health Check
- Implement system status resource
- Create connectivity verification tool
- Add public API endpoints that don't require authentication
- Step 4: Market Data Integration
- Implement market data resources
- Create market data tools
- Add orderbook and trade history functionality
- Step 5: Account and Order Management
- Implement account information resources
- Create order management tools
- Add vault management capabilities
- Step 6: Add Smithery.ai Support
- Create Smithery.ai configuration file
- Add Claude Desktop configuration example
- Document Smithery.ai integration
Code Quality Tools
This project uses several tools to maintain code quality:
- Black: Code formatter that enforces a consistent style
- Ruff: Fast Python linter that combines functionality from multiple linting tools
- Mypy: Static type checker for Python
- Pre-commit: Git hook scripts to automate checks before commits
Setup Development Environment
- Install development dependencies:
- Format code:
- Lint code:
- Type check:
- Run all checks:
- Run pre-commit on all files:
- Run tests:
- Run tests with coverage report:
Testing
This project uses pytest for testing. Tests are located in the tests
directory.
To run tests:
To run tests with coverage report:
This will generate an HTML coverage report in the htmlcov
directory.
Pre-commit Hooks
Pre-commit hooks are configured to run automatically on git commit. They include:
- Trailing whitespace removal
- End-of-file fixer
- YAML/TOML syntax checking
- Black formatting
- Ruff linting
- Mypy type checking
To manually run all pre-commit hooks on all files:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
You must be authenticated.
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
- Development
- License