1. Conduid
  2. Developer Tools
  3. Liquidiction/liquidiction-mcp
MCP server · Developer Tools

Liquidiction/liquidiction-mcp

by · github.com/Liquidiction/liquidiction-mcp

chain prediction markets. No API keys required.

Unclaimed devtools
InstallView source
34Low

Scored 5 months ago · breakdown

About Liquidiction/liquidiction-mcp

Liquidiction/liquidiction-mcp is an MCP server published by Liquidiction in the Developer Tools category: chain prediction markets. No API keys required.

The repository has 6 stars and 3 forks, with the last commit a month ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/Liquidiction/liquidiction-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (10)

get_candles`coin`, optional `interval`, optional `hours`

Parameters not published.

get_market_detail`outcome_id`

Parameters not published.

get_market_summaryNone

Parameters not published.

get_open_orders`address`

Parameters not published.

get_orderbook`outcome_id`, optional `side`

Parameters not published.

get_pricesNone

Parameters not published.

get_recent_trades`coin`

Parameters not published.

get_user_fills`address`, optional `limit`

Parameters not published.

get_user_positions`address`

Parameters not published.

list_marketsNone

Parameters not published.

Ask AI

✦

Ask AI about Liquidiction/liquidiction-mcp

Powered by Claude · Grounded in docs

I know everything about Liquidiction/liquidiction-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Liquidiction/liquidiction-mcp

How do I install Liquidiction/liquidiction-mcp?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Liquidiction/liquidiction-mcp safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Liquidiction/liquidiction-mcp still maintained?

Yes — the last commit was a month ago. The repository has 6 stars and 3 forks.