PredMCP
io.github.RavioleLabs/predmcpVersion 0.5.0Polymarket + Hyperliquid + macro for AI agents. 38 tools, signal backtest, SSE streaming. Free tier.
Status
Responds91 msAnswered our handshake without sign-in.- Last checked
- Nov 14, 2026, 14:41 UTC
- Latency
- 91 ms
- Remotes responding
- 1 of 1
- Sign-in
- API key
- Hosting
- EU hosting detected (detected, not a legal statement)
- Registry data as of
- Nov 14, 2026, 21:12 UTC
Data from the official MCP Registry, checked by run.zero. How we check
Connect
Streamable HTTP
https://predmcp.com/mcpResponds91 msNo sign-in
Claude Code
claude mcp add --transport http predmcp https://predmcp.com/mcp --header 'x-api-key: <YOUR_X_API_KEY>'Replace <YOUR_X_API_KEY> before running.
Claude Desktop and claude.ai
Settings > Connectors > Add custom connector
Name: predmcp
Remote MCP server URL: https://predmcp.com/mcp
This server expects the header x-api-key.Cursor
{
"mcpServers": {
"predmcp": {
"url": "https://predmcp.com/mcp",
"headers": {
"x-api-key": "<YOUR_X_API_KEY>"
}
}
}
}Replace <YOUR_X_API_KEY> before running.
VS Code
code --add-mcp '{"name":"predmcp","type":"http","url":"https://predmcp.com/mcp","headers":{"x-api-key":"<YOUR_X_API_KEY>"}}'Replace <YOUR_X_API_KEY> before running.
Built your own server? run.zero hosts MCP servers on European infrastructure.
Tools
52 tools
Read-only | Idempotent | Open world | ||
|---|---|---|---|---|
create_api_keyGenerate a free PredMCP API key. Requires an email. Returns the key and ready-to-use MCP config. Free tier: 100 calls/day, one key per IP. | Not declared | No | Not declared | No |
get_basic_macroDXY, US10Y yield, S&P 500, gold, VIX — direct from free Yahoo Finance. Raw values + 1d change. Pro adds BTC dominance, ETH/BTC, total crypto mcap, and a RISK_ON/OFF regime classifier. | Not declared | Yes | Not declared | Yes |
get_carry_scannerFunding carry NET of costs: annualized funding minus (spread + 2x slippage at your size), with break-even holding period and a 7d funding-stability score from our snapshots. get_top_funding_rates shows gross — nobody trades gross. | Not declared | Yes | Not declared | Yes |
get_cex_outflowsNet ETH outflows across known CEX hot wallets (Binance, Coinbase, OKX, Kraken, Bitfinex) over a window. Outflow = bullish (BTC moving to cold storage). Inflow = distribution pressure. Etherscan free tier. | Not declared | Yes | Not declared | Yes |
get_conviction_scoreAggregates funding outlier, whale imbalance, OI/volume ratio, and momentum into a single directional score (-100 short ↔ +100 long) plus a 0-100 strength score. One call replaces 6+ lookups, returns a clean number for LLM decisions. | Not declared | Yes | Not declared | Yes |
get_cross_venue_fundingPredicted funding spreads between Hyperliquid, Binance, and Bybit per asset (from HL's predictedFundings feed). Surfaces delta-neutral carry: long the venue with lowest funding, short the highest, collect the spread. Sorted by annualized spread. | Not declared | Yes | Not declared | Yes |
get_funding_curve_anomalyTerm-structure analysis of Hyperliquid funding for an asset: current vs 8h avg vs 24h avg vs 7d baseline. Flags spikes, regime shifts, sign contradictions. More nuanced than raw funding rate. | Not declared | Yes | Not declared | Yes |
get_funding_outliersHyperliquid perps whose current funding rate deviates significantly from their 7-day average. A spike vs baseline is a stronger signal than raw rate. | Not declared | Yes | Not declared | Yes |
get_funding_ratesCurrent funding rates for Hyperliquid perpetuals. Positive rate = longs pay shorts (bearish bias); negative = shorts pay longs (bullish bias). | Not declared | Yes | Not declared | Yes |
get_hip4_vs_pm_arbFinds the same underlying market priced on both HIP-4 (on-chain Hyperliquid) and Polymarket, flagging spreads above threshold. A spread means one venue is mispriced relative to the other. | Not declared | Yes | Not declared | Yes |
get_late_game_sportsSports prediction markets on Polymarket closing within a few hours with a high-certainty leading outcome. Targets near-certain resolution for late-game positioning. | Not declared | Yes | Not declared | Yes |
get_liquidation_clustersEstimated price levels where mass liquidations concentrate for a given Hyperliquid perp, computed from mark price and standard leverage multiples. Higher nearby orderbook liquidity = stronger support/resistance. | Not declared | Yes | Not declared | Yes |
get_macro_contextLive macro snapshot: DXY, US10Y yield, S&P 500, gold, VIX (Yahoo Finance free) + BTC dominance, ETH/BTC, total crypto market cap (CoinGecko free). Plus a coarse RISK_ON / RISK_OFF / MIXED regime. | Not declared | Yes | Not declared | Yes |
get_macro_liquidityFiat-to-crypto liquidity gauge: BTC + ETH spot ETF flows (Farside) plus on-chain USDT + USDC mint/burn (Etherscan). Net inflow = bullish for risk assets. | Not declared | Yes | Not declared | Yes |
get_market_contextUnified intelligence snapshot for any topic, asset, or keyword: all matching Polymarket and HIP-4 prediction markets combined with live Hyperliquid perp data (price, funding, OI). One call replaces 3+ separate lookups. | Not declared | Yes | Not declared | Yes |
get_market_edgeUniversal fair-value anchor for ONE market of ANY category. Pass the question (+ optional strike/comparator/expiry/underlying for price markets, + yes_price). Dispatches to the best anchor: options/vol fair value (crypto price), a confident Polymarket twin (events/politics/sports), or a soft news lean. Returns { method, confidence, anchor_prob, hip4_yes, edge_pt, verdict, source_ref, note }. edge_pt = (anchor_prob - hip4_yes)*100; positive = YES cheap; null for untraded/synthetic prices. | Not declared | Yes | Not declared | Yes |
get_market_edgesOne-call universal mispricing scanner across ALL HIP-4 market types (crypto price, sports, politics, macro, events). Resolves every market to its best anchor (options / Polymarket twin / news lean / none) and ranks by |edge|. Filter with method / min_edge_pt / limit. Returns by_method counts + ranked markets. Superset of get_outcome_edges. | Not declared | Yes | Not declared | Yes |
get_market_regimeOne-call market regime classifier: RISK_ON_TRENDING / RISK_OFF / SQUEEZE_RISK / CHOP_LOW_VOL / MIXED. Combines BTC trend + realized vol, Deribit IV premium, funding breadth, and OI-weighted crowding across the top 50 perps. Call this FIRST each session to condition strategy choice. | Not declared | Yes | Not declared | Yes |
get_marketsLive prediction markets from Polymarket and/or HIP-4, sorted by volume. Returns title, YES/NO prices, 24h volume, and expiry. | Not declared | Yes | Not declared | Yes |
get_markets_near_resolutionPolymarket markets resolving within the next N hours with a leading probability above threshold. Useful for resolution arbitrage and last-minute positioning. | Not declared | Yes | Not declared | Yes |
get_moversTop prediction markets ranked by 24h volume spike or biggest YES/NO price swing. Surfaces breaking news bets and momentum plays across Polymarket and HIP-4. | Not declared | Yes | Not declared | Yes |
get_news_correlationRecent crypto news headlines mentioning an asset (CoinDesk, The Block, Decrypt, Cointelegraph) paired with the 1h price move that followed each. Lets agents filter news bias. | Not declared | Yes | Not declared | Yes |
get_news_feedRecent headlines across crypto, finance and sports RSS feeds, unfiltered and unclassified. Unlike get_recent_news it does not filter by asset ticker, so it also covers the sports, macro and event markets that make up most of a HIP-4 board. Match the headlines against your own market list. | Not declared | Yes | Not declared | Yes |
get_news_signalsNews → markets recommender: pulls recent crypto headlines, classifies each event type (depeg/hack_exploit/listing/delisting/unlock/regulatory/partnership/outage/hype/fud/macro), extracts the assets, maps to affected HIP-4 markets, and assigns a directional lean (YES up / YES down). Heuristic, low/medium confidence, NOT financial advice; war/hard-politics excluded. Powers a live "event → affected markets → lean" feed. Filter with hours / event_type / min_confidence / limit. | Not declared | Yes | Not declared | Yes |
get_oddsCurrent YES/NO prices and implied probability for any Polymarket or HIP-4 market token. | Not declared | Yes | Not declared | Yes |
get_oi_divergencePrice-vs-OI regime per coin from our continuous snapshots: NEW_LONGS / SHORT_SQUEEZE / NEW_SHORTS / LONG_LIQUIDATION. Scan all tracked coins or analyze one. Impossible without OI history, which no public API provides — only predmcp records it. | Not declared | Yes | Not declared | Yes |
get_oi_historyOpen-interest time series for a coin over the last 24h, from our continuous 5-min collector. Hyperliquid has NO OI-history endpoint — this data exists only on predmcp. Includes price + funding at each point. Pro tool get_oi_divergence classifies price-vs-OI regimes (squeeze/liquidation/new positioning) across all coins. | Not declared | Yes | Not declared | Yes |
get_oi_near_capLists Hyperliquid perps that are currently at the open interest cap — new long positions cannot be opened. Use as a blacklist to avoid getting rejected on entry. | Not declared | Yes | Not declared | Yes |
get_options_ivBTC or ETH options snapshot via free Deribit feed: ATM implied volatility, put-call skew, term structure, total OI and 24h volume. Useful as a sentiment gauge — IV high = market expects big moves; skew indicates direction of hedging. | Not declared | Yes | Not declared | Yes |
get_orderbookFull orderbook depth (bids + asks) for any Polymarket market token. Shows liquidity at each price level. | Not declared | Yes | Not declared | Yes |
get_orderbook_depthFull orderbook depth + slippage estimate for any Hyperliquid perp or HIP-4 market. Returns top of book, spread, cumulative depth at $100/$500/$1k/$5k tiers, and estimated slippage for a given order size. Critical for HIP-4 farming and low-liquidity assets where market orders get destroyed by slippage. | Not declared | Yes | Not declared | Yes |
get_outcome_edgesOne-call mispricing scanner for autonomous agents: every live HIP-4 PRICE market, each priced against its options/vol-implied fair value and ranked by |edge|. BTC/ETH use the Deribit IV smile; other assets use Hyperliquid realized vol (iv_source labels which). edge_pt = (implied_prob - yes_price)*100, computed only where a real traded YES price exists (synthetic/untraded 0.5 placeholders return edge_pt:null so no fake edge is surfaced). Filter with min_edge_pt / underlying. The whole board without looping. | Not declared | Yes | Not declared | Yes |
get_outcome_fair_valueOptions/vol-implied fair value for a HIP-4 binary/range/touch PRICE market ("<asset> above $X at time T?"). Returns the risk-neutral probability the market resolves YES, and — if you pass market_yes_price — the signed edge in probability points and a YES cheap/rich/fair verdict. BTC/ETH price off the live Deribit IV smile (interpolated to strike + DTE); ANY other asset falls back to Hyperliquid 30d realized vol. iv_source labels which was used (smile/term_interp/skew_adj/atm/realized_vol). The touch case uses the correct drifted first-passage formula. Approximations are listed in caveats. | Not declared | Yes | Not declared | Yes |
get_pm_hl_divergencesMarkets where Polymarket implied probability diverges from Hyperliquid perpetual funding direction — e.g. PM prices bullish outcome but HL funding shows crowded longs (bearish pressure). The hardest signal to compute manually. | Not declared | Yes | Not declared | Yes |
get_portfolio_riskRisk analytics for a list of positions: per-position beta to BTC and ETH, sector concentration, pairwise correlation matrix, portfolio annualized volatility, 1-day 95% parametric VaR. Uses 14d of 1h Hyperliquid candles. | Not declared | Yes | Not declared | No |
get_position_sizeTurn a signal + bankroll into a concrete position: fractional-Kelly size capped by orderbook liquidity, ATR-based stop, liquidation price at chosen leverage, funding carry cost, and % bankroll at risk. Warns when liquidation sits inside the stop. Ground win_rate_pct with get_signal_performance or get_signal_backtest first. | Not declared | Yes | Not declared | Yes |
get_price_summaryOne-call snapshot for an asset: mark price, 24h and 7d returns, 30d high/low, drawdown from high, rally from low, annualized realised volatility. Computed from 30d of HL hourly candles. | Not declared | Yes | Not declared | Yes |
get_recent_newsRecent crypto news headlines matching an asset ticker, from CoinDesk + The Block + Decrypt + Cointelegraph RSS feeds. Pro adds the 1h price move that followed each headline. | Not declared | Yes | Not declared | Yes |
get_recent_signalsServer-detected events from the last hour: funding outliers (≥3x 7d baseline), whale trades (≥$100k), OI caps reached. Cursor-based — pass next_cursor back as since_id to receive only new events. The polling equivalent of the /sse/signals stream. Pro tool get_signal_history covers 7 days with forward-return outcomes. | Not declared | Yes | Not declared | Yes |
get_setup_qualityExecution-quality score (0-100, A-F grade) for entering a position right now: spread, slippage at desired size, orderbook depth, volatility regime, trend alignment, support/resistance proximity. Different from conviction (direction) — this scores ENTRY conditions. | Not declared | Yes | Not declared | Yes |
get_signal_backtestFind historical instances of a signal type on an asset over the last N days and compute forward returns (1h/4h/24h), win rate, and Sharpe. Lets an agent reason about EV before trading. Killer feature: turns predmcp from data API into edge-proven intelligence. | Not declared | Yes | Not declared | Yes |
get_signal_historyServer-detected signal events over up to 7 days (funding outliers, whale trades ≥$100k, OI caps), each joined with its measured forward returns (1h/4h/24h) once mature. Cursor-based. "What happened last time funding spiked on HYPE — and did it matter?" in one call. | Not declared | Yes | Not declared | Yes |
get_signal_performanceHit rates and average forward returns per signal type, measured on OUR actually-emitted production signals (not a backtest reconstruction). Use this to ground win_rate inputs for get_position_size. Sample sizes included — treat n < 10 as anecdotal. | Not declared | Yes | Not declared | Yes |
get_simple_ivBTC or ETH options snapshot via free Deribit public feed: ATM implied volatility, total OI, 24h volume. Pro adds put-call skew + full term structure parsing. | Not declared | Yes | Not declared | Yes |
get_top_funding_ratesTop Hyperliquid perps ranked by absolute funding rate, with OI and annualized yield. Useful for finding the most overcrowded longs/shorts and carry opportunities. | Not declared | Yes | Not declared | Yes |
get_upcoming_catalystsLists upcoming market catalysts for an asset within a horizon: token unlocks, governance votes (Tally), ETF/SEC deadlines, FOMC dates. Helps agents avoid blind trades into known events. Free data sources (Tally + curated DB). | Not declared | Yes | Not declared | Yes |
get_volume_spikesPolymarket markets with abnormal 24h volume vs their 7-day daily average. Volume spikes typically precede news events or informed positioning. | Not declared | Yes | Not declared | Yes |
get_whale_flowCumulative whale buy/sell imbalance over hours-to-days from the durable trade tape (≥$25k trades persisted continuously, restart-proof). Returns imbalance ratio (-1..+1), BUY/SELL_DOMINANT verdict, and the largest recent prints. Longer horizons than get_whale_trades (1h buffer). | Not declared | Yes | Not declared | Yes |
get_whale_labelLook up an Ethereum address against our curated label DB (CEX hot wallets, known market makers, suspected funds). Lets agents distinguish mechanical MM flow from alpha-generating activity. | Not declared | Yes | Not declared | No |
get_whale_positionsPositions of a specific Polymarket wallet, optionally filtered to one market. The /positions API requires a user (no public "all holders by market" endpoint), so pass the wallet address of the trader you want to inspect. | Not declared | Yes | Not declared | Yes |
get_whale_tradesRecent large trades on Hyperliquid perps above a notional threshold. Includes side (long/short), size, price, and timestamp. | Not declared | Yes | Not declared | Yes |
search_marketsFull-text search across all Polymarket and HIP-4 prediction markets. Returns ranked results with current odds. | Not declared | Yes | Not declared | Yes |
Details
- Registry status
- Active
- Published
- May 22, 2026
- Updated
- May 22, 2026
- Website
- Not given
- Categories (suggested)
- Search and webFinance and paymentsSecuritySuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
- GDPR
- Not declared