Liquidiction MCP Server
Liquidiction/liquidiction-mcp
Mercados de previsão Hyperliquid para agentes Claude e IA
Ver no GitHubServidor MCP que oferece a agentes de IA acesso direto aos dados de mercados de previsão HIP-4 do Hyperliquid. Consulte odds ao vivo, livros de ofertas, velas de preço e posições sem necessidade de chaves de API.
Instalação
npx convez-ai Liquidiction/liquidiction-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise de probabilidades em tempo real de mercados de previsão
- Consultoria de liquidez e spread de orderbooks
- Monitoramento de posições e histórico de trades em carteiras
- Análise técnica com dados OHLCV de mercados de previsão
Veredito

MCP server bem estruturado e de nicho específico para mercados de previsão. Implementação clara com 10 ferramentas úteis, mas público-alvo é limitado a traders e researchers interessados em HIP-4 do Hyperliquid.
README
A tradução para o português deste README ainda está na fila.
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.
Links
- App: testnet.liquidiction.xyz
- Landing: liquidiction.xyz
- Twitter: @LiquidictionHL
- Telegram: t.me/Liquidiction
- Built on: Hyperliquid
License
MIT