tradeparadex avatar

Paradex Trading

tradeparadex/mcp-paradex-py

Connects Claude to Paradex, a Starknet-based perpetuals exchange. Exposes market data queries (orderbook depth, klines, funding rates, best bid/offer), account management (positions, fills, funding payments), and live trading operations (create orders, cancel orders, check status). Also surfaces vault resources for balance checks, transfer history, and position tracking. Useful when you need Claude to monitor perp positions, analyze funding rate arb opportunities, or execute trades directly on Paradex. Ships with pre-built prompts for portfolio risk assessment and liquidation protection. Supports testnet and prod environments via private key auth.

GitHub stars
2
tools
16
auth
Secret needed
transport
STDIO
env vars
2
last updated
Mar 3, 2026

Tools

16 tools

Public tool metadata for what this MCP can expose to an agent.

paradex_filters_modelGet 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 soph...1 params

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 soph...

Parameters* required
tool_namestring
The name of the tool to get the filters for.
paradex_marketsFind 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 cont...4 params

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 cont...

Parameters* required
jmespath_filterstring
JMESPath expression to filter, sort, or limit the results.default:
limitinteger
Limit the number of results to the specified number.default: 10
market_idsarray
Market symbols to get details for.
offsetinteger
Offset the results to the specified number.default: 0
paradex_market_summariesIdentify 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...4 params

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...

Parameters* required
jmespath_filterstring
JMESPath expression to filter, sort, or limit the results.
limitinteger
Limit the number of results to the specified number.default: 10
market_idsarray
Market symbols to get summaries for.
offsetinteger
Offset the results to the specified number.default: 0
paradex_funding_dataAnalyze 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...3 params

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...

Parameters* required
end_unix_msinteger
End time in unix milliseconds.
market_idstring
Market symbol to get funding data for.
start_unix_msinteger
Start time in unix milliseconds.
paradex_orderbookAnalyze 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 fi...2 params

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 fi...

Parameters* required
depthinteger
The depth of the orderbook to retrieve.default: 10
market_idstring
Market symbol to get orderbook for.
paradex_klinesAnalyze 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, o...4 params

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, o...

Parameters* required
end_unix_msinteger
End time in unix milliseconds.
market_idstring
Market symbol to get klines for.
resolutioninteger
The time resolution of the klines.one of 1 · 3 · 5 · 15 · 30 · 60default: 1
start_unix_msinteger
Start time in unix milliseconds.
paradex_tradesAnalyze 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 - Moni...3 params

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 - Moni...

Parameters* required
end_unix_msinteger
End time in unix milliseconds.
market_idstring
Market symbol to get trades for.
start_unix_msinteger
Start time in unix milliseconds.
paradex_bboGet 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 sna...1 params

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 sna...

Parameters* required
market_idstring
Market symbol to get BBO for.
paradex_system_configUnderstand 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 chan...

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 chan...

No parameter schema in public metadata yet.

paradex_system_stateVerify 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 i...

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 i...

No parameter schema in public metadata yet.

paradex_vaultsGet 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 t...4 params

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 t...

Parameters* required
jmespath_filterstring
JMESPath expression to filter, sort, or limit the results.
limitinteger
Limit the number of results to the specified number.default: 10
offsetinteger
Offset the results to the specified number.default: 0
vault_addressstring
The address of the vault to get details for or empty string to get all vaults.default:
paradex_vault_balanceGet 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.1 params

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.

Parameters* required
vault_addressstring
The address of the vault to get balance for.
paradex_vault_summaryGet 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 c...4 params

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 c...

Parameters* required
jmespath_filterstring
JMESPath expression to filter or transform the result.
limitinteger
Limit the number of results to the specified number.default: 10
offsetinteger
Offset the results to the specified number.default: 0
vault_addressstring
The address of the vault to get summary for or None to get all vaults.
paradex_vault_transfersTrack 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...1 params

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...

Parameters* required
vault_addressstring
The address of the vault to get transfers for.
paradex_vault_positionsMonitor 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 siz...1 params

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 siz...

Parameters* required
vault_addressstring
The address of the vault to get positions for.
paradex_vault_account_summaryGet 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...1 params

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...

Parameters* required
vault_addressstring
The address of the vault to get account summary for.

Sponsors

Configuration

PARADEX_ACCOUNT_PRIVATE_KEYsecret

Ethereum private key for your Paradex account (enables trading). Without this, only public market data is accessible.

PARADEX_ENVIRONMENT

Paradex environment to connect to. Defaults to 'prod'. Use 'testnet' for testing.

Readme

MCP Paradex Server

smithery badge

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

Paradex Server MCP server

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:


View the full README on GitHub

Details

Repository
github.com/tradeparadex/mcp-paradex-py
Categories
Data & Analytics, Finance & Commerce
Package
mcp-paradex
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Data & Analytics MCP servers

View all
1tschoonj avatarXraylib Mcp Servertschoonj/xraylib-mcp-serverMCP server providing X-ray interaction data via xraylib2stars
2xerno42 avatarHelldivers2 Mcpxerno42/helldivers2-mcpMCP server exposing live Helldivers 2 galactic war data.2stars
3adelaidasofia avatarMulti-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, tokenadelaidasofia/google-workspace-mcpMulti-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token-efficient, macOS…1stars
4anomalyarmor avatarAnomalyArmoranomalyarmor/agentsData observability tools for engineering teams: alerts, freshness, schema drift, lineage, quality.0stars
5boolsai-ai avatarBoolsai Scanboolsai-ai/mcpLive tech-stack scan of any public site — vendors, account IDs, scripts, JSON-LD. 2 tools.0stars
6trendsmcp-ai avatarYouTube Trends MCPtrendsmcp-ai/youtube-trends-mcpYouTube search interest and trend data over time, with growth metrics. Free key at trendsmcp.ai1stars