MCP Paradex Server
MCP Paradex Сервер
Реализация сервера Model Context Protocol (MCP) для торговой платформы Paradex.
Обзор
Этот проект обеспечивает мост между помощниками ИИ (такими как Клод) и платформой торговли бессрочными фьючерсами Paradex. Используя стандарт MCP, помощники ИИ могут:
Получить рыночные данные из Paradex
Управляйте торговыми счетами и хранилищами
Размещение и управление заказами
Мониторинг позиций и баланса
Related MCP server: MCP Paradex Server
Предпосылки
Питон 3.10+
Установка
Установка через Smithery
Чтобы автоматически установить mcp-paradex-py для Claude Desktop через Smithery :
npx -y @smithery/cli install @sv/mcp-paradex-py --client claudeИспользование УФ (более быстрая альтернатива)
Клонируйте этот репозиторий:
git clone https://github.com/sv/mcp-paradex-py.git cd mcp-paradex-pyСоздайте виртуальную среду:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activateУстановите зависимости:
uv pip install -e .Конфигурация
Настройте свою конфигурацию:
cp .env.template .envЗатем отредактируйте файл .env , используя ваши учетные данные Paradex.
Запуск сервера
Докер (рекомендуется)
docker build . -t sv/mcp-paradex-pyВ курсоре добавьте MCP как команду
Только для публики
docker run --rm -i sv/mcp-paradex-pyРазрешить торговлю
docker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=0xprivatekey -i sv/mcp-paradex-pyИнтеграция Smithery.ai
Этот сервер MCP совместим с Smithery.ai — платформой для обнаружения и развертывания серверов MCP.
Конфигурация рабочего стола Клода
Чтобы использовать этот сервер с Claude Desktop через Smithery.ai:
Откройте Claude Desktop и включите режим разработчика в меню.
Перейдите в «Настройки» > «Разработчик» и нажмите «Изменить конфигурацию».
Добавьте следующую конфигурацию в ваш
claude_desktop_config.json:
{
"mcpServers": {
"paradex": {
"command": "uvx",
"args": ["--with-editable", ".", "mcp-paradex"],
"env": {
"PARADEX_ENVIRONMENT": "testnet",
"PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
}
}
}
}Замените
your_ethereum_private_keyна ваш реальный закрытый ключ Paradex.Сохраните файл и перезапустите Claude Desktop.
Реестр Smithery.ai
Сервер включает файл smithery.yaml с метаданными для реестра Smithery.ai. Если вы хотите опубликовать этот сервер в Smithery.ai, вы можете использовать Smithery CLI:
# Install Smithery CLI
npm install -g @smithery/cli
# Login to Smithery
smithery login
# Publish the server
smithery publishДополнительную информацию о публикации в Smithery.ai см. в документации Smithery .
Доступные ресурсы и инструменты
Ресурсы
Системные ресурсы
paradex://system/config— получить конфигурацию системы Paradex и основную информацию об обменеparadex://system/time— Получить текущее системное время в миллисекундах с начала эпохиparadex://system/state— Получить текущее рабочее состояние системы Paradex
Ресурсы рынка
paradex://markets— Получите список доступных рынков от Paradexparadex://market/summary/{market_id}— Получите подробную информацию о рынке для определенной торговой пары
Ресурсы хранилища
paradex://vaults— список всех хранилищ, доступных на Paradexparadex://vaults/config— Получить глобальную конфигурацию для хранилищparadex://vaults/balance/{vault_id}- Получить баланс определенного хранилищаparadex://vaults/summary/{vault_id}— получите полную сводку по хранилищуparadex://vaults/transfers/{vault_id}- Получить историю депозитов и снятий для хранилищаparadex://vaults/positions/{vault_id}— Получить текущие торговые позиции для хранилищаparadex://vaults/account-summary/{vault_id}— Получить информацию о торговом счете для хранилища
Инструменты
Системные инструменты
paradex_system_config— Получить глобальную конфигурацию системы Paradexparadex_system_state— Получить текущее состояние системы
Инструменты рынка
paradex_markets— получите подробную информацию о рынках, включая базовые/котируемые активы, размер тика и другие торговые параметрыparadex_market_summaries— получайте сводки по цене, объему, 24-часовым изменениям и другим ключевым рыночным показателям.paradex_funding_data— Получите исторические данные по ставкам финансирования для бессрочных рынковparadex_orderbook— Получить текущую книгу заявок для рынка с настраиваемой глубинойparadex_klines— Получить исторические данные свечей (OHLCV) для рынкаparadex_trades— Получите последние сделки на рынке с информацией о цене, размере и временной меткеparadex_bbo- Получите лучшую цену покупки и продажи (самый узкий спред) для рынка
Инструменты для работы с аккаунтом
paradex_account_summary- Получить сводную информацию по счетуparadex_account_positions- Получить текущие позиции по счетуparadex_account_fills- Получить торговые заполнения счетаparadex_account_funding_payments- Получайте платежи по финансированию счетаparadex_account_transactions- Получить историю транзакций по счету
Заказать инструменты
paradex_open_orders— Получить все открытые заказы для аккаунтаparadex_create_order— создать новый заказ на Paradexparadex_cancel_orders- Отменить существующие заказыparadex_order_status- Получить статус заказаparadex_orders_history— Получить историю заказов для аккаунта
Инструменты хранилища
paradex_vaults— получите подробную информацию о конкретных хранилищах или обо всех хранилищах с возможностью фильтрацииparadex_vaults_config— получение глобальной конфигурации для хранилищ, включая комиссии, лимиты и другие настройки.paradex_vault_balance— Получить текущий баланс хранилища с информацией о доступных/заблокированных средствахparadex_vault_summary— получите полную сводку о производительности, балансе и активности хранилищаparadex_vault_transfers- Получить историю депозитов и снятий для хранилищаparadex_vault_positions— получение текущих торговых позиций для хранилища с подробной информацией о рынке, размере и цене входаparadex_vault_account_summary— получение информации о торговом счете для хранилища, включая показатели маржи и риска
Подсказки по торговому анализу
Этот сервер MCP предоставляет структурированные подсказки, которые помощники ИИ могут использовать для проведения сложного торгового анализа и создания торговых стратегий.
Анализ рынка
market_overview— получите полный обзор рынка криптовалют, включая лидеров роста/падения, рынки с высоким объемом, аномалии ставок финансирования и анализ микроструктуры рынка.market_analysis— подробный технический и микроструктурный анализ конкретного рынка с уровнями поддержки/сопротивления, графическими моделями, анализом книги ордеров и рекомендациями по позициям
Управление позициями и портфелем
position_management- комплексный анализ существующих позиций, включая теплоту портфеля, корреляцию, показатели риска и конкретные рекомендации по фиксации прибыли и управлению убыткамиcreate_optimal_order— разработка оптимальных параметров ордера для рынка на основе волатильности, ликвидности, толерантности к риску и идеальной стратегии входаhedging_strategy- Разработка эффективных стратегий хеджирования для конкретных позиций с использованием корреляционного анализа, расчета коэффициента хеджирования и планирования внедренияportfolio_risk_assessment- Тщательный анализ рисков торгового портфеля, включая анализ подверженности риску, оценку корреляции, расчеты VaR и рекомендации по снижению рисковliquidation_protection— выявление и снижение рисков ликвидации открытых позиций с помощью классификации серьезности и стратегий защиты
Инвестиционные стратегии
vault_analysis— комплексный анализ хранилищ для принятия инвестиционных решений с показателями производительности, профилями рисков и оценкой пригодностиfunding_rate_opportunity— выявление и оценка возможностей арбитража ставок финансирования на разных рынках, включая расчеты доходности и стратегии реализацииtrading_consultation— Интерактивная последовательность подсказок для персонализированных торговых советов и консультаций
Документация МКП
Мы увидели значительно лучшие результаты, предоставив клиентам доступ к документации Paradex.
"paradex-docs-mcp": {
"command": "uvx",
"args": [
"--from",
"mcpdoc",
"mcpdoc",
"--urls",
"Paradex:https://docs.paradex.trade/llms.txt",
"--transport",
"stdio"
]
}Внося вклад
Информацию о том, как внести свой вклад в этот проект, а также о настройках разработки и наших стандартах кодирования можно найти на сайте CONTRIBUTING.md .
Лицензия
Available Tools
16 toolsparadex_bboARead-only
Get the current best available prices for immediate execution decisions.
Use this tool when you need to:
- Make quick trading decisions without full orderbook depth
- Calculate current spread costs before placing orders
- Monitor real-time price changes efficiently
- Get a snapshot of current market conditions
- Determine fair mid-price for calculations
The BBO provides the most essential price information with minimal data,
perfect for quick decisions or when full orderbook depth isn't needed.
Example use cases:
- Calculating current trading spreads before placing orders
- Monitoring real-time price movements efficiently
- Determining execution prices for immediate market orders
- Calculating mid-price for order placement strategies
- Setting appropriate limit order prices to improve fill chances
Inputs: market_id (required).
paradex_filters_modelARead-only
Get detailed schema information to build precise data filters.
Use this tool when you need to:
- Understand exactly what fields are available for filtering
- Learn the data types and formats for specific fields
- Build complex JMESPath queries with correct syntax
- Create sophisticated filtering and sorting expressions
Knowing the exact schema helps you construct precise filters that
return exactly the data you need, avoiding trial and error.
Example use cases:
- Learning what fields exist in market data responses
- Finding the correct property names for filtering
- Understanding data types for numerical comparisons
- Building complex multi-criteria filters for large datasets
Inputs: tool_name (required).
paradex_funding_dataARead-only
Analyze funding rates for potential funding arbitrage or to understand holding costs.
Use this tool when you need to:
- Calculate expected funding payments for a position
- Find markets with extreme funding rates for potential arbitrage
- Understand historical funding patterns for a market
- Evaluate the cost of holding a position over time
This data is critical for perpetual futures traders to assess the carrying cost
of positions and identify potential funding arbitrage opportunities.
Example use cases:
- Finding markets with negative funding for "paid to hold" opportunities
- Calculating the funding component of a trade's P&L
- Comparing funding rates across different assets for relative value trades
- Analyzing funding rate volatility to predict potential rate changes
Inputs: market_id (required), start_unix_ms (required), end_unix_ms (required). Returns: object
paradex_klinesARead-only
Analyze historical price patterns for technical analysis and trading decisions.
Use this tool when you need to:
- Perform technical analysis on historical price data
- Identify support and resistance levels from price history
- Calculate indicators like moving averages, RSI, or MACD
- Backtest trading strategies on historical data
- Visualize price action over specific timeframes
Candlestick data is fundamental for most technical analysis and trading decisions,
providing structured price and volume information over time.
Example use cases:
- Identifying chart patterns for potential entries or exits
- Calculating technical indicators for trading signals
- Determining volatility by analyzing price ranges
- Finding significant price levels from historical support/resistance
- Measuring volume patterns to confirm price movements
Inputs: market_id (required), start_unix_ms (required), end_unix_ms (required), resolution. Returns: result
paradex_marketsARead-only
Find markets that match your trading criteria or get detailed market specifications.
Use this tool when you need to:
- Understand exact tick sizes and minimum order sizes before placing trades
- Find all markets for a specific asset (e.g., all BTC-based markets)
- Compare contract specifications across different markets
- Identify markets with specific characteristics for your trading strategy
Retrieves comprehensive details about specified markets, including
base and quote assets, tick size, minimum order size, and other
trading parameters. If "ALL" is specified or no market IDs are provided,
returns details for all available markets.
Example use cases:
- Finding the minimum order size for a new trade
- Identifying markets with the smallest tick size for precise entries
- Checking which assets are available for trading
`asset_kind` is the type of asset in the market. It can be `PERP` or `PERP_OPTION`.
You can use JMESPath expressions (https://jmespath.org/specification.html) to filter, sort, or limit the results.
Use the `paradex_filters_model` tool to get the filters for a tool.
Examples:
- Filter by base asset: "[?base_asset=='BTC']"
- Sort by 24h volume: "sort_by([*], &volume_24h)"
- Limit to top 5 by volume: "[sort_by([*], &to_number(volume_24h))[-5:]]"
Inputs: market_ids, jmespath_filter, limit, offset.
paradex_market_summariesARead-only
Identify the most active or volatile markets and get current market conditions.
Use this tool when you need to:
- Find the most active markets by volume for liquidity analysis
- Discover markets with significant price movements for momentum strategies
- Compare current prices across multiple assets
- Identify markets with unusual behavior for potential opportunities
Retrieves current market summary information including price, volume,
24h change, and other key market metrics. If "ALL" is specified or no market IDs
are provided, returns summaries for all available markets.
Example use cases:
- Finding high-volatility markets for short-term trading
- Identifying top gainers and losers for the day
- Comparing volume across different markets to find liquidity
- Getting the current price and 24-hour range for price analysis
You can use JMESPath expressions (https://jmespath.org/specification.html) to filter, sort, or limit the results.
Use the `paradex_filters_model` tool to get the filters for a tool.
Examples:
- Filter by high price: "[?high_price > `10000`]"
- Sort by volume: "sort_by([*], &volume)"
- Get top 3 by price change: "[sort_by([*], &to_number(price_change_percent))[-3:]]"
Inputs: market_ids, jmespath_filter, limit, offset.
paradex_orderbookARead-only
Analyze market depth and liquidity to optimize order entry and execution.
Use this tool when you need to:
- Assess true liquidity before placing large orders
- Identify potential support/resistance levels from order clusters
- Determine optimal limit order prices for higher fill probability
- Detect order imbalances that might signal price direction
Understanding the orderbook is essential for effective trade execution,
especially for larger orders or in less liquid markets.
Example use cases:
- Finding the optimal limit price to ensure your order gets filled
- Estimating potential slippage for market orders of different sizes
- Identifying large resting orders that might act as support/resistance
- Detecting order book imbalances that could predict short-term price moves
Inputs: market_id (required), depth. Returns: object
paradex_system_configARead-only
Understand the exchange's global parameters that affect all trading activity.
Use this tool when you need to:
- Check fee schedules before placing trades
- Verify trading limits and restrictions
- Understand exchange-wide parameters that affect your trading
- Keep up with changes to the exchange's configuration
This information provides important context for making trading decisions and
understanding how the exchange operates.
Example use cases:
- Checking current fee tiers for different markets
- Verifying maximum leverage available for specific markets
- Understanding global trading limits or restrictions
- Checking if any exchange-wide changes might affect your trading strategy
Inputs: no named parameters. Returns: starknet_gateway_url, starknet_fullnode_rpc_url, starknet_fullnode_rpc_base_url…
paradex_system_stateARead-only
Verify the exchange is fully operational before executing trades.
Use this tool when you need to:
- Check if Paradex is functioning normally before placing important orders
- Verify system status if you encounter unexpected behavior
- Confirm that maintenance periods are not in effect
- Check exchange clock synchronization with your own systems
This is especially important before executing critical trades or when
experiencing unexpected behavior from other API calls.
Example use cases:
- Verifying the exchange is operational before executing a trading strategy
- Checking if maintenance mode is active when experiencing delays
- Confirming exchange status during periods of market volatility
- Diagnosing API issues by checking system health
Inputs: no named parameters. Returns: Model representing the current state of the Paradex system.
paradex_tradesARead-only
Analyze actual market transactions to understand market sentiment and liquidity.
Use this tool when you need to:
- Detect large trades that might signal institutional activity
- Calculate average trade size during specific periods
- Identify buy/sell pressure imbalances
- Monitor execution prices vs. order book prices
- Understand market momentum through trade flow
Trade data provides insights into actual market activity versus just orders,
helping you understand how other participants are behaving.
Example use cases:
- Detecting large "whale" transactions that might influence price
- Analyzing trade sizes to gauge market participation
- Identifying periods of aggressive buying or selling
- Understanding trade frequency as an indicator of market interest
- Comparing executed prices to orderbook mid-price for market impact analysis
Inputs: market_id (required), start_unix_ms (required), end_unix_ms (required).
paradex_vault_account_summaryARead-only
Get a comprehensive overview of a vault's trading account status.
Use this tool when you need to:
- Check account health and available margin
- Monitor total exposure and leverage
- Understand risk metrics and account status
- Assess trading capacity before placing new orders
- Get a consolidated view of account performance
This provides essential information about account standing and
trading capacity to inform risk management decisions.
Example use cases:
- Checking available margin before placing new orders
- Monitoring account health during market volatility
- Assessing total exposure across all markets
- Understanding maintenance margin requirements
- Planning position adjustments based on account metrics
Inputs: vault_address (required). Returns: result
paradex_vault_balanceARead-only
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.
Inputs: vault_address (required). Returns: result
paradex_vault_positionsARead-only
Monitor active trading positions to track performance and manage risk.
Use this tool when you need to:
- Get a complete view of all open positions for a vault
- Monitor unrealized P&L across all positions
- Check liquidation prices and margin requirements
- Assess position sizing and leverage across markets
- Track entry prices and position duration
Position monitoring is fundamental to risk management and provides
the necessary information for trade management decisions.
Example use cases:
- Checking the current status of all open trades
- Monitoring unrealized profit/loss across positions
- Assessing liquidation risk during market volatility
- Comparing performance across different markets
- Planning adjustments to position sizes or leverage
Inputs: vault_address (required). Returns: result
paradex_vaultsARead-only
Get detailed information about a specific vault or all vaults if no address is provided.
Retrieves comprehensive details about a specific vault identified by its address,
including configuration, permissions, and other vault-specific parameters.
Use jmespath_filter to reduce the number of results as much as possible as number of vaults can be large.
You can use JMESPath expressions to filter, sort, or limit the results.
Examples:
- Filter by owner: "[?owner_account=='0x123...']"
- Filter by status: "[?status=='ACTIVE']"
- Find vaults with specific strategy: "[?contains(strategies, 'strategy_id')]"
- Sort by creation date: "sort_by([*], &created_at)"
- Limit to newest vaults: "sort_by([*], &created_at)[-5:]"
- Select specific fields: "[*].{address: address, name: name, kind: kind, status: status}"
Inputs: vault_address, jmespath_filter, limit, offset.
paradex_vault_summaryARead-only
Get a comprehensive summary of a specific vault or all vaults if no address is provided.
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.
Use jmespath_filter to reduce the number of results as much as possible as number of vaults can be large.
You can use JMESPath expressions to filter, sort, or transform the results.
Examples:
- Filter by TVL: "[?to_number(tvl) > `10000`]"
- Filter by performance: "[?to_number(total_roi) > `5.0`]"
- Sort by TVL (descending): "reverse(sort_by([*], &to_number(tvl)))"
- Get top performers: "sort_by([*], &to_number(total_roi))[-3:]"
- Filter by recent returns: "[?to_number(roi_24h) > `0.5`]"
- Extract specific metrics: "[*].{address: address, tvl: tvl, total_roi: total_roi, volume_24h: volume_24h}"
Inputs: vault_address, jmespath_filter, limit, offset.
paradex_vault_transfersARead-only
Track deposit and withdrawal history for auditing and reconciliation.
Use this tool when you need to:
- Verify deposits have completed and are available for trading
- Track withdrawal status and confirm transaction settlement
- Audit the complete fund flow history for a vault
- Reconcile on-chain transactions with platform records
- Understand historical capital allocation patterns
Complete transfer history is essential for proper accounting and provides
a clear audit trail of all capital movements.
Example use cases:
- Confirming that a recent deposit was credited to your account
- Tracking the status of pending withdrawals
- Creating transaction reports for accounting or tax purposes
- Verifying the total amount deposited over time
- Analyzing deposit/withdrawal patterns for strategy insights
Inputs: vault_address (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Each tool has a clearly distinct purpose. Market data tools (bbo, orderbook, klines, trades, markets, summaries, funding_data) cover different aspects. Vault tools (vault_account_summary, vault_balance, vault_positions, vaults, vault_summary, vault_transfers) each provide unique account information. System tools (system_config, system_state) and filters_model serve separate needs. No significant overlap.
All tool names follow the pattern 'paradex_' followed by a domain noun or compound noun (e.g., 'bbo', 'filters_model', 'vault_account_summary'). The naming structure is consistent, though some names use a single noun (e.g., 'paradex_markets') and others use multiple nouns (e.g., 'paradex_market_summaries'). This is a minor deviation from a strict pattern, but overall it is clear and predictable.
With 16 tools, the count is on the higher side for a data-oriented server, but each tool serves a distinct data retrieval purpose (market, system, vault). No tool seems superfluous. The number is appropriate for the scope of providing comprehensive read access to exchange data and account information.
The tool set is missing critical trading execution tools such as place_order, cancel_order, or modify_order. Given that the tools extensively support pre-trade analysis and account monitoring, the lack of order management creates a significant gap for actual trading. This suggests an incomplete surface for a server named 'Paradex Server'.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Trade Papertrade BTC and ETH perps from Claude, ChatGPT, Codex, Cursor and any MCP client.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
A Model Context Protocol server for Wix AI tools
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables LLMs to interact with cryptocurrency exchanges through CCXT, allowing for tasks like fetching balances, market data, creating orders, and trading operations in a standardized way.8MIT
- AlicenseAqualityNot gradedmaintenanceA bridge between AI assistants and the Paradex perpetual futures trading platform that enables retrieving market data, managing trading accounts, placing orders, and monitoring positions.26MIT
- AlicenseAqualityBmaintenanceA bridge between AI assistants and the Paradex perpetual futures trading platform for managing accounts, vaults, and orders. It enables users to retrieve real-time market data, monitor positions, and execute trading strategies through the Model Context Protocol.3392 PyPI2MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for the Hyperliquid decentralized exchange, enabling AI assistants to perform trading operations, manage accounts, and retrieve market data.38 PyPI3MIT