# PredMCP

> Live data from Polymarket and Hyperliquid (perps + HIP-4) for any LLM that calls tools. 47 MCP tools, cross-venue signals, signal backtesting, SSE push streaming, OAuth 2.1 for claude.ai. Free tier 100 calls/day, Pro $9/mo with 7-day trial. Core open source on GitHub.

PredMCP is an HTTP MCP server that gives any tool-calling LLM (Claude.ai, Claude Desktop, Cursor, Windsurf, Cline, Continue, Zed, custom runtimes) direct access to:

- Live Polymarket markets (prices, order books, volume spikes, resolution timelines)
- Hyperliquid perps (funding rates, open interest, whale trades, liquidation clusters, OI caps)
- HIP-4 prediction markets on Hyperliquid
- Options IV from Deribit (ATM IV, put-call skew, term structure)
- Macro context (DXY, US10Y, SPX, VIX, gold, BTC dominance, ETF flows, stablecoin mints)
- Cross-venue intelligence (divergence detection, whale convergence, arbitrage scanning, conviction scoring, signal backtests)

It is the only MCP server that crosses all three crypto venues in a single API, and the only one that backtests its own signals (forward returns, win rate, Sharpe) so an agent can reason about EV before acting.

## When an agent should use PredMCP

- "What do markets think about [BTC | Iran | Fed rate cut]?" → `get_market_context`
- "Should I take this trade NOW?" → `get_setup_quality` (execution score 0-100)
- "How bullish/bearish is the evidence on ETH?" → `get_conviction_score` (-100..+100)
- "Did this signal historically work?" → `get_signal_backtest` (fwd returns + win rate)
- "Is there a cross-venue arb on BTC right now?" → `get_pm_hl_divergences` / `get_hip4_vs_pm_arb`
- "Show me funding outliers on Hyperliquid" → `get_funding_outliers`
- "What catalysts are coming for SOL this week?" → `get_upcoming_catalysts`

## Setup

Claude.ai (web): Settings → Connectors → Add custom connector → URL `https://predmcp.com/mcp` → OAuth sign-in with your email, no key needed.

All other clients:

```json
{
  "mcpServers": {
    "predmcp": {
      "type": "http",
      "url": "https://predmcp.com/mcp",
      "headers": { "x-api-key": "YOUR_KEY" }
    }
  }
}
```

Get a free API key at https://predmcp.com/signup (email, no credit card).

## Links

- [Homepage](https://predmcp.com)
- [Signup](https://predmcp.com/signup)
- [MCP endpoint](https://predmcp.com/mcp)
- [Server manifest](https://predmcp.com/server.json)
- [Full LLM ingestion doc](https://predmcp.com/llms-full.txt)
- [Source (open core)](https://github.com/RavioleLabs/predmcp)
- [Raviole Labs (parent org)](https://raviolelabs.com)
- [Discord](https://discord.gg/nVv6Ssr3)