PredMCP

io.github.RavioleLabs由 GitHub 帳號 RavioleLabs 發布v0.5.0更新於 Oct 27, 2026

Polymarket + Hyperliquid + macro for AI agents. 38 tools, signal backtest, SSE streaming. Free tier.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取金融資料與分析

概覽

AI 產生的概覽

唯讀市場資料伺服器,讓助理查詢 Polymarket、Hyperliquid 與 HIP-4 的賠率、資金費率、巨鯨動向與訊號。

可以做什麼
  • 搜尋、列出並讀取預測市場:賠率、訂單簿、異動排行、成交量暴增與即將結算的市場
  • 讀取 Hyperliquid 永續合約資料:資金費率、巨鯨成交、未平倉量、訂單簿深度與滑價、持倉上限
  • 取得總經與價格背景:價格摘要、美元指數/美債殖利率/標普/黃金/VIX、加密新聞標題、選擇權隱含波動率、ETF 與穩定幣資金流
  • 掃描錯價與跨平台訊號:合理價差、Polymarket 與 Hyperliquid 背離、HIP-4 與 Polymarket 套利、信心分數與進場品質評分
  • 回測訊號,並檢視巨鯨錢包、催化事件與市場狀態
適用情境
適合需要即時預測市場或永續合約背景來做研究、訊號掃描與交易分析的場合,同時把下單執行完全留在助理之外。
執行需求
透過 HTTP 傳輸連線到 predmcp.com 的遠端託管端點;需要 x-api-key 標頭中的 API 金鑰,以電子郵件註冊取得(免費額度每天 100 次呼叫,每個 IP 一組金鑰)。自行架設開源核心需要 Node.js 與 npm。
安裝前請注意
API 金鑰是機密,透過 x-api-key 標頭傳送。伺服器設計為唯讀,不索取錢包私鑰或助記詞,但輸出的是市場資料與啟發式訊號,並非投資建議。查詢內容會送到第三方託管服務,部分工具標示為 Pro 或早期存取,可用性可能變動。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 PredMCP,將其新增到工作區。
  2. 連接 x-api-key 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.RavioleLabs%2Fpredmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "predmcp": {
      "type": "http",
      "url": "https://predmcp.com/mcp",
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

PredMCP

Safe, read-only market data for AI trading agents.

44 MCP tools that cross Polymarket prediction markets, Hyperliquid perps, and HIP-4 native predictions. Plug your agent into live trading data — without ever giving it the ability to execute orders.

Live, hosted, free during early access: predmcp.com

Why read-only matters

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.

  • No execution endpoint. Zero order-placement code exists in this codebase. Not gated, not commented out — not implemented. There is nothing to enable.
  • No private keys touched. We use the public Hyperliquid Info API and Polymarket Gamma API. Your wallet, your seed phrase, your accounts — never seen, never asked for.
  • 44 tools, all queries. 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.

What's in the box

Public data (any free key)

FamilyTools
Polymarketget_markets · get_odds · get_orderbook · get_whale_positions · search_markets · get_movers · get_markets_near_resolution · get_volume_spikes · get_late_game_sports
Hyperliquid perpsget_funding_rates · get_open_interest · get_whale_trades · get_orderbook_depth · get_top_funding_rates · get_oi_near_cap · get_funding_momentum
Macro & priceget_price_summary · get_basic_macro · get_recent_news · get_simple_iv

Intelligence (early access — free during the open phase)

FamilyTools
Cross-venue signalsget_signals · get_market_context · get_pm_hl_divergences · get_hl_funding_pm_correlation · get_hip4_vs_pm_arb · get_whale_convergence
Signal intelligenceget_signal_backtest · get_conviction_score · get_funding_curve_anomaly · get_setup_quality · explain_signal
Macro & flowget_macro_context · get_macro_liquidity · get_cex_outflows · get_upcoming_catalysts · get_news_correlation
Agent-native UXget_portfolio_risk · get_options_iv · get_social_velocity · get_whale_label

Each tool is one verb your agent can call. Self-documenting via MCP.

Examples

Iran — what prediction markets say right now:

"US x Iran peace deal by May 15"    → YES 20%  ($9M volume)"US x Iran peace deal by May 31"    → YES 34%  ($16M volume, +4% today)"Iranian regime falls before 2027"  → YES 15%  ($17M volume)"US invades Iran before 2027"       → YES 21%  ($26M volume)

One get_market_context call.

BTC cross-platform signal:

HL perps:  $79,740  |  funding: neutral  |  OI: 31,100 BTCHIP-4:     BTC > $81,041 by 6am tomorrow  →  YES 12%  (market says no)Signal:    ✓ ALIGNED — perps neutral, prediction bearish

When these diverge, it's a signal. get_signals computes it.

24h movers:

"Will Bitcoin hit $150k by June 30?"   $5.8M traded in 24h"US x Iran permanent peace deal"       $3.2M in 24h  (+4% move)Athletics vs Phillies                  +55% price move

Use the hosted server (recommended)

Get a free API key (email, no credit card, 100 calls/day) at predmcp.com/signup, then drop into your claude_desktop_config.json:

json
{  "mcpServers": {    "predmcp": {      "type": "http",      "url": "https://predmcp.com/mcp",      "headers": { "x-api-key": "YOUR_KEY" }    }  }}

Also works with Cursor, Windsurf, Claude.ai (OAuth), and any MCP client that supports HTTP transport.

Ask your agent:

  • "What are prediction markets saying about Iran right now?"
  • "Is there a divergence between BTC perp traders and prediction markets?"
  • "What markets moved the most in the last 24 hours?"
  • "Are any whales active on both Hyperliquid and Polymarket for BTC right now?"

Early access

We're in an open early-access phase: all 44 tools, no gating, no credit card. The first 50 signups stay grandfathered for 90 days when paid plans launch.

Self-host

The public OSS core covers the read-only data layer (Polymarket + Hyperliquid wrappers, MCP server, signup/auth). The intelligence/private tools (signals, conviction scores, macro flow) live in a private side module — the hosted version exposes them, the OSS one doesn't.

bash
git clone https://github.com/RavioleLabs/predmcpcd predmcpnpm installnpm run buildIP_HASH_PEPPER="$(openssl rand -hex 32)" npm start

Server runs on http://localhost:3000/mcp. Public data sources require no upstream API keys.

Stack

TypeScript · Fastify · MCP SDK · SQLite (better-sqlite3) · Polymarket Gamma API · Hyperliquid Info API

License

MIT — Raviole Labs.

來源:README.md,提交 b127449

工具

52

create_api_key

Create API Key

Generate 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.

輸入參數email必填

get_markets

Get Markets

Live prediction markets from Polymarket and/or HIP-4, sorted by volume. Returns title, YES/NO prices, 24h volume, and expiry.

輸入參數limitactiveplatform

get_odds

Get Odds

Current YES/NO prices and implied probability for any Polymarket or HIP-4 market token.

輸入參數platform必填identifier必填

get_orderbook

Get Orderbook

Full orderbook depth (bids + asks) for any Polymarket market token. Shows liquidity at each price level.

輸入參數token_id必填

search_markets

Search Markets

Full-text search across all Polymarket and HIP-4 prediction markets. Returns ranked results with current odds.

輸入參數limitquery必填

get_whale_positions

Get Whale Positions

Positions 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.

輸入參數user必填condition_idmin_size_usdc

get_movers

Get Movers

Top 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.

輸入參數limit

get_markets_near_resolution

Get Markets Near Resolution

Polymarket markets resolving within the next N hours with a leading probability above threshold. Useful for resolution arbitrage and last-minute positioning.

輸入參數hoursmin_prob

get_volume_spikes

Get Volume Spikes

Polymarket markets with abnormal 24h volume vs their 7-day daily average. Volume spikes typically precede news events or informed positioning.

輸入參數limitmin_ratio

get_late_game_sports

Get Late Game Sports

Sports prediction markets on Polymarket closing within a few hours with a high-certainty leading outcome. Targets near-certain resolution for late-game positioning.

輸入參數hours_maxcertainty_pct

get_funding_rates

Get Funding Rates

Current funding rates for Hyperliquid perpetuals. Positive rate = longs pay shorts (bearish bias); negative = shorts pay longs (bullish bias).

輸入參數coins

get_whale_trades

Get Whale Trades

Recent large trades on Hyperliquid perps above a notional threshold. Includes side (long/short), size, price, and timestamp.

輸入參數coin必填min_notional_usdc

get_top_funding_rates

Get Top Funding Rates

Top Hyperliquid perps ranked by absolute funding rate, with OI and annualized yield. Useful for finding the most overcrowded longs/shorts and carry opportunities.

輸入參數limitmin_abs_rate

get_oi_near_cap

Get OI Near Cap

Lists 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.

無需輸入參數。

get_orderbook_depth

Get Orderbook Depth

Full 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.

輸入參數coin必填sidesize_usdc

get_price_summary

Get Price Summary

One-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.

輸入參數asset必填

get_basic_macro

Get Basic Macro

DXY, 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.

無需輸入參數。

get_recent_news

Get Recent News

Recent 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.

輸入參數asset必填limithours_back

get_news_feed

Get News Feed

Recent 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.

輸入參數limitcategoryhours_back

get_simple_iv

Get Simple IV

BTC 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.

輸入參數asset必填

get_outcome_fair_value

Get Outcome Fair Value

Options/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.

輸入參數asset必填strike必填comparator必填expiry_iso必填strike_highmarket_yes_price

get_outcome_edges

Get Outcome Edges

One-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.

輸入參數limitunderlyingmin_edge_pt

get_market_edge

Get Market Edge

Universal 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.

輸入參數strikevol_24hquestion必填is_tradedyes_pricecomparatorexpiry_isounderlyingstrike_high

get_market_edges

Get Market Edges

One-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.

輸入參數limitmethodmin_edge_pt

get_news_signals

Get News Signals

News → 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.

輸入參數hourslimitevent_typemin_confidence

get_recent_signals

Get Recent Signals

Server-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.

輸入參數coinlimitsince_id

get_oi_history

Get OI History

Open-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.

輸入參數coin必填hours

get_market_regime

Get Market Regime

One-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.

無需輸入參數。

get_market_context

Get Market Context

Unified 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.

輸入參數query必填

get_pm_hl_divergences

Get PM/HL Divergences

Markets 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.

輸入參數limitmin_pct

get_hip4_vs_pm_arb

Get HIP-4 vs PM Arb

Finds 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.

輸入參數min_spread_pct

get_funding_outliers

Get Funding Outliers

Hyperliquid perps whose current funding rate deviates significantly from their 7-day average. A spike vs baseline is a stronger signal than raw rate.

輸入參數daysmin_deviation_factor

get_liquidation_clusters

Get Liquidation Clusters

Estimated 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.

輸入參數coin必填

get_signal_backtest

Get Signal Backtest

Find 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.

輸入參數asset必填z_scoresignal_type必填min_abs_ratelookback_daysmin_separation_hours

get_conviction_score

Get Conviction Score

Aggregates 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.

輸入參數asset必填whale_window_minutesmin_whale_notional_usdc

get_funding_curve_anomaly

Get Funding Curve Anomaly

Term-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.

輸入參數asset必填

get_setup_quality

Get Setup Quality

Execution-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.

輸入參數asset必填direction必填size_usdc

get_upcoming_catalysts

Get Upcoming Catalysts

Lists 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).

