# predmcp ## Quick Start ```bash # Connect this server (installs CLI if needed) npx -y smithery mcp add leraviole/predmcp # Browse available tools npx -y smithery tool list leraviole/predmcp # Get full schema for a tool npx -y smithery tool get leraviole/predmcp create_api_key # Call a tool npx -y smithery tool call leraviole/predmcp create_api_key '{}' ``` ## Direct MCP Connection Endpoint: `https://predmcp--leraviole.run.tools` ## Tools (24) - `create_api_key` — Generate a free PredMCP API key instantly — no email required. Returns the key and ready-to-use MCP config. Call this f… - `get_signals` — Detect divergence signals between Hyperliquid perpetual funding/OI sentiment and HIP-4 on-chain prediction market odds.… - `get_market_context` — Unified intelligence snapshot for any topic, asset, or keyword: all matching Polymarket and HIP-4 prediction markets co… - `get_whale_convergence` — Detect simultaneous whale activity on both Hyperliquid perps and Polymarket for an asset. Flags convergence events wher… - `get_movers` — Top prediction markets ranked by 24h volume spike or biggest YES/NO price swing. Surfaces breaking news bets and moment… - `get_markets` — Live prediction markets from Polymarket and/or HIP-4, sorted by volume. Returns title, YES/NO prices, 24h volume, and e… - `get_odds` — Current YES/NO prices and implied probability for any Polymarket or HIP-4 market token. - `get_orderbook` — Full orderbook depth (bids + asks) for any Polymarket market token. Shows liquidity at each price level. - `search_markets` — Full-text search across all Polymarket and HIP-4 prediction markets. Returns ranked results with current odds. - `get_funding_rates` — Current funding rates for Hyperliquid perpetuals. Positive rate = longs pay shorts (bearish bias); negative = shorts pa… - `get_open_interest` — Total open interest in USD and contracts for Hyperliquid perpetuals. Rising OI + rising price = strong trend; rising OI… - `get_whale_trades` — Recent large trades on Hyperliquid perps above a notional threshold. Includes side (long/short), size, price, and times… - `get_whale_positions` — Largest current position holders in a Polymarket prediction market. Shows wallet address, position size in USDC, and si… - `get_top_funding_rates` — Top Hyperliquid perps ranked by absolute funding rate, with OI and annualized yield. Useful for finding the most overcr… - `get_funding_outliers` — Hyperliquid perps whose current funding rate deviates significantly from their 7-day average. A spike vs baseline is a … - `get_oi_near_cap` — Lists Hyperliquid perps that are currently at the open interest cap — new long positions cannot be opened. Use as a bla… - `get_liquidation_clusters` — Estimated price levels where mass liquidations concentrate for a given Hyperliquid perp, computed from mark price and s… - `get_orderbook_depth` — Full orderbook depth + slippage estimate for any Hyperliquid perp or HIP-4 market. Returns top of book, spread, cumulat… - `get_markets_near_resolution` — Polymarket markets resolving within the next N hours with a leading probability above threshold. Useful for resolution … - `get_volume_spikes` — Polymarket markets with abnormal 24h volume vs their 7-day daily average. Volume spikes typically precede news events o… - `get_late_game_sports` — Sports prediction markets on Polymarket closing within a few hours with a high-certainty leading outcome. Targets near-… - `get_pm_hl_divergences` — Markets where Polymarket implied probability diverges from Hyperliquid perpetual funding direction — e.g. PM prices bul… - `get_hl_funding_pm_correlation` — Pairs each Hyperliquid asset (with notable funding) with related Polymarket markets, showing whether funding direction … - `get_hip4_vs_pm_arb` — Finds the same underlying market priced on both HIP-4 (on-chain Hyperliquid) and Polymarket, flagging spreads above thr… ```bash # Get full input/output schema for a tool npx -y smithery tool get leraviole/predmcp ```