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 分