Skip to main content
Glama
MCP Paradex Server

MCP Paradex Server

by sv

MCP Paradex 서버

대장간 배지

Paradex 거래 플랫폼을 위한 MCP(Model Context Protocol) 서버 구현.

개요

이 프로젝트는 클로드와 같은 AI 비서와 파라덱스(Paradex)의 영구 선물 거래 플랫폼을 연결하는 다리 역할을 합니다. MCP 표준을 사용하여 AI 비서는 다음과 같은 작업을 수행할 수 있습니다.

  • Paradex에서 시장 데이터 검색

  • 거래 계좌 및 금고 관리

  • 주문하기 및 관리하기

  • 위치와 균형을 모니터링하세요

Related MCP server: MCP Paradex Server

필수 조건

  • 파이썬 3.10+

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-paradex-py를 자동으로 설치하려면:

지엑스피1

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 Desktop을 열고 메뉴에서 개발자 모드를 활성화하세요.

  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 - epoch 이후 현재 시스템 시간을 밀리초 단위로 가져옵니다.

  • paradex://system/state - 현재 Paradex 시스템 운영 상태를 가져옵니다.

시장 자원

  • paradex://markets - Paradex에서 사용 가능한 시장 목록을 가져옵니다.

  • paradex://market/summary/{market_id} - 특정 거래 쌍에 대한 자세한 시장 정보를 얻습니다.

볼트 리소스

  • 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 - 계정의 과거 주문 내역 가져오기

볼트 도구

  • 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