You set up the WOOFi Pro MCP Server to expose 40 trading tools via MCP, enabling seamless integration with your MCP clients such as Cursor IDE, Claude Desktop, Windsurf, and VSCode. This server handles account, orders, assets, positions, liquidations, and funding tools, with secure, automatic authentication and safe config management.

How to use

You interact with the MCP server through your MCP client by connecting to the server using the provided command line utilities. Start by configuring the client you use (Claude Desktop, Cursor IDE, VSCode, or Windsurf) with your API credentials and account identifier. Once connected, you can perform activities such as querying your account info, viewing positions, and managing orders or assets across the 40 trading tools. All operations are authenticated via an automatic ed25519-based flow, and your credentials are supplied at runtime rather than stored in code.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system. You can verify them with node -v and npm -v. Install or run the MCP server client commands using the exact snippets below to configure your environment and start using the server.

# Option A: Auto-Configuration (Recommended)

# 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

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

Claude Desktop (macOS path example)

{
  "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"
      }
    }
  }
}

Additional configuration and security

Security is designed to keep your credentials safe. Do not hardcode API keys in code or configs. Use .env files which are gitignored, and the server will automatically load credentials from your working directory. All parameters are validated with robust schemas to prevent invalid inputs. Backups are created before any changes to your MCP configuration, ensuring you can restore a previous state if needed.

Environment variables you provide are used to authorize access and route requests through the Orderly Network. You will typically supply WOOFI_API_KEY, WOOFI_SECRET_KEY, and WOOFI_ACCOUNT_ID when configuring the MCP server. The server also relies on non-sensitive defaults such as the public API endpoint and chain context.

If you need to update credentials, regenerate API keys from the WOOFi Pro management console, update your .env file, and restart the MCP client to apply the changes. The server will automatically backup the existing configuration before applying updates.

Troubleshooting and notes

If you encounter connection issues, verify that the API keys and account ID you supplied are correct and that your account has the necessary read and trading permissions. Ensure your MCP client is restarted after changes to the credentials or environment variables. Check that the environment file is loaded in the working directory and that there are no syntax errors in your config JSON.

For troubleshooting tool-specific actions, refer to the 40 trading tools categorized under Account, Orders, Assets, Positions, Liquidations, and Funding. Each tool is accessible via the connected MCP client once authentication is successful.

Available tools

get_account_info

Retrieve account information and related details such as balances and identifiers.

get_positions

Fetch current positions and holdings.

get_orders

Retrieve a list of orders with filtering options.

create_order

Place a new order on the market.

batch_create_orders

Submit multiple orders in a single request.

edit_order

Modify an existing order.

cancel_order

Cancel a specific order by ID.

cancel_order_by_client_id

Cancel an order using the client-provided ID.

cancel_all_pending_orders

Cancel all currently pending orders.

cancel_all_after

Cancel all orders after a certain condition or time.

get_order_by_id

Retrieve details for a specific order by ID.

get_order_by_client_id

Retrieve a specific order using the client-provided ID.

create_algo_order

Create an algorithmic order.

edit_algo_order

Modify an algorithmic order.

cancel_algo_order

Cancel an algorithmic order.

cancel_algo_order_by_client_id

Cancel an algorithmic order by client ID.

cancel_all_pending_algo_orders

Cancel all pending algorithmic orders.

get_algo_orders

List algorithmic orders.

get_algo_order_by_id

Get details of a specific algorithmic order by ID.

get_algo_order_by_client_id

Get details of an algorithmic order by client ID.

get_asset_history

Retrieve historical data for assets.

get_holdings

Get current asset holdings.

create_withdraw_request

Create a withdrawal request for assets.

get_settle_pnl_nonce

Obtain a nonce for PnL settlement.

request_pnl_settlement

Request settlement of PnL.

get_pnl_settlement_history

Fetch PnL settlement history.

create_internal_transfer

Perform an internal transfer between accounts.

get_internal_transfer_history

Get history of internal transfers.

get_all_positions

Retrieve all positions.

get_position_by_symbol

Get a position for a specific symbol.

get_position_history

Get historical data for a position.

get_liquidated_positions

List positions that were liquidated.

get_liquidations

Retrieve current liquidations.

get_positions_under_liquidation

Show positions currently under liquidation.

claim_liquidated_positions

Claim liquidated positions.

claim_insurance_fund

Claim funds from the insurance pool.

get_insurance_fund

Check the insurance fund status.

get_funding_fee_history

Fetch funding fee history.