Polymarket + Hyperliquid through one MCP: a practical guide

If you trade prediction markets, perpetual futures, or just track them for signal, you spend half your day across two tabs: Polymarket for what the crowd thinks, Hyperliquid for what perp traders are positioning into. The gap between those two signals is where the alpha sits — and nobody scans it manually fast enough.

This is the practical guide for piping both into your AI agent through PredMCP, the MCP server we built and run at Raviole Labs.

What PredMCP gives you

22 tools, three categories:

1. Polymarket data — active markets, prices, ranges, daily volume, resolutions.
2. Hyperliquid perp data — funding rates, open interest, whale trades, liquidations, top movers.
3. Cross-venue signals — divergences between prediction markets and perp positioning, funding outliers (multi-sigma deviations), HIP-4 signal cross-checks.

All of it served as MCP tools. Your agent calls them, reasons over the numbers, and answers naturally. No glue code. No copy-pasting from two dashboards.

The integration in 3 minutes

1. Get a free API key

Head to predmcp.com/signup. Email required, no credit card. You get 100 calls per day on the free tier — enough for personal use and to feel out which tools actually help.

2. Add it to Claude Desktop

Edit your Claude Desktop config (~/Library/Application Support/Claude/ claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "predmcp": {
      "url": "https://predmcp.com/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. The hammer icon should show 22 new tools.

3. Ask a real question

What's the divergence between BTC perp funding on Hyperliquid and
the top BTC prediction markets on Polymarket today?

Claude will call get_pm_hl_divergences (or get_signals for a single coin), get back structured data for every BTC market and the matched perp funding state, and answer in prose with the actual numbers.

For Cursor or Windsurf, the config is similar — they both support MCP servers via the same URL + headers pattern.

The tools we actually use daily

Out of 22, these are the four we hit the most:

get_pm_hl_divergences

Scans every Hyperliquid perp and every Polymarket market, returns pairs where perp sentiment (funding direction + OI) disagrees with the prediction market probability for the same asset.

When BTC funding +0.0012 says longs are crowded but Polymarket BTC > $100k by month end is at YES 18%, you have a disagreement. One side is mispriced. The window is usually under two hours.

get_funding_outliers

Returns perps where current funding is more than N standard deviations above the 7-day average. Catches early signs of crowded positioning before the price moves to reflect it.

get_whales

Hyperliquid whale trades from the last hour, filtered by size and direction. Useful when combined with funding — a large new long when funding is already positive is a different signal than the same long when funding just flipped.

get_movers

Top Polymarket markets by 24h price change and volume. Quick way to spot “what is the prediction market crowd suddenly moving on?”

Why this is harder than it looks without an MCP

The naive version is:

1. Open Polymarket dashboard, find BTC markets, write down prices
2. Open Hyperliquid, check funding rates for BTC perp
3. Calculate the implied disagreement
4. Repeat for ETH, SOL, every asset you care about
5. By the time you finish, half of the data is stale

Doing this for 30 assets across 2 venues every morning costs you 20-30 minutes and you still miss the short-lived divergences.

With PredMCP it is one question to Claude, four seconds, answer in prose with the actual numbers. That is the entire pitch.

What we are NOT doing

This is a fair share of the questions we get:

• Not financial advice. PredMCP is a data layer, not a strategy. Your agent reasons over the numbers; your trade decisions are yours.
• Not order execution. No place_order tool. By design. Live position management belongs in your own agent stack (see our notes on Pythia, our autonomous trading agent, in the builder log).
• Not open source. The MCP server is proprietary. The free tier is generous. Drop us a line if you need more.
• Not just BTC/ETH. We track every Polymarket market and every active Hyperliquid perp. The interesting divergences are usually on mid-caps and event-driven markets.

Combining PredMCP with other MCPs

A common stack we see:

• PredMCP for market data
• A memory MCP (EngramMCP when it ships, or any vector store MCP today) for tracking which signals you have already acted on
• A messaging MCP (Telegram, Discord, your custom) for the agent to ping you on a high-confidence signal
• A browser MCP (RoverMCP) when you need the agent to actually navigate a DeFi UI

That stack costs you nothing on PredMCP free tier, and it replaces about three SaaS tools for a personal trader.

FAQ

Does it support Kalshi? Not today. Polymarket has the volume and the velocity for what we do. Kalshi is on the roadmap.

HIP-4 — is it a third source of markets? No. HIP-4 has very few markets, mostly BTC short-term price questions. Its real value in PredMCP is as a cross-check signal against Hyperliquid perp funding. We expose it specifically for divergence detection.

Latency? Tool responses sub-second in p50, capped at ~4s in p99. Data is fresh within 30s for prices and funding, 1-2 minutes for whale trades.

Auth? Single API key in x-api-key header. No OAuth, no expiring tokens. Rotate from your dashboard whenever.

Rate limit on free tier? 100 calls/day, soft burst of 10/min. Going over returns HTTP 429. Paid tiers if you need more — DM us.

Next steps

If you want to play: predmcp.com, free key, five minutes setup.

If you build MCP servers too, come trade notes in the Discord. We are particularly interested in what cross-source signals other MCP authors are surfacing — PredMCP for markets, what is the equivalent for on-chain flows? for sentiment? for orderflow?

Reach us on X / @LeRaviole_ or read more on the Raviole Labs blog.