Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

PredMCP

REMOTE · PREDMCP.COM

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

Available components

0 this week 92 Trust /100

Last scanned (9 hours ago)

Scores higher than 99% of remote servers

Reachable. Last reached 5 Nov 2026.

Category Finance and Payments

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security91
  • The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
  • Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
  • HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
  • HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
  • DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
  • The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability100
Schema Quality & AI Usability77
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 6037 tokens (~116/item across 52 items; 52 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 52 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 52 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 28 Sept 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 25 Sept 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 20 Sept 26 0
    • Stability: fail → pass ▲ security
  • 26 Aug 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 21 Aug 26 0
    • Stability: 0.83 → fail ▼ security
    • A breaking change shipped without a version bump: still 0.7.0 ▼ security
    • Tool “get_signals” was removed ▼ security
    • Schema quality: pass → fail ▼ functional
    • New tool “get_market_edge” functional
    • New tool “get_market_edges” functional
    • New tool “get_news_feed” functional
    • New tool “get_news_signals” functional
    • New tool “get_outcome_edges” functional
    • New tool “get_outcome_fair_value” functional
  • 11 Aug 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 31 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 5 Nov 2026 · Probed https://predmcp.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=predmcp.com CN=YE1,O=Let's Encrypt,C=US 4 Nov 2026 2 Feb 2027 ECDSA 256 ECDSA-SHA384 68c706c4c29c0865a71b8325a33cc57b432
SANs: predmcp.com, www.predmcp.com
CN=YE1,O=Let's Encrypt,C=US (CA) CN=Root YE,O=ISRG,C=US 3 Sept 2025 2 Sept 2028 ECDSA 384 ECDSA-SHA384 5ddd70dd31f801c85c186a7a04b80afe
CN=Root YE,O=ISRG,C=US (CA) CN=ISRG Root X2,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 ECDSA 384 ECDSA-SHA384 872165fc34b6e5fba8add5b3705fb53a
CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) CN=ISRG Root X1,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 ECDSA 384 SHA256-RSA 6c8f1dc727c7117f7baf853ac980f9cd

Background: What to check on a remote MCP endpoint →

DNSSEC secure

Validation of predmcp.com. — Secure

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
com. present 19718 13 Verified
predmcp.com. present 54719 8 Verified
predmcp.com. Verified address RRset verified with the apex keys
Authentication Enforced and verified

The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.

Result Enforced and verified
Enforced On tool calls
HTTP status 200

WWW-Authenticate challenge Bearer realm="predmcp", error="invalid_token", resource_metadata="https://predmcp.com/.well-known/oauth-protected-resource"

Bearer realm="predmcp", error="invalid_token", resource_metadata="https://predmcp.com/.well-known/oauth-protected-resource"

Protected resource metadata

Document https://predmcp.com/.well-known/oauth-protected-resource
Retrieved Yes
Resource https://predmcp.com/mcp
Authorisation server https://predmcp.com

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://predmcp.com/mcp Verified 200
http (plaintext) http://predmcp.com/mcp HTTPS enforced 301 https://predmcp.com/mcp
MCP tools · 52 exposed · ~6,037 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
create_api_key ~65

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.

NameTypeReqDescription
emailstringyesYour email address — used to identify your key and for account recovery

No output schema declared.

No examples provided.

get_basic_macro ~65

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_carry_scanner ~111

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.

NameTypeReqDescription
size_usdcnumber–Intended position size in USDC — costs are computed at this size
top_ninteger–How many candidates to fully cost out (default 8 — each costs an orderbook call)

No output schema declared.

No examples provided.

get_cex_outflows ~107

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.

NameTypeReqDescription
exchangestring–Filter to a single exchange or aggregate all (default: all)
window_hoursnumber–Lookback window in hours (default: 24h, max: 7d)

No output schema declared.

No examples provided.

get_conviction_score ~139

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.

NameTypeReqDescription
assetstringyesAsset ticker to analyze, e.g. "BTC", "ETH", "HYPE"
min_whale_notional_usdcnumber–Whale trade threshold in USDC (default: 25,000)
whale_window_minutesinteger–Lookback window for whale trades (default: 60min)

No output schema declared.

No examples provided.

get_cross_venue_funding ~102

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.

NameTypeReqDescription
limitinteger–Max rows (default 15)
min_spread_annual_pctnumber–Minimum annualized funding spread between venues to report (default 5%)

No output schema declared.

No examples provided.

get_funding_curve_anomaly ~77

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.

NameTypeReqDescription
assetstringyesAsset ticker, e.g. "BTC", "HYPE"

