# Paradex MCP Server (verified)

MCP server for the Paradex perpetual futures trading platform. Retrieve market data, manage trading accounts and vaults, place and manage orders, and monitor positions and balances.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add tradeparadex/mcp-paradex-py

# Browse available tools
npx -y @smithery/cli@latest tool list tradeparadex/mcp-paradex-py

# Get full schema for a tool
npx -y @smithery/cli@latest tool get tradeparadex/mcp-paradex-py paradex_filters_model

# Call a tool
npx -y @smithery/cli@latest tool call tradeparadex/mcp-paradex-py paradex_filters_model '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-paradex.run.tools`

**Optional config:**
- `paradexEnvironment` (query) — The Paradex environment (testnet or prod)
- `paradexAccountPrivateKey` (query) — Your Paradex account private key

## Tools (16)

- `paradex_filters_model`
- `paradex_markets`
- `paradex_market_summaries`
- `paradex_funding_data`
- `paradex_orderbook`
- `paradex_klines`
- `paradex_trades`
- `paradex_bbo`
- `paradex_system_config`
- `paradex_system_state`
- `paradex_vaults`
- `paradex_vault_balance`
- `paradex_vault_summary`
- `paradex_vault_transfers`
- `paradex_vault_positions`
- `paradex_vault_account_summary`

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get tradeparadex/mcp-paradex-py <tool-name>
```

## Resources

- `paradex://markets`
- `paradex://system/config`
- `paradex://system/time`
- `paradex://system/state`
- `paradex://vaults`
- `paradex://vaults/config`

## Prompts (11)

- `getting_started` — Welcome prompt showing auth status and available capabilities
- `market_overview` (volume_threshold, price_change_threshold) — Get a brief overview of the crypto market on Paradex
- `market_analysis` (market_id, timeframe, risk_percent, account_balance) — Concise analysis of a specific market with a position recommendation
- `position_management` (target_risk, max_correlation, profit_taking_strategy) — Review open positions and recommend actions
- `create_optimal_order` (market_id, side, risk_percent, urgency, order_type) — Generate optimized order parameters for a trade
- `hedging_strategy` (market_id, position_id, hedge_purpose, hedge_duration, hedge_percentage) — Design a hedge for an existing position
- `vault_analysis` (investment_objective, risk_tolerance, time_horizon) — Compare vaults and recommend top picks
- `portfolio_risk_assessment` (max_concentration, target_var, stress_scenario) — Assess portfolio risk and flag top issues
- `funding_rate_opportunity` (timeframe, min_annual_yield, risk_percent, strategy_preference) — Find funding rate opportunities above a yield threshold
- `liquidation_protection` (safety_threshold_hours, max_liquidation_probability, risk_tolerance) — Check positions for liquidation risk and provide protective actions
- `trading_consultation` — Interactive trading consultation prompt sequence