Paradex Trading MCP server

by tradeparadex·io.github.tradeparadex/mcp-paradex-py·v0.1.2·2 stars

No reviews yet

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

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

Growing

2 stars52 downloads/wk

Reviews

Write one

Nobody has reviewed Paradex Trading yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Paradex Trading tools (26, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

paradex_account_fills
Analyze your executed trades to evaluate performance and execution quality.
paradex_account_funding_payments
Track your funding payment history to understand its impact on P&L.
paradex_account_positions
Analyze your open positions to monitor exposure, profitability, and risk.
paradex_account_summary
Get a snapshot of your account's current financial status and trading capacity.
paradex_account_transactions
Get account transaction history.
paradex_bbo
Get the current best available prices for immediate execution decisions.
paradex_cancel_orderswrite action
Cancel pending orders to manage exposure or adjust your trading strategy.
paradex_create_orderwrite action
Execute trades on Paradex with precise control over all order parameters.
paradex_filters_model
Get detailed schema information to build precise data filters.
paradex_funding_data
Analyze funding rates for potential funding arbitrage or to understand holding costs.
paradex_klines
Analyze historical price patterns for technical analysis and trading decisions.
paradex_market_summaries
Identify the most active or volatile markets and get current market conditions.
paradex_markets
Find markets that match your trading criteria or get detailed market specifications.
paradex_open_orders
Monitor your active orders to track execution status and manage your trading strategy.
paradex_order_statuswrite action
Check the detailed status of a specific order for execution monitoring.
paradex_orderbook
Analyze market depth and liquidity to optimize order entry and execution.
paradex_orders_history
Get historical orders.
paradex_system_config
Understand the exchange's global parameters that affect all trading activity.
paradex_system_state
Verify the exchange is fully operational before executing trades.
paradex_trades
Analyze actual market transactions to understand market sentiment and liquidity.
paradex_vault_account_summary
Get a comprehensive overview of a vault's trading account status.
paradex_vault_balance
Get the current balance of a specific vault.
paradex_vault_positions
Monitor active trading positions to track performance and manage risk.
paradex_vault_summary
Get a comprehensive summary of a specific vault or all vaults if no address is provided.
paradex_vault_transfers
Track deposit and withdrawal history for auditing and reconciliation.
paradex_vaults
Get detailed information about a specific vault or all vaults if no address is provided.

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

no findings

Code scan23 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 54 days ago12/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Paradex Trading compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 80/100; higher than 70% of 2,174 E-commerce servers
Tools: 26; the typical E-commerce server has 6
Tools that change things: 12%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 2; more than 80% of 1,047 E-commerce servers
Downloads a week: 52; more than 50% of 411 E-commerce servers with a package

What its tools let an agent do: 23 read · 3 change

Install Paradex Trading in Claude Code, Cursor or VS Code

claude mcp add mcp-paradex-py -- uvx mcp-paradex

Add to Cursor

What the publisher says

From the Paradex Trading repository's README, as published. We do not edit it. Read it on GitHub

MCP Paradex Server

Model Context Protocol (MCP) server implementation for the Paradex trading platform.

Quickstart

New here? See the Quickstart Guide 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 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 — 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:

Claude Code CLI

claude mcp add paradex uvx mcp-paradex

Smithery (Claude Desktop)

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

Standard Installation

PyPI

pip install mcp-paradex

uvx (Recommended)

uvx mcp-paradex

Development Setup

Clone the repository:

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

Install development dependencies:

uv sync --dev --all-extras

Run locally:

uv run mcp-paradex

Configuration

Environment Variables

Set these environment variables for authentication:

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

Using .env File

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

Client Configuration

Claude Desktop

Add to your claudedesktopconfig.json:

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

Docker (local / stdio)

# 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. The adapter bridges Lambda invocations to the server's HTTP endpoint, so no Lambda-specific code is needed.

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

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Paradex Trading: common questions

Is Paradex Trading MCP server safe?: Mostly: it is graded B (80/100). Read the Paradex Trading safety report
How do I install Paradex Trading?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Paradex Trading need an API key?: Yes. The registry entry asks for PARADEX_ACCOUNT_PRIVATE_KEY.
Is Paradex Trading maintained?: The last commit was 91 days ago (2026-08-05). The latest release is v0.1.2.
What can I use instead of Paradex Trading?: Servers from other publishers that do the same job: Polymarket Toolkit MCP server, Polymarket Paper Trader MCP server and Acedatacloud MCP server.
How does Paradex Trading compare with other E-commerce MCP servers?: safety score 80/100 (higher than 70% of 2,174 E-commerce servers); tools 26 (the typical E-commerce server has 6); tools that change things 12% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Paradex Trading

Same job from other publishers: the closest match first, then the best rated.

Polymarket Toolkit
Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
not reviewed
Established
B
Polymarket Paper Trader
Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.
not reviewed
Growing
A
Acedatacloud
Manage your AceData Cloud account: services, pricing, APIs, docs, balance, usage, keys & orders
not reviewed
Growing
A
comdirect
Read-only access to comdirect accounts, transactions, depots, orders and postbox documents.
not reviewed
Growing
B
Robinhood Crypto
Robinhood Crypto Trading API for AI agents: quotes, holdings, orders read-only; opt-in trading.
not reviewed
Growing
B

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 80/100
Stars: 2
Downloads/wk: 52
Price: Free
Licence: MIT
Transport: Local · pypi
Version: 0.1.2
Category: E-commerce
Last release: 2026-08-05

Credentials it needs

PARADEX_ACCOUNT_PRIVATE_KEYsecretEthereum private key for your Paradex account (enables trading). Without this, only public market data is accessible.
PARADEX_ENVIRONMENTParadex environment to connect to. Defaults to 'prod'. Use 'testnet' for testing.

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/tradeparadex-mcp-paradex-py.svg)](https://mcp.market/server/tradeparadex-mcp-paradex-py)

How the badge works