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
| Tool | What it does |
|---|---|
get_signals | Cross Hyperliquid perp funding with HIP-4 and Polymarket sentiment for any asset. |
get_market_context | Aggregates all Polymarket + HIP-4 markets + HL perp data for a topic or asset. |
get_pm_hl_divergences | Scans every asset, returns pairs where PM implied probability diverges from HL funding direction. |
get_hl_funding_pm_correlation | Per asset, finds correlated PM markets and computes alignment vs divergence. |
get_hip4_vs_pm_arb | Compares YES prices for the same event on HIP-4 and Polymarket. Returns exploitable spreads. |
get_whale_convergence | Detects whales acting simultaneously on HL perps and Polymarket for the same asset. |
Hyperliquid perps
| Tool | What it does |
|---|---|
get_top_funding_rates | Top perps by absolute funding rate with OI and annualized yield. |
get_funding_outliers | Perps whose funding deviates from their 7-day average. |
get_funding_rates | Raw funding for a list of assets. |
get_open_interest | OI in USD and contracts. |
get_whale_trades | Recent trades above a notional threshold. |
get_liquidation_clusters | Price levels where liquidations concentrate by leverage multiple. |
get_oi_near_cap | Perps whose OI is near the cap. |
Polymarket
| Tool | What it does |
|---|---|
get_markets | Live markets sorted by volume. |
search_markets | Full-text search across Polymarket + HIP-4. |
get_odds | Current YES/NO price for a token. |
get_orderbook | Order book depth (Polymarket only). |
get_whale_positions | Large holders on a Polymarket market. |
get_markets_near_resolution | Markets resolving soon, above a probability threshold. |
get_volume_spikes | Markets with abnormal 24h volume vs 7-day average. |
get_movers | Top 24h volume and price movers. |
get_late_game_sports | Sports markets closing soon with a clear leader. |
Setup
- Get a free API key at predmcp.com/signup.
- 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_orderbookis 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.