README.md
40 comprehensive trading tools for WOOFi Pro and Orderly Network integration
🚀 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
Tools (7)
create_orderExecute a new trading order on the platformget_positionsRetrieve current trading positions and account detailsget_account_infoGet account information and key detailscancel_all_pending_ordersCancel all currently active pending ordersget_holdingsView current asset holdings and balancesrequest_pnl_settlementRequest settlement of profit and lossget_funding_fee_historyRetrieve historical funding rate dataEnvironment Variables
WOOFI_API_KEYrequiredOrderly Network API KeyWOOFI_SECRET_KEYrequiredOrderly Network Secret KeyWOOFI_ACCOUNT_IDrequiredWOOFi Pro Account IDConfiguration
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"}}}}Try it
→What are my current open positions on WOOFi Pro?
→Create a limit order to buy 0.1 ETH at $2500
→Cancel all my pending orders immediately
→Show me my recent funding fee history
→What is my current account balance and PnL?