Predmcp
@RavioleLabs
About Predmcp
Real-time Polymarket + Hyperliquid intelligence over MCP. OAuth 2.1 + DCR, SSE streaming, free tier 100 calls/day.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"predmcp": {
"type": "http",
"url": "https://predmcp.com/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}Tools
22Detect divergence signals between Hyperliquid perpetual funding/OI sentiment and HIP-4 on-chain prediction market odds. Returns BULLISH/BEARISH/DIVERGENCE signal with reasoning — e.g. perps long-biased while prediction market prices a decline.
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.
Detect simultaneous whale activity on both Hyperliquid perps and Polymarket for an asset. Flags convergence events where large perp trades and large prediction market positions align — a leading indicator of informed positioning.
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.
Live prediction markets from Polymarket and/or HIP-4, sorted by volume. Returns title, YES/NO prices, 24h volume, and expiry.
Current YES/NO prices and implied probability for any Polymarket or HIP-4 market token.
Full orderbook depth (bids + asks) for any Polymarket market token. Shows liquidity at each price level.
Full-text search across all Polymarket and HIP-4 prediction markets. Returns ranked results with current odds.
Current funding rates for Hyperliquid perpetuals. Positive rate = longs pay shorts (bearish bias); negative = shorts pay longs (bullish bias).
Total open interest in USD and contracts for Hyperliquid perpetuals. Rising OI + rising price = strong trend; rising OI + falling price = short build-up.
Recent large trades on Hyperliquid perps above a notional threshold. Includes side (long/short), size, price, and timestamp.
Largest current position holders in a Polymarket prediction market. Shows wallet address, position size in USDC, and side (YES/NO).
Top Hyperliquid perps ranked by absolute funding rate, with OI and annualized yield. Useful for finding the most overcrowded longs/shorts and carry opportunities.
Hyperliquid perps whose current funding rate deviates significantly from their 7-day average. A spike vs baseline is a stronger signal than raw rate.
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.
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.
Polymarket markets resolving within the next N hours with a leading probability above threshold. Useful for resolution arbitrage and last-minute positioning.
Polymarket markets with abnormal 24h volume vs their 7-day daily average. Volume spikes typically precede news events or informed positioning.
Sports prediction markets on Polymarket closing within a few hours with a high-certainty leading outcome. Targets near-certain resolution for late-game positioning.
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.
Pairs each Hyperliquid asset (with notable funding) with related Polymarket markets, showing whether funding direction and PM probability are aligned or divergent.
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.
Overview
What is PredMCP?
PredMCP is a read-only MCP server that provides 44 tools for querying market data from Polymarket prediction markets, Hyperliquid perpetuals, and HIP-4 native predictions. It is designed for AI trading agents to access live trading data without the ability to execute orders.
How to use PredMCP?
Use the hosted server by obtaining a free API key at predmcp.com/signup (100 calls/day, no credit card) and configure your MCP client (e.g., Claude Desktop, Cursor, Windsurf) with the HTTP transport URL and API key. Alternatively, self-host the open-source core by cloning the repository, running npm install && npm run build, and starting with IP_HASH_PEPPER="$(openssl rand -hex 32)" npm start.
Key features of PredMCP
- 44 read-only MCP tools across three prediction venues.
- No execution endpoint – zero order-placement code.
- No private keys required – uses public APIs only.
- Tools include market data, orderbooks, funding rates, signals.
- Cross-venue intelligence signals (e.g., divergence detection).
- Free during early access, hosted version available.
Use cases of PredMCP
- AI agent queries prediction market odds for geopolitical events.
- Agent monitors funding rate divergences between Hyperliquid and Polymarket.
- Agent identifies whale activity across both venues.
- Agent analyzes market volume spikes and movers in 24 hours.
- Agent compares BTC perp pricing with HIP-4 prediction markets.
FAQ from PredMCP
Does PredMCP allow trading?
No. The codebase contains zero order-placement code – not gated, not commented out, not implemented. Every tool is a read-only query.
What data sources does PredMCP use?
It uses the public Hyperliquid Info API, Polymarket Gamma API, and HIP-4 native predictions. No private keys or wallet data are ever accessed.
How do I get started with the hosted server?
Sign up for a free API key at predmcp.com/signup (email only, no credit card, 100 calls/day). Then add the HTTP transport configuration to your MCP client with the provided URL and API key.
Can I self-host PredMCP?
Yes, the open-source core is available on GitHub. It covers the read-only data layer (Polymarket + Hyperliquid wrappers, MCP server, signup/auth). The intelligence/private tools (signals, conviction scores, macro flow) are only available in the hosted version.
What are the runtime requirements?
The server is built with TypeScript, Fastify, MCP SDK, SQLite (better-sqlite3), and interfaces with Polymarket Gamma API and Hyperliquid Info API. It runs on Node.js.
More Other MCP servers
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
Awesome-MCP-ZH
yzflyMCP 资源精选， MCP指南，Claude MCP，MCP Servers, MCP Clients
Comments