No output schema declared.

No examples provided.

get_funding_outliers ~96

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

NameTypeReqDescription
daysinteger–Historical window in days to compute the baseline average (default: 7)
min_deviation_factornumber–Minimum ratio of |current_rate| / |avg_rate| to qualify as outlier (default: 2x)

No output schema declared.

No examples provided.

get_funding_rates ~72

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

NameTypeReqDescription
coinsarray–List of asset tickers to fetch, e.g. ["BTC", "ETH"]. Omit to fetch all available assets.

No output schema declared.

No examples provided.

get_hip4_vs_pm_arb ~88

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.

NameTypeReqDescription
min_spread_pctnumber–Minimum spread between HIP-4 and Polymarket YES prices to flag (percentage points, default: 3)

No output schema declared.

No examples provided.

get_late_game_sports ~90

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

NameTypeReqDescription
certainty_pctnumber–Minimum leading outcome probability as percentage, e.g. 85 = 85% (default: 85)
hours_maxnumber–Maximum hours until market closes (default: 6h)

No output schema declared.

No examples provided.

get_liquidation_clusters ~70

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.

NameTypeReqDescription
coinstringyesAsset ticker to analyze, e.g. "BTC", "ETH", "SOL"

No output schema declared.

No examples provided.

get_macro_context ~68

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_macro_liquidity ~54

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_market_context ~91

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.

NameTypeReqDescription
querystringyesTopic, asset, or keyword to look up — e.g. "BTC", "Iran", "Fed rate cut", "Trump"

No output schema declared.

No examples provided.

get_market_edge ~356

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.

NameTypeReqDescription
comparatorstring–Price-market shape.
expiry_isostring–Resolution time (ISO 8601) for price markets.
is_tradedboolean–Explicit attestation that the YES price comes from a real traded book. Alternative to vol_24h.
questionstringyesThe market question, e.g. "BTC above $70,000 at Aug 21 06:00 UTC?" or "Will Fed cut rates in September?"
strikenumber–Strike/threshold for price markets.
strike_highnumber–Upper bound for range price markets.
underlyingstring–Underlying ticker for price markets, e.g. "BTC".
vol_24hnumber–24h traded volume of the market. REQUIRED for an edge/verdict: absent (or 0) the YES price is treated as untraded and only the anchor is returned.
yes_pricenumber–Current on-chain YES price (0..1). Edge is only computed for a real traded price (0.5 exactly is treated as synthetic/untraded).

No output schema declared.

No examples provided.

get_market_edges ~166

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.

NameTypeReqDescription
limitinteger–Max markets to return (default 30, max 100).
methodstring–Filter to markets resolved via one anchor method. Passing "news" also enables the (slower) news lean.
min_edge_ptnumber–Only return markets whose |edge| in probability points is at least this (default 0 = whole board).

No output schema declared.

No examples provided.

get_market_regime ~84

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_markets ~105

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

NameTypeReqDescription
activeboolean–Filter to active/open markets only (default: true)
limitinteger–Number of markets to return (1–100, default: 20)
platformstring–Data source: "polymarket", "hip4", or "all" (default)

No output schema declared.

No examples provided.

get_markets_near_resolution ~90

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

NameTypeReqDescription
hoursnumber–Maximum hours until resolution (default: 24h, max: 168h = 7 days)
min_probnumber–Minimum leading outcome probability to include (default: 0.7 = 70%)

No output schema declared.

No examples provided.

get_movers ~66

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.

NameTypeReqDescription
limitinteger–Number of top movers to return (1–20, default: 10)

No output schema declared.

No examples provided.

get_news_correlation ~96

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.

NameTypeReqDescription
assetstringyesAsset ticker, e.g. "BTC", "ETH", "HYPE"
hours_backinteger–Lookback window for headlines (default: 24h, max: 7d)

No output schema declared.

No examples provided.

get_news_feed ~125

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.

NameTypeReqDescription
categorystring–Restrict to one feed category (default: all).
hours_backinteger–Lookback window in hours (default 24, max 168).
limitinteger–Max headlines returned (default 40, max 100).

No output schema declared.

No examples provided.

get_news_signals ~194

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.

NameTypeReqDescription
event_typestring–Filter to one event type.
hoursinteger–Lookback window for headlines (default 24h, max 72h).
limitinteger–Max signals to return (default 20, max 50).
min_confidencestring–Minimum confidence to include (default: low).

No output schema declared.

No examples provided.

get_odds ~88

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

