Hyperliquid Info MCP Server

@kukapay

About Hyperliquid Info MCP Server

An MCP server that provides real-time data and insights from the Hyperliquid perp DEX for use in bots, dashboards, and analytics.

#hyperliquid #mcp-server #data-insights

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hyperliquid-info-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Hyperliquid Info MCP Server?

An MCP (Model Context Protocol) server that provides real-time data and insights from the Hyperliquid perpetual DEX (decentralized exchange) for use in bots, dashboards, and analytics. It is aimed at developers and traders who want to programmatically query Hyperliquid user data, market data, and perform analysis.

How to use Hyperliquid Info MCP Server?

Clone the repository, install dependencies with uv sync (Python 3.10+ required), then run the server in development mode via mcp dev main.py or install it for Claude Desktop with mcp install main.py --name "Hyperliquid Info". Interact using natural language prompts in MCP Inspector or Claude Desktop, invoking specific tools like get_user_state, get_candles_snapshot, or the analyze_positions prompt.

Key features of Hyperliquid Info MCP Server

Query user positions, margin, and withdrawable balance
Retrieve open orders, trade history, and funding payments
Access staking details and rewards
Get mid prices, L2 order book snapshots, and candlestick data
Fetch perpetual and spot market metadata
Guided analysis prompt for trading activity

Use cases of Hyperliquid Info MCP Server

Build trading bots that monitor user positions and market conditions
Create dashboards showing real-time Hyperliquid account stats
Analyze trading performance and risk for a given account
Access historical funding and candle data for research
Integrate Hyperliquid data into automated notification systems

FAQ from Hyperliquid Info MCP Server

What data does Hyperliquid Info MCP Server provide?

It provides two categories of data: user-specific data (positions, orders, trades, funding, staking, fees) and market data (mid prices, order book snapshots, candlesticks, funding rates, market metadata). It also includes an analysis prompt to combine user data for insights.

What are the prerequisites to use the server?

Python 3.10 or higher is required, along with a valid Hyperliquid account address for user-specific queries. Package management can be done with uv or pip.

How do I run the server?

You can run it in development mode using mcp dev main.py or install it for Claude Desktop with mcp install main.py --name "Hyperliquid Info". The server uses the MCP Inspector for testing.

What transports or authentication does it use?

The server runs as a standard MCP server (stdio transport) and does not require authentication for market data queries. User-specific queries require a Hyperliquid account address as a parameter. No API keys are mentioned.

Is there a license for this project?

Yes, the project is licensed under the MIT License.

Frequently asked questions

What data does Hyperliquid Info MCP Server provide?

What are the prerequisites to use the server?

Python 3.10 or higher is required, along with a valid Hyperliquid account address for user-specific queries. Package management can be done with `uv` or `pip`.

How do I run the server?

You can run it in development mode using `mcp dev main.py` or install it for Claude Desktop with `mcp install main.py --name "Hyperliquid Info"`. The server uses the MCP Inspector for testing.

What transports or authentication does it use?

Is there a license for this project?

Yes, the project is licensed under the MIT License.

Comments

Basic information

More Data & Analytics MCP servers

Rankbits

rankbits

AI visibility analytics across 15+ providers (ChatGPT, Perplexity, Gemini, AI Overviews, and more). The MCP connector lets assistants run scans, compare competitor mentions, and track your brand's visibility in AI answer

Batru

Real, calibrated win-rate predictions, pick recommendations, counters, synergy and tier lists for Dota 2, Deadlock and Marvel Rivals, from production models trained on ~20M matches. Free hosted endpoint (Streamable HTTP)

BidSkim - UK Tenders & Contract Renewals

BidSkim

UK procurement intelligence for AI assistants: search live UK government tenders, find contract renewals with expiry dates and incumbent suppliers, and profile public-sector buyers and suppliers. Covers Find a Tender, Co

Subtext

Subtext by Fullstory

Session replay, built for agents. Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can

OAIA Arena

Give any AI trading agent a public, un-cherry-pickable track record. Commit a call before it resolves, get a hash receipt, get scored against 2,048 coin-flipping monkeys on the same window.