輸入參數asset必填horizon_hours

get_macro_context

Get Macro Context

Live 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.

無需輸入參數。

get_macro_liquidity

Get Macro Liquidity

Fiat-to-crypto liquidity gauge: BTC + ETH spot ETF flows (Farside) plus on-chain USDT + USDC mint/burn (Etherscan). Net inflow = bullish for risk assets.

無需輸入參數。

get_cex_outflows

Get CEX Outflows

Net 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.

輸入參數exchangewindow_hours

get_news_correlation

Get News Correlation

Recent 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.

輸入參數asset必填hours_back

get_portfolio_risk

Get Portfolio Risk

Risk 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.

輸入參數positions必填

get_options_iv

Get Options IV

BTC 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.

輸入參數asset必填

get_whale_label

Get Whale Label

Look 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.

輸入參數address必填

get_signal_history

Get Signal History

Server-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.

輸入參數coinlimitsince_idhours_backsignal_types

get_signal_performance

Get Signal Performance

Hit 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.

輸入參數coindayssignal_type

get_oi_divergence

Get OI Divergence

Price-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.

輸入參數coinhours

get_whale_flow

Get Whale Flow

Cumulative 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).

輸入參數coin必填hoursmin_notional_usdc

get_position_size

Get Position Size

Turn 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.

輸入參數asset必填leveragedirection必填payoff_ratiowin_rate_pctbankroll_usdc必填kelly_fractionmax_slippage_pct

get_carry_scanner

Get Carry Scanner

Funding 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.

輸入參數top_nsize_usdc

get_cross_venue_funding

Get Cross-Venue Funding

Predicted 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.

輸入參數limitmin_spread_annual_pct

版本歷史

1
  1. v0.5.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分