Liquid Trading MCP Server

Trade Hyperliquid perpetual futures via natural language using the Liquid API. Connect from Claude Desktop, ChatGPT, Cursor, or any MCP-compatible client.

What it does

A fully featured trading session in natural language:

• Check your portfolio — account equity, balances, open positions

• Read market data — prices, order books, funding rates across all perpetual markets

• Place and manage orders — market/limit orders with leverage, TP/SL, and confirmation widgets

• Close positions — full or partial close with confirmation before execution

All sizes are in USD notional. All markets are perpetual futures on Hyperliquid.

MCP Tools

Safety

place_order and close_position require explicit confirmation before execution — these are real financial transactions. A confirmation widget is shown first; the order is only submitted after the user confirms.

Getting Started

Prerequisites

• Bun runtime

• A Liquid API key and secret (get one here)

Setup

# Install dependencies
bun install

# Configure environment
cp .env.example .env
# Edit .env with your LIQUID_API_KEY and LIQUID_API_SECRET

# Run in dev mode
bun run dev

The server starts at http://localhost:3000. Open /inspector to test tools interactively.

Connecting from Claude Desktop

Add to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "liquid-trading": {
      "command": "bun",
      "args": ["run", "start"],
      "cwd": "/path/to/liquid-trading",
      "env": {
        "LIQUID_API_KEY": "lq_...",
        "LIQUID_API_SECRET": "sk_..."
      }
    }
  }
}

Connecting from ChatGPT

Point ChatGPT to the HTTP URL:

http://localhost:3000

Interactive widgets are rendered directly in the conversation for market data, positions, and order confirmations.

Tech Stack

• mcp-use — MCP server framework with widget support

• Liquid API — REST API wrapping Hyperliquid perpetual futures

• React — interactive ChatGPT widgets

• Zod — schema validation for all tool inputs

• TypeScript strict mode

License

MIT