How do I use WOOFi Pro MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@WOOFi Pro MCP Server show me my current open positions and account balance" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

🚀 WOOFi Pro MCP Server

License: MIT TypeScript

A Model Context Protocol (MCP) server providing 40 comprehensive trading tools for WOOFi Pro and Orderly Network integration. Built for universal compatibility with Cursor IDE, Claude Desktop, Windsurf, and all MCP-compatible applications.

✨ Features

🎯 Platform-Specific Configuration: Smithery-style commands for precise MCP client targeting
40 Trading Tools: Complete suite for DeFi and derivatives trading
Orderly Network API: Direct integration with institutional-grade infrastructure
Universal Compatibility: Works with Cursor, Claude Desktop, Windsurf, and all MCP clients
Flexible Setup: Auto-config, .env files, OR direct config - all methods supported
CCXT-Style Security: API keys never hardcoded in our repo, always user-provided
Automatic Authentication: Seamless ed25519 signature-based auth
Multi-Platform Support: Claude Desktop, Cursor IDE, VSCode, and Windsurf
Safe Config Management: Creates backups before making any changes

🎯 Available Tools (40 Total)

Category	Count	Tools	Description
Account	3	`get_account_info`, `get_positions`, `get_orders`	Account information and key details
Orders	18	`create_order`, `batch_create_orders`, `edit_order`, `cancel_order`, `cancel_order_by_client_id`, `cancel_all_pending_orders`, `cancel_all_after`, `get_orders`, `get_order_by_id`, `get_order_by_client_id`, `create_algo_order`, `edit_algo_order`, `cancel_algo_order`, `cancel_algo_order_by_client_id`, `cancel_all_pending_algo_orders`, `get_algo_orders`, `get_algo_order_by_id`, `get_algo_order_by_client_id`	Complete order management and execution
Assets	8	`get_asset_history`, `get_holdings`, `create_withdraw_request`, `get_settle_pnl_nonce`, `request_pnl_settlement`, `get_pnl_settlement_history`, `create_internal_transfer`, `get_internal_transfer_history`	Asset operations, PnL settlement, and transfers
Positions	3	`get_all_positions`, `get_position_by_symbol`, `get_position_history`	Position tracking and management
Liquidations	6	`get_liquidated_positions`, `get_liquidations`, `get_positions_under_liquidation`, `claim_liquidated_positions`, `claim_insurance_fund`, `get_insurance_fund`	Liquidation monitoring and claims
Funding	1	`get_funding_fee_history`	Funding rate data and history

🚀 Quick Setup

🎯 Option A: Auto-Configuration (Recommended)

Choose your platform and configure instantly - Smithery-style commands:

Claude Desktop:

npx -y git+https://github.com/DaunteEth/woofi-pro-mcp woofi-pro \ --client claude \ --api-key=your_orderly_api_key_here \ --secret-key=your_orderly_secret_key_here \ --account-id=your_account_id_here

Cursor IDE:

npx -y git+https://github.com/DaunteEth/woofi-pro-mcp woofi-pro \ --client cursor \ --api-key=your_orderly_api_key_here \ --secret-key=your_orderly_secret_key_here \ --account-id=your_account_id_here

VSCode:

npx -y git+https://github.com/DaunteEth/woofi-pro-mcp woofi-pro \ --client vscode \ --api-key=your_orderly_api_key_here \ --secret-key=your_orderly_secret_key_here \ --account-id=your_account_id_here

Windsurf:

npx -y git+https://github.com/DaunteEth/woofi-pro-mcp.git woofi-pro \ --client windsurf \ --api-key=your_orderly_api_key_here \ --secret-key=your_orderly_secret_key_here \ --account-id=your_account_id_here

What this does:

🎯 Targets specific platform - Configure exactly what you want
📋 Creates backups of existing configurations
⚙️ Updates your MCP config with WOOFi Pro server + credentials
✅ Ready to use immediately - just restart your MCP application!

🟦 Option B: .env File Method

Step 1: Create .env file

cp .env.example .env # Edit .env with your credentials

Step 2: Simple config (any platform)

{ "mcpServers": { "woofi-pro": { "command": "npx", "args": [ "-y", "git+https://github.com/DaunteEth/woofi-pro-mcp", "woofi-pro" ] } } }

