@iflow-mcp/liquidiction-liquidiction-mcp

v1.0.2

Published

22 days ago

MCP server for Hyperliquid HIP-4 prediction markets

0High
0Medium
0Low

chatflowdev

qystart

What is this?

An MCP (Model Context Protocol) server that gives AI agents like Claude, GPT, and custom agents direct access to live HIP-4 prediction market data on Hyperliquid. This is the first MCP server for prediction markets.

No API keys required. Connects directly to Hyperliquid's public API.

Tools (10)

| Tool | Description | |------|-------------| | list_markets | All active prediction markets with current prices | | get_market_detail | Detailed info for a specific outcome ID | | get_market_summary | Rich overview with probabilities, settlement status, and parsed metadata | | get_orderbook | L2 order book (bids, asks, spread) for an outcome side | | get_prices | Current mid-prices for all outcome coins | | get_candles | OHLCV candle data for charting and analysis | | get_recent_trades | Latest trades on a specific market | | get_user_fills | Trade history for a wallet address | | get_open_orders | Resting limit orders for a wallet | | get_user_positions | Current outcome share holdings and values |

Quick Start

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "liquidiction": {
      "command": "npx",
      "args": ["tsx", "/path/to/liquidiction-mcp/mcp-server.ts"]
    }
  }
}

Restart Claude Desktop, then try:

"What are the current HIP-4 prediction market odds?"
"Show me the orderbook for outcome 13"
"What positions does 0x1393...1869 hold?"

Claude Code

claude mcp add liquidiction npx tsx /path/to/liquidiction-mcp/mcp-server.ts

Run Standalone

git clone https://github.com/Liquidiction/liquidiction-mcp.git
cd liquidiction-mcp
npm install
npm start

Configuration

| Env Variable | Default | Description | |-------------|---------|-------------| | HL_API_URL | https://api.hyperliquid-testnet.xyz | Hyperliquid API endpoint |

Set to https://api.hyperliquid.xyz for mainnet data.

Example Queries

Market Odds

"What are the odds on BTC above $71,566?"

Uses get_market_summary to fetch all markets, finds BTC markets, returns current probabilities.

Orderbook Analysis

"Is there good liquidity on the Hypurr vs Usain Bolt market?"

Uses get_orderbook to check bid/ask depth, spread, and order count.

Portfolio Check

"What are my positions and PnL?"

Uses get_user_positions + get_user_fills to show holdings and trade history.

Price History

"How has the HYPE prediction market moved in the last 24 hours?"

Uses get_candles with 1h interval to show price movement over time.

What is HIP-4?

HIP-4 (Hyperliquid Improvement Proposal 4) introduces prediction markets that run natively on Hyperliquid's L1 order book engine. Key features:

Binary outcomes (Yes/No) priced 0-100 cents
Fully collateralized (no leverage, no liquidation risk)
Shares the same infrastructure as perps and spot
Supports recurring markets (15M, 1H, 1D periods)
Settlement via on-chain oracle

Premium API (x402)

For enriched data with orderbook depth, volume, and metadata:

GET https://testnet.liquidiction.xyz/api/premium/analytics

Paywalled at $0.001/request via x402 USDC micropayments on Base Sepolia.

License

MIT