Live

PredMCP

An MCP server that wires Polymarket, Hyperliquid perps, and HIP-4 into any tool-use capable LLM. One question to your agent gets you the full cross-venue picture in real time.

Free tier: 100 calls per day. Email required, no credit card.

Why it exists

To know what markets think about BTC right now, you'd open Polymarket (hundreds of markets), then Hyperliquid perps (funding, OI), then cross the two manually. Nobody does this consistently.

With PredMCP, one question to your agent gets everything aggregated and cross-referenced in real time.

Example output

HL perps:  BTC $79,740 | funding +0.0000125 | OI 31,100 BTC   (slightly bullish)
HIP-4:     BTC > $81,041 by 6am  →  YES 12%                  (very bearish)
Signal:    DIVERGENCE — perps slightly bullish, prediction market very bearish

Output of get_signals('BTC'). The kind of cross-venue read no single API gives you.

The 22 tools

Cross-venue intelligence

ToolWhat it does
get_signalsCross Hyperliquid perp funding with HIP-4 and Polymarket sentiment for any asset.
get_market_contextAggregates all Polymarket + HIP-4 markets + HL perp data for a topic or asset.
get_pm_hl_divergencesScans every asset, returns pairs where PM implied probability diverges from HL funding direction.
get_hl_funding_pm_correlationPer asset, finds correlated PM markets and computes alignment vs divergence.
get_hip4_vs_pm_arbCompares YES prices for the same event on HIP-4 and Polymarket. Returns exploitable spreads.
get_whale_convergenceDetects whales acting simultaneously on HL perps and Polymarket for the same asset.

Hyperliquid perps

ToolWhat it does
get_top_funding_ratesTop perps by absolute funding rate with OI and annualized yield.
get_funding_outliersPerps whose funding deviates from their 7-day average.
get_funding_ratesRaw funding for a list of assets.
get_open_interestOI in USD and contracts.
get_whale_tradesRecent trades above a notional threshold.
get_liquidation_clustersPrice levels where liquidations concentrate by leverage multiple.
get_oi_near_capPerps whose OI is near the cap.

Polymarket

ToolWhat it does
get_marketsLive markets sorted by volume.
search_marketsFull-text search across Polymarket + HIP-4.
get_oddsCurrent YES/NO price for a token.
get_orderbookOrder book depth (Polymarket only).
get_whale_positionsLarge holders on a Polymarket market.
get_markets_near_resolutionMarkets resolving soon, above a probability threshold.
get_volume_spikesMarkets with abnormal 24h volume vs 7-day average.
get_moversTop 24h volume and price movers.
get_late_game_sportsSports markets closing soon with a clear leader.

Setup

  1. Get a free API key at predmcp.com/signup.
  2. Add the MCP endpoint to your client config:
{
  "mcpServers": {
    "predmcp": {
      "url": "https://predmcp.com/mcp",
      "headers": { "x-api-key": "YOUR_KEY" }
    }
  }
}

That's it. Restart your client and the 22 tools are available.

Honest scope

A few things PredMCP does not do, so you can plan accordingly:

  • No HIP-4 order book depth — get_orderbook is Polymarket only.
  • No HIP-4 price history or candles.
  • No trading. Read-only data.
  • No push notifications or alerts. Pull-based only.
  • No long-range backtest data.

Stack

TypeScript, Fastify, MCP SDK. Sources: Polymarket Gamma API, Hyperliquid Info API, HIP-4 API. All upstream data is public; the API key on our side is just for rate limiting.