🟩 Option C: Direct Config Method

Add credentials directly to your MCP config:

Claude Desktop (macOS:

{ "mcpServers": { "woofi-pro": { "command": "npx", "args": [ "-y", "git+https://github.com/DaunteEth/woofi-pro-mcp", "woofi-pro" ], "env": { "WOOFI_API_KEY": "your_orderly_api_key_here", "WOOFI_SECRET_KEY": "your_orderly_secret_key_here", "WOOFI_ACCOUNT_ID": "your_account_id_here" } } } }

Cursor IDE (

{ "mcpServers": { "woofi-pro": { "command": "npx", "args": [ "-y", "git+https://github.com/DaunteEh/execution-agent.git", "woofi-pro" ], "env": { "WOOFI_API_KEY": "your_orderly_api_key_here", "WOOFI_SECRET_KEY": "your_orderly_secret_key_here", "WOOFI_ACCOUNT_ID": "your_account_id_here" } } } }

🔧 API Credentials Setup

🔑 Get API Credentials

Visit: WOOFi Pro
Complete KYC: Identity verification required
Generate API Keys: API Management → Create API keys
Set Permissions: Enable read and trading permissions
Copy Credentials: You'll need 3 values:
- API Key
- Secret Key
- Account ID

📁 .env File Template

# WOOFi Pro API Credentials (Required) WOOFI_API_KEY=your_orderly_api_key_here WOOFI_SECRET_KEY=your_orderly_secret_key_here WOOFI_ACCOUNT_ID=your_account_id_here

🔒 Security Architecture

✅ Non-Sensitive (Hardcoded)

The following standard values are hardcoded for simplicity and are not sensitive:

WOOFI_BASE_ENDPOINT=https://api.orderly.org - Public API endpoint
WOOFI_BROKER_ID=woofi_pro - Standard broker identifier
WOOFI_CHAIN_ID=42161 - Arbitrum network chain ID

🔑 Sensitive (User-Provided)

These values must be provided by you and are never hardcoded:

WOOFI_API_KEY - Your unique API key
WOOFI_SECRET_KEY - Your private secret key
WOOFI_ACCOUNT_ID - Your account identifier

🛡️ Security Features

🔒 Zero hardcoded secrets - Following 2025 MCP security best practices
📁 .env files gitignored - Secrets never committed to version control
🔐 Automatic .env loading - Server finds .env in working directory
✅ Input validation - All parameters validated with Zod schemas
🏗️ Separation of concerns - Public constants separate from private credentials

💡 Usage Examples

Check Account Status

// Get account information await get_account_info({}); // View all positions await get_all_positions({});

Place Orders

// Market buy order await create_order({ symbol: "PERP_BTC_USDC", side: "BUY", order_type: "MARKET", order_quantity: 0.001 }); // Limit sell order await create_order({ symbol: "PERP_ETH_USDC", side: "SELL", order_type: "LIMIT", order_price: 3500, order_quantity: 0.1 });

Advanced Features

// PnL Settlement await get_settle_pnl_nonce({}); await request_pnl_settlement({ signature: "0x...", userAddress: "0x...", // ... EIP-712 signature data }); // Liquidation Claims await claim_liquidated_positions({ liquidation_id: 12345, // ... liquidation claim data });

🔄 Natural Language Commands

Account & Portfolio

"Show me my account balance"
"What are my current positions?"
"Get my asset transaction history"
"Check my PnL settlement history"

Trading

"Place a market buy order for 0.001 BTC"
"Create a limit sell order for 0.1 ETH at $3500"
"Cancel order ID 12345"
"Show me my recent orders"
"Create a batch of orders"

Advanced Operations

"Get my settle PnL nonce"
"Show me liquidated positions"
"Check funding fee history for BTC"
"Create an internal transfer"

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

WOOFi Pro: https://pro.woo.org
Orderly Network: https://orderly.network
Documentation: https://orderly.network/docs
GitHub Repository: https://github.com/DaunteEth/execution-agent

⚡ Ready to trade? Follow the quick setup above and start trading with natural language!

WOOFi Pro MCP Server