Hyperliquid Info MCP Server

Real-time Hyperliquid perp DEX data and insights for bots, dashboards, and analytics.

Unverified

stdio (local)

No auth

Stale

Python

View repo 29

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

git clone https://github.com/kukapay/hyperliquid-info-mcp.git && cd hyperliquid-info-mcp && uv sync

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hyperliquid-info-mcp-server": {
      "command": "mcp",
      "args": [
        "run",
        "main.py"
      ]
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Python 3.10 (required by the Hyperliquid Python SDK)
uv or pip for package management
A valid Hyperliquid account address for user-specific queries

About Hyperliquid Info MCP Server

Hyperliquid Info MCP Server wraps the Hyperliquid perp DEX Info API as a set of MCP tools, letting an AI client fetch real-time user account data (positions, margin, open orders, trade/funding history, fees, staking, sub-accounts, order lookups) and market data (mid prices, L2 snapshots, candles, funding rates, perp/spot metadata). It includes an analyze_positions prompt that chains user-data tools into a trading risk/performance analysis. Time-based tools accept ISO 8601 strings. The server runs locally over stdio and is installed via the MCP CLI for Claude Desktop or run in dev mode with the MCP Inspector.

Tools & capabilities (18)

get_user_state

Fetch user positions, margin, and withdrawable balance for perpetuals or spot markets.

get_user_open_orders

Retrieve all open orders for a user account.

get_user_trade_history

Get trade fill history with details like symbol, size, and price.

get_user_funding_history

Query funding payment history with customizable time ranges (ISO 8601 supported).

get_user_fees

Fetch user-specific fee structures (maker/taker rates).

get_user_staking_summary

Access a user's staking summary details.

get_user_staking_rewards

Access a user's staking rewards.

get_user_order_by_oid

Retrieve specific order details by order ID (oid).

get_user_order_by_cloid

Retrieve specific order details by client order ID (cloid).

get_user_sub_accounts

List sub-accounts associated with a main account.

get_all_mids

Get mid prices for all trading pairs.

get_l2_snapshot

Fetch Level 2 order book snapshots for a specific coin.

get_candles_snapshot

Retrieve candlestick data with customizable intervals and time ranges (ISO 8601 supported).

get_coin_funding_history

Query funding rate history for a specific coin (ISO 8601 supported).

get_perp_dexs

Fetch metadata about perpetual markets (using meta).

get_perp_metadata

Get detailed metadata for perpetual markets, with optional asset contexts.

get_spot_metadata

Get detailed metadata for spot markets, with optional asset contexts.

analyze_positions

A guided prompt that analyzes user trading activity (positions, open orders, trades, funding, fees) and generates a risk/performance analysis.

When to use it

Analyze a Hyperliquid account's positions, open orders, and recent trades for risk and performance
Fetch real-time mid prices, L2 order book snapshots, and candlestick data for trading pairs
Pull funding rate and funding payment history for coins or user accounts
Power trading bots, dashboards, and analytics with live Hyperliquid perp DEX data

Security notes

Read-only: the server queries public Hyperliquid Info data and account-level read endpoints. No private key or API key is required; user-specific queries take a public wallet address as a parameter, so no signing credentials are stored or transmitted. Requires Python 3.10 (per the Hyperliquid Python SDK).

Hyperliquid Info MCP Server FAQ

Does it need a private key or API key?

No. The server queries public Hyperliquid Info endpoints and account-level read data using a public wallet address parameter. No API key or signing key is required.

How do I install it into Claude Desktop?

Clone the repo, run `uv sync`, then `mcp install main.py --name "Hyperliquid Info"`. You can also run `mcp dev main.py` to inspect it with the MCP Inspector.

What Python version is required?

Python 3.10, which is required by the Hyperliquid Python SDK.

Can it place trades or move funds?

No. It only reads data (user account info and market data); it does not execute orders or transfers.

#hyperliquid #perpetuals #dex #crypto #trading #defi #market-data #python

Alternatives to Hyperliquid Info MCP Server

Compare all alternatives →

Stripe MCP Server (Agent Toolkit)

Finance & Payments

1.9k

Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language.

Featured

Verified

stdio (local)

API key

TypeScript

12 tools

Updated 1 month agoRepo

Coinbase AgentKit MCP Extension

Finance & Payments

900

Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls.

Verified

stdio (local)

API key

TypeScript

9 tools

Updated 1 month agoRepo

Alpaca MCP Server

Finance & Payments

820

Alpaca's official trading server for stocks, ETFs, options, and crypto in plain English.

Verified

stdio (local)

API key

Python

12 tools

Updated 1 month agoRepo

Compare Hyperliquid Info MCP Server with:

vs Stripe MCP Server (Agent Toolkit)vs Coinbase AgentKit MCP Extension vs Alpaca MCP Server vs MetaTrader MCP Server