Skip to main content
Glama
garavels

Liquid Trading MCP Server

by garavels
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

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.

Related MCP server: Hyperliquid MCP Server

MCP Tools

Tool

Description

Input

get_markets

List all tradeable perpetual markets

—

get_ticker

Price, volume, funding rate for a symbol

{ symbol }

get_orderbook

Bids and asks for a symbol

{ symbol, depth? }

get_account

Equity, available balance, margin used

—

get_positions

All open positions with PnL

—

place_order

Place a buy/sell order (confirmation required)

{ symbol, side, size, type?, price?, leverage?, tp?, sl? }

cancel_order

Cancel an open order

{ order_id }

close_position

Close a position fully or partially (confirmation required)

{ symbol, size? }

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

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Hyperliquid MCP Server

    t3rmed
    A
    license
    A
    quality
    Not graded
    maintenance
    Enables interaction with the Hyperliquid DEX for retrieving market data, managing positions, and executing trades. Supports both testnet and mainnet operations with comprehensive trading tools including order placement, cancellation, and portfolio management.
    11
    MIT

  • Hyperliquid MCP Server

    samklein952-hub
    A
    license
    A
    quality
    D
    maintenance
    Enables interaction with the Hyperliquid exchange to trade perpetuals, check positions, and manage risk through natural language. It provides tools for fetching real-time market data, tracking portfolio value, and executing orders with a focus on safety through default paper trading.
    10
    1
    MIT

  • hyperliquid-mcp

    edkdev
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to securely trade on Hyperliquid perpetual exchange, including order placement, position management, market data retrieval, and vault operations via natural language.
    21
    MIT