🚀 WOOFi Pro MCP Server
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: ~/Library/Application Support/Claude/claude_desktop_config.json)
{
"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 (.cursor/mcp.json)
{
"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
readandtradingpermissions - 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 endpointWOOFI_BROKER_ID=woofi_pro- Standard broker identifierWOOFI_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 keyWOOFI_SECRET_KEY- Your private secret keyWOOFI_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!