47 MCP tools that cross Polymarket prediction markets, Hyperliquid perps, and HIP-4 native predictions — with cross-venue divergence signals, funding outliers, and whale flow built in. Your agent reads every market; it never gets the keys to trade.
Hyperliquid
Safety by design
The #1 worry when wiring an LLM to a trading venue is the same in every conversation: "and it can't actually trade, right?" PredMCP is built so that question has a single answer.
Zero order-placement code exists in this codebase. Not gated, not commented out — not implemented. There is nothing to enable.
We use the public Hyperliquid Info API and Polymarket Gamma API. Your wallet, your seed phrase, your accounts — never seen, never asked for.
Markets, orderbooks, funding rates, whale activity, signals. Every tool is a read. Your agent reasons about markets; you stay the only one who can act on them.
47 MCP tools
Each tool is one verb your agent can call. Self-documenting via MCP. All 47 tools open during early access — no gating, no paid section.
The accumulation layer · 6 tools · data only predmcp has
Server-detected events from the last hour, cursor-based. The polling equivalent of the SSE stream — for agents that can't hold a connection.
7 days of detected events, each joined with its measured 1h/4h/24h forward return. "What happened last time — and did it matter?"
Hit rates measured on OUR production detections, not backtest reconstructions. The live track record.
Open-interest time series from our continuous 5-min collector. Hyperliquid has no OI-history endpoint — this exists only here.
Price-vs-OI regime per coin: NEW_LONGS / SHORT_SQUEEZE / NEW_SHORTS / LONG_LIQUIDATION.
Cumulative whale buy/sell imbalance over hours-to-days from the durable ≥$25k trade tape.
Decision support · 7 tools
Signal + bankroll → a number. Fractional-Kelly capped by orderbook depth, ATR stop, liquidation price, funding cost. Warns when liq sits inside your stop.
Forward returns (1h / 4h / 24h) for historical instances of any signal. Median, win rate, Sharpe. Reason about EV before trading.
Aggregates funding, whale flow, OI, momentum into one directional score (-100..+100) + strength (0..100). Replaces 6 calls.
Execution score (0-100, A-F): spread, slippage, depth, vol regime, trend alignment, S&R distance. How good is entering RIGHT NOW.
Funding carry NET of spread + slippage at your size, with break-even holding period and 7d stability score.
HL vs Binance vs Bybit predicted funding spreads. Delta-neutral carry: long the cheap venue, short the rich one.
Term structure: 1h vs 8h vs 24h vs 7d. Spikes, regime shifts, sign contradictions. Funding finer than the raw rate.
Cross-venue signals · 4 tools
Divergence between HL perp funding sentiment and HIP-4 prediction odds.
All Polymarket + HIP-4 markets for any topic plus live HL perp data in one call.
Markets where PM implied probability diverges from HL funding direction.
Same market on HIP-4 and Polymarket with exploitable spread between venues.
Macro & catalysts · 6 tools
One-call regime classifier: RISK_ON_TRENDING / RISK_OFF / SQUEEZE_RISK / CHOP. Call first, every session.
DXY, US10Y, S&P, gold, VIX, BTC dominance, ETH/BTC. RISK_ON / RISK_OFF regime.
BTC + ETH spot ETF flows (Farside) + USDT/USDC mint/burn (Etherscan). Fresh fiat-to-crypto flow.
Net ETH outflows from CEX hot wallets (Binance, Coinbase, OKX, Kraken). Outflow = bullish.
Token unlocks, governance votes (Tally), SEC/ETF deadlines, FOMC dates. Avoid blind event trades.
Recent crypto news headlines (4 outlets) + the 1h price move that followed.
Risk & options · 3 tools
Beta to BTC/ETH, correlation matrix, ann vol, 1d VaR for a list of positions.
BTC/ETH ATM IV, put-call skew, term structure via Deribit free feed.
Look up an Ethereum address in our curated label DB (CEX, market makers, funds).
Streaming · push, not polling
Server-Sent Events stream of funding_outlier_new, whale_trade, oi_cap_reached events as they fire. One persistent connection replaces 1h polling.
Hyperliquid · 6 tools
Funding + OI + mark price for one or all perps in a single call.
Top perps by absolute funding rate with OI and annualized yield.
Perps whose funding deviates from their 7-day average. Stronger signal than raw rate.
Perps at the OI cap. New longs blocked. Use as blacklist for entry.
Price levels where mass liquidations concentrate by leverage multiple.
Recent large trades above notional threshold, from the live 30s tape.
Polymarket & basics · 14 tools
Markets resolving in the next N hours with probability above threshold.
Markets with abnormal 24h volume vs 7-day average. Often precedes news.
Sports markets closing soon with high-certainty leading outcome.
Top 24h volume spikes and biggest price moves.
Live markets sorted by volume.
Current YES/NO price for any token.
Full orderbook depth for any Polymarket token.
Depth + slippage estimate for any HL perp or HIP-4 market.
Full-text search across Polymarket and HIP-4.
Positions of any Polymarket wallet, optionally filtered by market.
Mark price, 24h/7d returns, 30d high/low, annualized vol in one call.
DXY, US10Y, S&P 500, gold, VIX from free Yahoo feed.
Headlines for an asset from 4 crypto RSS feeds.
BTC/ETH ATM implied volatility + OI via Deribit.
Connect
Claude Desktop, Cursor, Windsurf, Cline, Continue, Clawbot, custom runtimes. Drop the endpoint into your config, restart, and the forty-seven tools show up.
Three setup paths. Claude.ai signs you in directly via OAuth — no key handling. Everything else uses an API key (replace YOUR_KEY).
macOS · Windows · Linux
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%Claudeclaude_desktop_config.json (Windows). Create it if missing.YOUR_KEY.Custom connector · No key needed
PredMCP.https://predmcp.com/mcp. Leave OAuth Client ID and OAuth Client Secret blank.Uses OAuth 2.1 + Dynamic Client Registration (RFC 7591). Claude.ai auto-discovers our endpoints and runs the flow — no key to copy, no JSON to paste. New users get a free account in the same step.
Any MCP-compatible client
~/.cursor/mcp.json · Windsurf: settings UI).x-api-key: YOUR_KEY or Authorization: Bearer YOUR_KEY.Sign up
100 calls per day free. No credit card. Works with Claude Desktop, Cursor, Windsurf, or any MCP client in 30 seconds.
Email required. One key per IP. Need help? Join the Raviole Labs Discord.
Already have a key? Recover with email →
Your API key is ready.
Click to copy
You signed up during early access — you're in. Need a higher rate limit? Ping us on Discord.
Pricing
All 47 tools open. No credit card. Paid plans land once we see real usage — the first 50 signups stay grandfathered for 90 days when they do.
EARLY ACCESS
FIRST 50 GRANDFATHERED