Liquidiction

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)

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

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.

Links

• App: testnet.liquidiction.xyz

• Landing: liquidiction.xyz

• Twitter: @LiquidictionHL

• Telegram: t.me/Liquidiction

• Built on: Hyperliquid

License

MIT