Skip to main content
Glama
MCP Paradex Server

MCP Paradex Server

by sv

MCP パラデックス サーバー

鍛冶屋のバッジ

Paradex 取引プラットフォーム用のモデル コンテキスト プロトコル (MCP) サーバー実装。

概要

このプロジェクトは、AIアシスタント(Claudeなど)とParadexの無期限先物取引プラットフォームとの橋渡しを行います。MCP標準を使用することで、AIアシスタントは以下のことが可能になります。

  • Paradexから市場データを取得する

  • 取引口座と金庫の管理

  • 注文の発注と管理

  • 位置とバランスを監視する

Related MCP server: MCP Paradex Server

前提条件

  • Python 3.10以上

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の mcp-paradex-py を自動的にインストールするには:

npx -y @smithery/cli install @sv/mcp-paradex-py --client claude

uv を使用する(より高速な代替手段)

  1. このリポジトリをクローンします:

    git clone https://github.com/sv/mcp-paradex-py.git
    cd mcp-paradex-py
  2. 仮想環境を作成します。

    uv venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  3. 依存関係をインストールします:

   uv pip install -e .

構成

設定をセットアップします。

cp .env.template .env

次に、Paradex の資格情報を使用して.envファイルを編集します。

サーバーの実行

Docker(推奨)

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 サーバーは、MCP サーバーを検出および展開するためのプラットフォームであるSmithery.aiと互換性があります。

クロードデスクトップ構成

Smithery.ai 経由で Claude Desktop でこのサーバーを使用するには:

  1. Claudeデスクトップを開き、メニューから開発者モードを有効にします

  2. 「設定」>「開発者」に移動し、「設定を編集」をクリックします。

  3. claude_desktop_config.jsonに次の構成を追加します。

{
  "mcpServers": {
    "paradex": {
      "command": "uvx",
      "args": ["--with-editable", ".", "mcp-paradex"],
      "env": {
        "PARADEX_ENVIRONMENT": "testnet",
        "PARADEX_ACCOUNT_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}
  1. your_ethereum_private_keyを実際の Paradex 秘密鍵に置き換えます。

  2. ファイルを保存し、Claude Desktopを再起動します。

Smithery.ai レジストリ

サーバーには、Smithery.ai レジストリのメタデータを含むsmithery.yamlファイルが含まれています。このサーバーを 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 - Paradexから利用可能な市場のリストを取得します

  • paradex://market/summary/{market_id} - 特定の取引ペアの詳細な市場情報を取得します

Vaultリソース

  • paradex://vaults - Paradex で利用可能なすべてのボールトを一覧表示します

  • paradex://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 - グローバル Paradex システム構成を取得します

  • paradex_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 - Paradexで新しい注文を作成する

  • paradex_cancel_orders - 既存の注文をキャンセルする

  • paradex_order_status - 注文のステータスを取得する

  • paradex_orders_history - アカウントの過去の注文を取得する

Vaultツール

  • paradex_vaults - フィルタリングオプションを使用して、特定のボールトまたはすべてのボールトに関する詳細情報を取得します。

  • paradex_vaults_config - 手数料、制限、その他の設定を含む金庫のグローバル構成を取得します

  • paradex_vault_balance - 利用可能/ロックされた資金情報を含む金庫の現在の残高を取得します

  • paradex_vault_summary - 金庫のパフォーマンス、バランス、アクティビティの包括的な概要を取得します

  • paradex_vault_transfers - 金庫の入出金履歴を取得する

  • paradex_vault_positions - 市場、サイズ、エントリー価格の詳細を含む、金庫の現在の取引ポジションを取得します

  • paradex_vault_account_summary - マージンとリスクの指標を含む金庫の取引口座情報を取得します

取引分析プロンプト

この MCP サーバーは、AI アシスタントが複雑な取引分析を実行し、取引戦略を生成するために使用できる構造化されたプロンプトを提供します。

市場分析

  • market_overview - 暗号通貨市場の包括的な概要(上昇/下落銘柄、高取引市場、資金調達率の異常、市場構造分析など)を取得します。

  • market_analysis - 特定の市場の詳細な技術的および微細構造分析(サポート/レジスタンスレベル、チャートパターン、注文書分析、ポジション推奨を含む)

ポジションとポートフォリオ管理

  • position_management - ポートフォリオのヒート、相関、リスク指標、利益確定と損失管理に関する具体的な推奨事項など、既存のポジションの包括的な分析

  • create_optimal_order - ボラティリティ、流動性、リスク許容度、理想的なエントリー戦略に基づいて、市場に最適な注文パラメータを設計します

  • hedging_strategy - 相関分析、ヘッジ比率計算、実装計画を使用して、特定のポジションに効果的なヘッジ戦略を開発します。

  • portfolio_risk_assessment - エクスポージャー分析、相関評価、VaR計算、リスク削減の推奨など、トレーディングポートフォリオの徹底的なリスク分析

  • liquidation_protection - 重大度分類と保護戦略を使用して、オープンポジションの清算リスクを特定し、軽減します。

投資戦略

  • vault_analysis - 投資判断のための金庫の包括的な分析(パフォーマンス指標、リスクプロファイル、適合性評価を含む)

  • funding_rate_opportunity - 利回り計算や実装戦略など、市場全体で資金調達レート裁定の機会を特定し評価します。

  • trading_consultation - パーソナライズされた取引アドバイスと相談のためのインタラクティブなプロンプトシーケンス

ドキュメントMCP

Paradexドキュメントへのクライアントアクセスを提供することで、大幅に改善された結果が得られました。

"paradex-docs-mcp": {
   "command": "uvx",
   "args": [
      "--from",
      "mcpdoc",
      "mcpdoc",
      "--urls",
      "Paradex:https://docs.paradex.trade/llms.txt",
      "--transport",
      "stdio"
   ]
}

貢献

このプロジェクトへの貢献方法、開発のセットアップ、コーディング標準については、 CONTRIBUTING.md をご覧ください。

ライセンス

MITライセンス

Available Tools

16 tools
paradex_bboA
Read-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_modelA
Read-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_dataA
Read-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_klinesA
Read-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_marketsA
Read-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_summariesA
Read-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_orderbookA
Read-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_configA
Read-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_stateA
Read-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_tradesA
Read-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_summaryA
Read-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_balanceA
Read-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_positionsA
Read-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_vaultsA
Read-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_summaryA
Read-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_transfersA
Read-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

    A3.9/5.0

    Scored across 16 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      8
      MIT
    • A
      license
      A
      quality
      Not graded
      maintenance
      A bridge between AI assistants and the Paradex perpetual futures trading platform that enables retrieving market data, managing trading accounts, placing orders, and monitoring positions.
      26
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A 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.
      33
      92 PyPI
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server for the Hyperliquid decentralized exchange, enabling AI assistants to perform trading operations, manage accounts, and retrieve market data.
      38 PyPI
      3
      MIT