Paradex Trading

MCP server for Paradex perp trading. Market data, accounts, orders, positions, and vaults.

Open source Open in the app JSON README (API)

About

MCP server for Paradex perp trading. Market data, accounts, orders, positions, and vaults.

Details

Kind

MCP servers

Topic

Finance & crypto

Publisher

tradeparadex

Origin

official

Category

ferramentas

Transport

local

Version

0.1.2

Stars

2

Forks

1

Open pull requests

8

Last push

2026-08-05T01:54:48Z

Repository state

ativo

Language

Python

License

MIT

Added

2026-08-29 04:01:35

Updated

2026-08-29 04:01:35

Origin id

io.github.tradeparadex/mcp-paradex-py

README

# MCP Paradex Server

<!-- mcp-name: io.github.tradeparadex/mcp-paradex-py -->

[![smithery badge](https://smithery.ai/badge/tradeparadex/mcp-paradex-py)](https://smithery.ai/servers/tradeparadex/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>

## Quickstart

New here? See the **[Quickstart Guide](docs/quickstart.md)** for step-by-step setup instructions for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Claude.ai web, and ChatGPT.

Need a remote HTTP endpoint for ChatGPT or Claude.ai web? See the **[HTTP Deployment Guide](docs/deploy-http.md)** for Railway, Render, Fly.io, AWS Lambda, and Docker/VPS options.

## Overview

This project provides a bridge between AI assistants (like Claude) and
Paradex, a privacy-preserving multi-asset exchange on Starknet with spot,
perpetuals, options, and commodity futures. 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+
- [uv](https://docs.astral.sh/uv/getting-started/installation/) — required for the `uvx` run method

  > **macOS:** Install via `brew install uv` so the binary lands in `/usr/local/bin`, which GUI apps like Claude Desktop can find. The curl-pipe install puts uv in `~/.local/bin`, which GUI apps cannot see.

## Installation

### Quick Start

#### Cursor IDE

Click to automatically configure this MCP server in Cursor:

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=paradex&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJtY3AtcGFyYWRleCJdLCJlbnYiOnsiUEFSQURFWF9FTlZJUk9OTUVOVCI6InRlc3RuZXQiLCJQQVJBREVYX0FDQ09VTlRfUFJJVkFURV9LRVkiOiJ5b3VyX3ByaXZhdGVfa2V5In19Cg%3D%3D)

#### Claude Code CLI

```bash
claude mcp add paradex uvx mcp-paradex
```

#### Smithery (Claude Desktop)

```bash
npx -y @smithery/cli@latest mcp add @tradeparadex/mcp-paradex-py --client claude
```

### Standard Installation

#### PyPI

```bash
pip install mcp-paradex
```

#### uvx (Recommended)

```bash
uvx mcp-paradex
```

### Development Setup

1. Clone the repository:

   ```bash
   git clone https://github.com/tradeparadex/mcp-paradex-py.git
   cd mcp-paradex-py
   ```

2. Install development dependencies:

   ```bash
   uv sync --dev --all-extras
   ```

3. Run locally:

   ```bash
   uv run mcp-paradex
   ```

## Configuration

### Environment Variables

Set these environment variables for authentication:

- `PARADEX_ENVIRONMENT`: Set to `prod`, `testnet`, or `nightly` (default: `prod`)
- `PARADEX_ACCOUNT_PRIVATE_KEY`: Your Paradex account private key

### Using .env File

```bash
cp .env.template .env
# Edit .env with your credentials
```

### Client Configuration

#### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}
```

#### Docker (local / stdio)

```bash
# Build image
docker build . -t tradeparadex/mcp-paradex-py

# Run (public only)
docker run --rm -i tradeparadex/mcp-paradex-py

# Run with trading capabilities
docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=your_key -i tradeparadex/mcp-paradex-py
```

#### Docker (AWS Lambda / HTTP)

Use `Dockerfile.aws` for remote deployments via AWS Lambda with the
[Lambda Web Adapter](https://github.com/awslabs/aws-lambda-web-adapter).
The adapter bridges Lambda invocations to the server's HTTP endpoint,
so no Lambda-specific code is needed.

```bash
# Build
docker build -f Dockerfile.aws -t tradeparadex/mcp-paradex-py-aws .

# Test locally (mirrors Lambda config)
docker run --rm -p 8080:8080 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_STATELESS=true \
  -e MCP_PORT=8080 \
  -e PARADEX_ENVIRONMENT=prod \
  tradeparadex/mcp-paradex-py-aws
```

The server will be available at `http://localhost:8080/mcp`.

**Deploying to Lambda:**

1. Push the image to ECR
2. Create a Lambda function from the container image
3. Set the Lambda Function URL invoke mode to `RESPONSE_STREAM`
4. Set environment variables on the Lambda function:
   - `MCP_TRANSPORT=streamable-http`
   - `MCP_STATELESS=true`
   - `PARADEX_ENVIRONMENT=prod` (or `testnet`)
   - `PARADEX_ACCOUNT_PRIVATE_KEY=your_key` (optional, for trading)

## Available Resources and Tools

### Resources

#### System Resources

- `paradex://system/config` - Get Paradex system configuration
- `paradex://system/time` - Get current system time
- `paradex://system/state` - Get system operational state

#### Market Resources

- `paradex://markets` - List of available markets
- `paradex://market/summary/{market_id}` - Detailed market information

#### Vault Resources

- `paradex://vaults` - List all vaults
- `paradex://vaults/config` - Global vault configuration
- `paradex://vaults/balance/{vault_id}` - Vault balance
- `paradex://vaults/summary/{vault_id}` - Comprehensive vault summary
- `paradex://vaults/transfers/{vault_id}` - Deposit/withdrawal history
- `paradex://vaults/positions/{vault_id}` - Current trading positions
- `paradex://vaults/account-summary/{vault_id}` - Trading account information

### Tools

#### System Tools

- `paradex_system_config` - Get global system configuration
- `paradex_system_state` - Get current system state

#### Market Tools

- `paradex_markets` - Get detailed market information
- `paradex_market_summaries` - Get market summaries with metrics
- `paradex_funding_data` - Get historical funding rate data
- `paradex_orderbook` - Get current orderbook with customizable depth
- `paradex_klines` - Get historical candlestick data
- `paradex_trades` - Get recent trades
- `paradex_bbo` - Get best bid and offer

#### Account Tools

- `paradex_account_summary` - Get account summary
- `paradex_account_positions` - Get current positions
- `paradex_account_fills` - Get trade fills
- `paradex_account_funding_payments` - Get funding payments
- `paradex_account_transactions` - Get transaction history

#### Order Tools

- `paradex_open_orders` - Get all open orders
- `paradex_create_order` - Create new order
- `paradex_cancel_orders` - Cancel existing orders
- `paradex_order_status` - Get order status
- `paradex_orders_history` - Get historical orders

#### Vault Tools

- `paradex_vaults` - Get detailed vault information
- `paradex_vaults_config` - Get global vault configuration
- `paradex_vault_balance` - Get vault balance
- `paradex_vault_summary` - Get comprehensive vault summary
- `paradex_vault_transfers` - Get deposit/withdrawal history
- `paradex_vault_positions` - Get current vault positions
- `paradex_vault_account_summary` - Get vault trading account info

## Trading Analysis Prompts

### Market Analysis

- `market_overview` - Comprehensive crypto market overview
- `market_analysis` - Detailed technical and microstructure analysis

### Position and Portfolio Management

- `position_management` - Comprehensive position analysis
- `create_optimal_order` - Design optimal order parameters
- `hedging_strategy` - Develop effective hedging strategies
- `portfolio_risk_assessment` - Thorough portfolio risk analysis
- `liquidation_protection` - Identify and mitigate liquidation risks

### Investment Strategies

- `vault_analysis` - Comprehensive vault analysis for investment decisions
- `funding_rate_opportunity` - Identify funding rate arbitrage opportunities
- `trading_consultation` - Interactive trading advice and consultation

## Documentation MCP

Enhanced results with Paradex documentation access:

```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)

More

• More mcp servers on Finance & crypto
• Everything published by tradeparadex
• Browse the whole catalog