NameTypeReqDescription
identifierstringyesFor Polymarket: the token_id of the YES or NO outcome. For HIP-4: the base asset ticker (e.g. "BTC")
platformstringyesPlatform the market is on: "polymarket" or "hip4"

No output schema declared.

No examples provided.

get_oi_divergence ~116

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.

NameTypeReqDescription
coinstring–One coin (e.g. "BTC") — omit to scan all tracked coins
hoursinteger–Lookback window in hours (default 24, max 90d)

No output schema declared.

No examples provided.

get_oi_history ~131

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.

NameTypeReqDescription
coinstringyesCoin, e.g. "BTC" (top ~30 by OI are tracked)
hoursinteger–Lookback window in hours (free tier max: 24)

No output schema declared.

No examples provided.

get_oi_near_cap ~45

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_options_iv ~83

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.

NameTypeReqDescription
assetstringyesUnderlying — Deribit only supports BTC and ETH for the free public feed.

No output schema declared.

No examples provided.

get_orderbook ~56

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

NameTypeReqDescription
token_idstringyesPolymarket token ID for the YES or NO side of a market

No output schema declared.

No examples provided.

get_orderbook_depth ~173

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.

NameTypeReqDescription
coinstringyesAsset ticker (BTC, ETH, SOL) or HIP-4 contract name (e.g. "BTC>81041@20260512-0600")
sidestring–Order side: "buy" (taker into asks) or "sell" (taker into bids)
size_usdcnumber–Order size in USDC to estimate slippage for (default: 200)

No output schema declared.

No examples provided.

get_outcome_edges ~195

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.

NameTypeReqDescription
limitinteger–Max markets to return (default 30, max 100).
min_edge_ptnumber–Only return markets whose |edge| in probability points is at least this (default 0 = the whole board).
underlyingstring–Filter to one underlying ticker, e.g. "BTC".

No output schema declared.

No examples provided.

get_outcome_fair_value ~338

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.

NameTypeReqDescription
assetstringyesUnderlying ticker, e.g. "BTC", "ETH", "SOL", "HYPE". BTC/ETH use the Deribit IV smile; others use Hyperliquid realized vol.
comparatorstringyesMarket shape: above/below a strike, inside a range [strike, strike_high], or touches the strike before expiry.
expiry_isostringyesMarket resolution time as an ISO 8601 string, e.g. "2026-08-21T06:00:00Z".
market_yes_pricenumber–Current on-chain YES price (0..1) to compute the edge against fair value.
strikenumberyesThe market's strike / threshold price, e.g. 70000.
strike_highnumber–Upper bound for range markets (must be > strike). Ignored otherwise.

No output schema declared.

No examples provided.

get_pm_hl_divergences ~98

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.

NameTypeReqDescription
limitinteger–Number of divergences to return (default: 15)
min_pctnumber–Minimum divergence percentage between PM implied probability and HL pricing to flag (default: 10%)

No output schema declared.

No examples provided.

get_portfolio_risk ~88

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.

NameTypeReqDescription
positionsarrayyesArray of positions: { asset, side, notional_usd }. Max 20.

No output schema declared.

No examples provided.

get_position_size ~219

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.

NameTypeReqDescription
assetstringyesAsset, e.g. "BTC"
bankroll_usdcnumberyesTotal capital available in USDC
directionstringyesTrade direction
kelly_fractionnumber–Fraction of full Kelly to use (default 0.25 — quarter Kelly)
leveragenumber–Intended leverage (default 3x)
max_slippage_pctnumber–Max acceptable slippage % — caps size by orderbook depth
payoff_rationumber–Avg win / avg loss ratio (default 1.5)
win_rate_pctnumber–Estimated win probability % (use get_signal_performance or get_signal_backtest to ground this)

No output schema declared.

No examples provided.

get_price_summary ~79

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.

NameTypeReqDescription
assetstringyesAsset ticker, e.g. "BTC", "HYPE"

No output schema declared.

No examples provided.

get_recent_news ~114

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.

NameTypeReqDescription
assetstringyesAsset ticker to filter on, e.g. "BTC", "ETH", "HYPE"
hours_backinteger–Lookback window in hours (default: 24, max: 168 = 7 days)
limitinteger–Max headlines returned (default: 10)

No output schema declared.

No examples provided.

get_recent_signals ~147

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.

NameTypeReqDescription
coinstring–Filter to one coin, e.g. "BTC"
limitinteger–Max events (free tier cap: 20)
since_idinteger–Cursor from a previous call — returns only events with id > since_id. Omit on first call.

