{ "markdown": "# MCP Paradex Server\n\n\n\n[![smithery badge](https://smithery.ai/badge/tradeparadex/mcp-paradex-py)](https://smithery.ai/servers/tradeparadex/mcp-paradex-py)\n\nModel Context Protocol (MCP) server implementation for the Paradex trading platform.\n\n\n \"Paradex\n\n\n## Quickstart\n\nNew here? See the **[Quickstart Guide](docs/quickstart.md)** for step-by-step setup instructions for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Claude.ai web, and ChatGPT.\n\nNeed a remote HTTP endpoint for ChatGPT or Claude.ai web? See the **[HTTP Deployment Guide](docs/deploy-http.md)** for Railway, Render, Fly.io, AWS Lambda, and Docker/VPS options.\n\n## Overview\n\nThis project provides a bridge between AI assistants (like Claude) and\nParadex, a privacy-preserving multi-asset exchange on Starknet with spot,\nperpetuals, options, and commodity futures. Using the MCP standard,\nAI assistants can:\n\n- Retrieve market data from Paradex\n- Manage trading accounts and vaults\n- Place and manage orders\n- Monitor positions and balance\n\n## Prerequisites\n\n- Python 3.10+\n- [uv](https://docs.astral.sh/uv/getting-started/installation/) — required for the `uvx` run method\n\n > **macOS:** Install via `brew install uv` so the binary lands in `/usr/local/bin`, which GUI apps like Claude Desktop can find. The curl-pipe install puts uv in `~/.local/bin`, which GUI apps cannot see.\n\n## Installation\n\n### Quick Start\n\n#### Cursor IDE\n\nClick to automatically configure this MCP server in Cursor:\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=paradex&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJtY3AtcGFyYWRleCJdLCJlbnYiOnsiUEFSQURFWF9FTlZJUk9OTUVOVCI6InRlc3RuZXQiLCJQQVJBREVYX0FDQ09VTlRfUFJJVkFURV9LRVkiOiJ5b3VyX3ByaXZhdGVfa2V5In19Cg%3D%3D)\n\n#### Claude Code CLI\n\n```bash\nclaude mcp add paradex uvx mcp-paradex\n```\n\n#### Smithery (Claude Desktop)\n\n```bash\nnpx -y @smithery/cli@latest mcp add @tradeparadex/mcp-paradex-py --client claude\n```\n\n### Standard Installation\n\n#### PyPI\n\n```bash\npip install mcp-paradex\n```\n\n#### uvx (Recommended)\n\n```bash\nuvx mcp-paradex\n```\n\n### Development Setup\n\n1. Clone the repository:\n\n ```bash\n git clone https://github.com/tradeparadex/mcp-paradex-py.git\n cd mcp-paradex-py\n ```\n\n2. Install development dependencies:\n\n ```bash\n uv sync --dev --all-extras\n ```\n\n3. Run locally:\n\n ```bash\n uv run mcp-paradex\n ```\n\n## Configuration\n\n### Environment Variables\n\nSet these environment variables for authentication:\n\n- `PARADEX_ENVIRONMENT`: Set to `prod`, `testnet`, or `nightly` (default: `prod`)\n- `PARADEX_ACCOUNT_PRIVATE_KEY`: Your Paradex account private key\n\n### Using .env File\n\n```bash\ncp .env.template .env\n# Edit .env with your credentials\n```\n\n### Client Configuration\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"paradex\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-paradex\"],\n \"env\": {\n \"PARADEX_ENVIRONMENT\": \"testnet\",\n \"PARADEX_ACCOUNT_PRIVATE_KEY\": \"your_private_key\"\n }\n }\n }\n}\n```\n\n#### Docker (local / stdio)\n\n```bash\n# Build image\ndocker build . -t tradeparadex/mcp-paradex-py\n\n# Run (public only)\ndocker run --rm -i tradeparadex/mcp-paradex-py\n\n# Run with trading capabilities\ndocker run --rm -e PARADEX_ACCOUNT_PRIVATE_KEY=your_key -i tradeparadex/mcp-paradex-py\n```\n\n#### Docker (AWS Lambda / HTTP)\n\nUse `Dockerfile.aws` for remote deployments via AWS Lambda with the\n[Lambda Web Adapter](https://github.com/awslabs/aws-lambda-web-adapter).\nThe adapter bridges Lambda invocations to the server's HTTP endpoint,\nso no Lambda-specific code is needed.\n\n```bash\n# Build\ndocker build -f Dockerfile.aws -t tradeparadex/mcp-paradex-py-aws .\n\n# Test locally (mirrors Lambda config)\ndocker run --rm -p 8080:8080 \\\n -e MCP_TRANSPORT=streamable-http \\\n -e MCP_STATELESS=true \\\n -e MCP_PORT=8080 \\\n -e PARADEX_ENVIRONMENT=prod \\\n tradeparadex/mcp-paradex-py-aws\n```\n\nThe server will be available at `http://localhost:8080/mcp`.\n\n**Deploying to Lambda:**\n\n1. Push the image to ECR\n2. Create a Lambda function from the container image\n3. Set the Lambda Function URL invoke mode to `RESPONSE_STREAM`\n4. Set environment variables on the Lambda function:\n - `MCP_TRANSPORT=streamable-http`\n - `MCP_STATELESS=true`\n - `PARADEX_ENVIRONMENT=prod` (or `testnet`)\n - `PARADEX_ACCOUNT_PRIVATE_KEY=your_key` (optional, for trading)\n\n## Available Resources and Tools\n\n### Resources\n\n#### System Resources\n\n- `paradex://system/config` - Get Paradex system configuration\n- `paradex://system/time` - Get current system time\n- `paradex://system/state` - Get system operational state\n\n#### Market Resources\n\n- `paradex://markets` - List of available markets\n- `paradex://market/summary/{market_id}` - Detailed market information\n\n#### Vault Resources\n\n- `paradex://vaults` - List all vaults\n- `paradex://vaults/config` - Global vault configuration\n- `paradex://vaults/balance/{vault_id}` - Vault balance\n- `paradex://vaults/summary/{vault_id}` - Comprehensive vault summary\n- `paradex://vaults/transfers/{vault_id}` - Deposit/withdrawal history\n- `paradex://vaults/positions/{vault_id}` - Current trading positions\n- `paradex://vaults/account-summary/{vault_id}` - Trading account information\n\n### Tools\n\n#### System Tools\n\n- `paradex_system_config` - Get global system configuration\n- `paradex_system_state` - Get current system state\n\n#### Market Tools\n\n- `paradex_markets` - Get detailed market information\n- `paradex_market_summaries` - Get market summaries with metrics\n- `paradex_funding_data` - Get historical funding rate data\n- `paradex_orderbook` - Get current orderbook with customizable depth\n- `paradex_klines` - Get historical candlestick data\n- `paradex_trades` - Get recent trades\n- `paradex_bbo` - Get best bid and offer\n\n#### Account Tools\n\n- `paradex_account_summary` - Get account summary\n- `paradex_account_positions` - Get current positions\n- `paradex_account_fills` - Get trade fills\n- `paradex_account_funding_payments` - Get funding payments\n- `paradex_account_transactions` - Get transaction history\n\n#### Order Tools\n\n- `paradex_open_orders` - Get all open orders\n- `paradex_create_order` - Create new order\n- `paradex_cancel_orders` - Cancel existing orders\n- `paradex_order_status` - Get order status\n- `paradex_orders_history` - Get historical orders\n\n#### Vault Tools\n\n- `paradex_vaults` - Get detailed vault information\n- `paradex_vaults_config` - Get global vault configuration\n- `paradex_vault_balance` - Get vault balance\n- `paradex_vault_summary` - Get comprehensive vault summary\n- `paradex_vault_transfers` - Get deposit/withdrawal history\n- `paradex_vault_positions` - Get current vault positions\n- `paradex_vault_account_summary` - Get vault trading account info\n\n## Trading Analysis Prompts\n\n### Market Analysis\n\n- `market_overview` - Comprehensive crypto market overview\n- `market_analysis` - Detailed technical and microstructure analysis\n\n### Position and Portfolio Management\n\n- `position_management` - Comprehensive position analysis\n- `create_optimal_order` - Design optimal order parameters\n- `hedging_strategy` - Develop effective hedging strategies\n- `portfolio_risk_assessment` - Thorough portfolio risk analysis\n- `liquidation_protection` - Identify and mitigate liquidation risks\n\n### Investment Strategies\n\n- `vault_analysis` - Comprehensive vault analysis for investment decisions\n- `funding_rate_opportunity` - Identify funding rate arbitrage opportunities\n- `trading_consultation` - Interactive trading advice and consultation\n\n## Documentation MCP\n\nEnhanced results with Paradex documentation access:\n\n```json\n\"paradex-docs-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\n \"--from\",\n \"mcpdoc\",\n \"mcpdoc\",\n \"--urls\",\n \"Paradex:https://docs.paradex.trade/llms.txt\",\n \"--transport\",\n \"stdio\"\n ]\n}\n```\n\n## Contributing\n\nPlease see [CONTRIBUTING.md](CONTRIBUTING.md) for information on how to\ncontribute to this project, development setup, and our coding standards.\n\n## License\n\n[MIT License](LICENSE)\n", "bytes": 8282, "sha": "27d6a1b7cd83e2e680484ed42b3c185a9f8cb2dd7f0deb67123c0b02313bc587", "repo_slug": "tradeparadex/mcp-paradex-py", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_tradeparadex_mcp_paradex_py_7390f586/readme" }