Polymarket + HIP-4 + Hyperliquid perps for Claude. 22 tools, signals & arb. Free tier.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON â–¾
Client Config & Setup
Remote HTTPChoose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
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)
| Family | Tools |
|---|---|
| Polymarket | get_markets · get_odds · get_orderbook · get_whale_positions · search_markets · get_movers · get_markets_near_resolution · get_volume_spikes · get_late_game_sports |
| Hyperliquid perps | get_funding_rates · get_open_interest · get_whale_trades · get_orderbook_depth · get_top_funding_rates · get_oi_near_cap · get_funding_momentum |
| Macro & price | get_price_summary · get_basic_macro · get_recent_news · get_simple_iv |
Intelligence (early access — free during the open phase)
| Family | Tools |
|---|---|
| Cross-venue signals | get_signals · get_market_context · get_pm_hl_divergences · get_hl_funding_pm_correlation · get_hip4_vs_pm_arb · get_whale_convergence |
| Signal intelligence | get_signal_backtest · get_conviction_score · get_funding_curve_anomaly · get_setup_quality · explain_signal |
| Macro & flow | get_macro_context · get_macro_liquidity · get_cex_outflows · get_upcoming_catalysts · get_news_correlation |
| Agent-native UX | get_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:
One get_market_context call.
BTC cross-platform signal:
When these diverge, it's a signal. get_signals computes it.
24h movers:
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:
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.
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.
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about PredMCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/predmcp)HTML Embed
<a href="https://allmcps.com/mcp/predmcp"><img src="https://allmcps.com/api/badge/predmcp?style=directory" alt="PredMCP on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
5/7 checks healthy over the last 45d
36Quality signal: Fair · 36/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools16/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.