{
  "markdown": "# PredMCP\n\n**Safe, read-only market data for AI trading agents.**\n\n44 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.\n\nLive, hosted, free during early access: [predmcp.com](https://predmcp.com)\n\n## Why read-only matters\n\nThe #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.\n\n- **No execution endpoint.** Zero order-placement code exists in this codebase. Not gated, not commented out — not implemented. There is nothing to enable.\n- **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.\n- **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.\n\n## What's in the box\n\n### Public data (any free key)\n| Family | Tools |\n|--------|-------|\n| 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` |\n| 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` |\n| Macro & price | `get_price_summary` · `get_basic_macro` · `get_recent_news` · `get_simple_iv` |\n\n### Intelligence (early access — free during the open phase)\n| Family | Tools |\n|--------|-------|\n| 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` |\n| Signal intelligence | `get_signal_backtest` · `get_conviction_score` · `get_funding_curve_anomaly` · `get_setup_quality` · `explain_signal` |\n| Macro & flow | `get_macro_context` · `get_macro_liquidity` · `get_cex_outflows` · `get_upcoming_catalysts` · `get_news_correlation` |\n| Agent-native UX | `get_portfolio_risk` · `get_options_iv` · `get_social_velocity` · `get_whale_label` |\n\nEach tool is one verb your agent can call. Self-documenting via MCP.\n\n## Examples\n\n**Iran — what prediction markets say right now:**\n```\n\"US x Iran peace deal by May 15\"    → YES 20%  ($9M volume)\n\"US x Iran peace deal by May 31\"    → YES 34%  ($16M volume, +4% today)\n\"Iranian regime falls before 2027\"  → YES 15%  ($17M volume)\n\"US invades Iran before 2027\"       → YES 21%  ($26M volume)\n```\nOne `get_market_context` call.\n\n**BTC cross-platform signal:**\n```\nHL perps:  $79,740  |  funding: neutral  |  OI: 31,100 BTC\nHIP-4:     BTC > $81,041 by 6am tomorrow  →  YES 12%  (market says no)\nSignal:    ✓ ALIGNED — perps neutral, prediction bearish\n```\nWhen these diverge, it's a signal. `get_signals` computes it.\n\n**24h movers:**\n```\n\"Will Bitcoin hit $150k by June 30?\"   $5.8M traded in 24h\n\"US x Iran permanent peace deal\"       $3.2M in 24h  (+4% move)\nAthletics vs Phillies                  +55% price move\n```\n\n## Use the hosted server (recommended)\n\nGet a free API key (email, no credit card, 100 calls/day) at [predmcp.com/signup](https://predmcp.com/signup), then drop into your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"predmcp\": {\n      \"type\": \"http\",\n      \"url\": \"https://predmcp.com/mcp\",\n      \"headers\": { \"x-api-key\": \"YOUR_KEY\" }\n    }\n  }\n}\n```\n\nAlso works with Cursor, Windsurf, Claude.ai (OAuth), and any MCP client that supports HTTP transport.\n\nAsk your agent:\n- *\"What are prediction markets saying about Iran right now?\"*\n- *\"Is there a divergence between BTC perp traders and prediction markets?\"*\n- *\"What markets moved the most in the last 24 hours?\"*\n- *\"Are any whales active on both Hyperliquid and Polymarket for BTC right now?\"*\n\n## Early access\n\nWe'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.\n\n## Self-host\n\nThe 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.\n\n```bash\ngit clone https://github.com/RavioleLabs/predmcp\ncd predmcp\nnpm install\nnpm run build\nIP_HASH_PEPPER=\"$(openssl rand -hex 32)\" npm start\n```\n\nServer runs on `http://localhost:3000/mcp`. Public data sources require no upstream API keys.\n\n## Stack\n\nTypeScript · Fastify · MCP SDK · SQLite (better-sqlite3) · Polymarket Gamma API · Hyperliquid Info API\n\n## License\n\nMIT — Raviole Labs.\n",
  "bytes": 4848,
  "sha": "bee28329a8553ddf969aa613f324194eec40fb90e9b2cd393f32056c51baf2ab",
  "repo_slug": "raviolelabs/predmcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_raviolelabs_predmcp_08d5d14e/readme"
}