hyperliquid-microstructure-mcp

# hlmcp — Hyperliquid Microstructure & Execution MCP An open-source [MCP](https://modelcontextprotocol.io) server exposing **computed market-microstructure and execution-analytics signals** on [Hyperliquid](https://hyperliquid.xyz) — native HL perps *and* HIP-3 deployments — as tools that LLM agents and AI coding assistants (Claude Desktop, Cursor, Claude Code, LangGraph, …) can call. ## Why this exists Most crypto MCPs are **data-access wrappers**: mid prices, candles, raw L2 books. `hlmcp` is deliberately *not* that. The value is in the **computed layer** — the analysis you'd otherwise write yourself: - **depth-weighted order-book imbalance** across basis-point bands, reporting the *actual achieved bucket width* so you know the resolution is real; - **whale position monitoring** with **account-level** liquidation risk as the headline (not the often-meaningless per-position `liquidationPx` — see [Data & limits](#data--limits)); - **HIP-3 deployment discovery**, so cross-dex queries route correctly. Read-only, HL-first, research- and slow-loop-decisioning grade. ## Install Requires only **Python ≥ 3.12** — `venv` and `pip` ship with it, so nothing extra to install. The Hyperliquid public API needs **no auth / no API key**. > **Not yet published to PyPI.** Until it is, install **from source** (below). The > PyPI command is how end users will install *once published* — pip fetches the > built package directly, no clone needed. ### From source (works today) — pip, no extra tools ```bash git clone git@github.com:Eugene2710/crypto_hl_marketmicro.git cd crypto_hl_marketmicro python3 -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install . # installs the package + its deps into .venv which hlmcp-server # -> /…/crypto_hl_marketmicro/.venv/bin/hlmcp-server ``` ### From PyPI (once published) — pip ```bash pip install hyperliquid-microstructure-mcp ``` Either path gives you the console c…