No output schema declared.

No examples provided.

get_setup_quality ~118

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.

NameTypeReqDescription
assetstringyesAsset ticker, e.g. "BTC", "HYPE"
directionstringyesTrade direction you are considering
size_usdcnumber–Order size in USDC to evaluate slippage for (default: 200)

No output schema declared.

No examples provided.

get_signal_backtest ~232

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.

NameTypeReqDescription
assetstringyesAsset ticker, e.g. "BTC", "HYPE"
lookback_daysinteger–How many days of history to scan (default: 90, max: 180)
min_abs_ratenumber–For funding_extreme: minimum absolute funding rate (default: 0.0005 = 0.05%)
min_separation_hoursinteger–Cluster consecutive triggers — at least N hours apart (default: 8h)
signal_typestringyesWhich signal to backtest. funding_outlier = funding >= z×baseline; funding_extreme = abs(funding) >= threshold.
z_scorenumber–For funding_outlier: minimum deviation factor vs the rolling mean (default: 3×)

No output schema declared.

No examples provided.

get_signal_history ~166

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.

NameTypeReqDescription
coinstring–Filter to one coin, e.g. "BTC"
hours_backinteger–Lookback window in hours (default 24, max 168 = 7d)
limitinteger–Max events (default 50)
signal_typesarray–Filter to specific signal types
since_idinteger–Cursor — only events with id > since_id

No output schema declared.

No examples provided.

get_signal_performance ~112

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.

NameTypeReqDescription
coinstring–Filter to one coin, e.g. "BTC"
daysinteger–Lookback window (default 30, max 90)
signal_typestring–Filter to one signal type (default: all)

No output schema declared.

No examples provided.

get_simple_iv ~63

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.

NameTypeReqDescription
assetstringyesUnderlying — Deribit free feed supports BTC and ETH.

No output schema declared.

No examples provided.

get_top_funding_rates ~94

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

NameTypeReqDescription
limitinteger–Number of top results to return (default: 10)
min_abs_ratenumber–Minimum absolute funding rate to include, e.g. 0.0001. Omit to include all.

No output schema declared.

No examples provided.

get_upcoming_catalysts ~112

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

NameTypeReqDescription
assetstringyesAsset ticker, e.g. "ARB", "SOL", "BTC"
horizon_hoursinteger–Horizon in hours (default: 168 = 7 days, max: 720 = 30 days)

No output schema declared.

No examples provided.

get_volume_spikes ~88

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

NameTypeReqDescription
limitinteger–Number of results to return (default: 15)
min_rationumber–Minimum ratio of 24h volume vs 7-day daily average to qualify as a spike (default: 3x)

No output schema declared.

No examples provided.

get_whale_flow ~139

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

NameTypeReqDescription
coinstringyesCoin, e.g. "BTC" (top ~10 by OI are taped)
hoursinteger–Lookback window in hours (default 24)
min_notional_usdcnumber–Threshold for the sample trades list (tape floor: $25k)

No output schema declared.

No examples provided.

get_whale_label ~67

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.

NameTypeReqDescription
addressstringyesEthereum address to look up (0x-prefixed, 40 hex chars).

No output schema declared.

No examples provided.

get_whale_positions ~123

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.

NameTypeReqDescription
condition_idstring–Optional — filter results to a specific market by condition_id.
min_size_usdcnumber–Minimum position size in USDC to include in results (default: 1,000).
userstringyesPolygon wallet address (0x…) of the user whose positions you want.

No output schema declared.

No examples provided.

Install

How do I install the PredMCP MCP server?

PredMCP is a hosted endpoint at https://predmcp.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · predmcp.com

# add to Claude Code
claude mcp add --transport http raviolelabs-predmcp 'https://predmcp.com/mcp'
Common questions

What is the PredMCP MCP server?

PredMCP is an MCP server listed in the public MCP registry as io.github.RavioleLabs/predmcp. Polymarket + Hyperliquid + macro for AI agents. 38 tools, signal backtest, SSE streaming. Free tier. This page covers its hosted endpoint (https://predmcp.com/mcp).

Is the PredMCP MCP server safe to use?

PredMCP scores 92 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the PredMCP MCP server expose?

PredMCP exposes 52 tools: create_api_key, get_markets, get_odds, get_orderbook, search_markets, and 47 more. Their descriptions and schemas cost roughly 6,037 tokens of context every time the server is loaded.

Does the PredMCP MCP server require authentication?

Yes. PredMCP asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

Is the PredMCP MCP server still maintained?

PredMCP is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.