PredMCP

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)

Intelligence (early access — free during the open phase)

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 BTC

HIP-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:

{

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

git clone https://github.com/RavioleLabs/predmcp

cd predmcp npm install npm run build IP_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.