Skip to main content
Glama
Hyperodds MCP

Hyperodds MCP

by usehyperodds

Give Claude, Cursor, VS Code or any other MCP client live data on Hyperliquid's HIP-4 outcome markets from every deployer: books, fair lines with their sources, rule comparisons where several deployers list the same question, and the newest listings. Free, with no key to set up.

@hyperodds/mcp is a bridge. It runs on your machine over stdio and forwards each request to the hosted Hyperodds MCP server at api.usehyperodds.com/mcp, where the tools and their data run. This repository holds the bridge only; the hosted server is not open source. The bridge has no dependencies, and the tools are read-only: none can trade or access an account.

Quick start

Claude Desktop (Settings > Developer > Edit Config), Cursor (~/.cursor/mcp.json, or .cursor/mcp.json in one project) and Windsurf take this entry:

{
  "mcpServers": {
    "hyperodds": {
      "command": "npx",
      "args": ["-y", "@hyperodds/mcp"]
    }
  }
}

Claude Code:

claude mcp add hyperodds -- npx -y @hyperodds/mcp

VS Code (.vscode/mcp.json):

{
  "servers": {
    "hyperodds": { "type": "stdio", "command": "npx", "args": ["-y", "@hyperodds/mcp"] }
  }
}

The package needs Node.js 22 or later. A client that connects to remote servers can skip it and use https://api.usehyperodds.com/mcp directly over Streamable HTTP.

Related MCP server: polymarket-mcp

What to ask

  • "Which HIP-4 markets show the biggest edge after fees right now?"

  • "Is the next Fed decision priced the same on every deployer, and do their rules match?"

  • "Where does the fair line for the BTC markets settling today come from, and how confident is it?"

  • "What was listed in the last hour?"

Tools

Tool

Input

Output

odds_markets

category, deployer, sort (volume, edge, new, settling), q, limit (up to 100), offset

Markets with bid, ask, fair line, best buy edge after fees, 24h volume, event time and status, plus how many match in total

odds_cluster

id, or the outcome of any member

One question listed by several deployers: each member's rule grade (SAME, CLOSE or DIFFERENT), the differences found and the merged book

odds_fair

outcome

One market's fair line: probability and band, method, confidence and flags, each source with its weight and age, plus the book and the edge for buying or selling either side

odds_new

category, limit (up to 100), offset

Markets in listing order, newest first, with the same fields as odds_markets

Your client receives each tool's input and output schema when it connects. The MCP guide explains the numbers.

How it works

Each message from the client goes out as one HTTPS request, and its response comes straight back. The bridge keeps no state beyond the protocol version agreed when the client connects. Requests run side by side. If one fails or gets no answer within 30 seconds, the client receives a JSON-RPC error that names the cause; a cancelled request is dropped. When the client closes the connection, the bridge drops what is still in flight and exits.

Reading the numbers

Prices are decimals from 0 to 1 for a market's first side, often Yes. Edges are percentage points after every fee, including the fee Hyperliquid takes at settlement, for a $100 order: 2.9 means 2.9¢ a share. An edge is null when $100 would not fill.

Price markets take their fair line from Deribit, Bybit and Cboe option surfaces, or from realized volatility on Hyperliquid perps. Sports and events take theirs from matched Polymarket and Kalshi quotes. Fair lines are estimates: edge rankings only use lines with a fairConfidence of at least 0.5 and more than one source, so check both before acting on one.

Limits

Each IP address gets 1,000 tool calls a day, reset at 00:00 UTC. Every request, tool call or not, also counts toward a rate limit of 5 a second, with bursts of up to 30. Past either limit, the server answers with an error that names it.

Configuration

Variable

Default

Purpose

HYPERODDS_MCP_URL

https://api.usehyperodds.com/mcp

The server to forward to

Set it in the client entry's env:

{
  "command": "npx",
  "args": ["-y", "@hyperodds/mcp"],
  "env": { "HYPERODDS_MCP_URL": "https://mcp.example.com/mcp" }
}

Behind a proxy, add HTTPS_PROXY and NODE_USE_ENV_PROXY=1 to the same env. Node.js reads the proxy only when the second is set, which needs Node.js 22.21 or later.

npx -y @hyperodds/mcp --help and --version print the usage and the version.

Development

git clone https://github.com/usehyperodds/hyperodds-mcp.git
cd hyperodds-mcp
npm ci
npm test

npm run lint and npm run typecheck run the other checks CI runs. See CONTRIBUTING.md before opening a pull request.

Security

Report vulnerabilities privately to security@usehyperodds.com, or through the repository's Security tab. Please do not open a public issue for them. SECURITY.md has the details.

License

MIT. Third-party names identify data sources and compatible clients; Hyperodds is not affiliated with any of them.

Available Tools

4 tools
odds_clusterSame question across deployersA
Read-onlyIdempotent

Gives one question listed by several HIP-4 deployers: each member's rule grade against the anchor (SAME, CLOSE or DIFFERENT) with the differences found, its top of book, and the merged book across SAME members. Look it up by cluster id or by any member's outcome id.

Inputs: id, outcome. Returns: id, kind, title, anchor, +3 more

odds_fairFair lineA
Read-onlyIdempotent

Gives one market's fair line (probability and band, method, confidence, and each source with its weight and age) with the top of book and the edge after all fees for each way to trade. Check confidence and singleSource before acting on the line.

Inputs: outcome (required). Returns: url, book, edge, fair, +4 more

odds_marketsHIP-4 marketsA
Read-onlyIdempotent

Lists HIP-4 outcome markets from every deployer with live top of book, fair line and edge after all fees. Filter by category, deployer or text, sort by edge, volume, new or settling, and page with offset.

Inputs: q, sort, limit, offset, +2 more. Returns: count, total, markets

odds_newNewest listingsA
Read-onlyIdempotent

Lists HIP-4 markets newest first, with the same fields as odds_markets. Outcome ids grow with each listing.

Inputs: limit, offset, category. Returns: count, total, markets

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation3/5

    odds_markets and odds_new overlap heavily: odds_new is essentially a newest-first view with the same fields, so an agent could reasonably pick either. odds_fair and odds_cluster are more clearly distinct, but the listing duplication keeps the set from being fully unambiguous.

    Naming Consistency5/5

    All tools use the same lowercase snake_case odds_ prefix with short, readable suffixes. There is no mixing of conventions or inconsistent verb styles.

    Tool Count4/5

    Four tools is a reasonable, focused surface for read-only odds analytics. However, odds_new does not fully earn its place because it largely duplicates odds_markets with a sort order.

    Completeness4/5

    The set covers market listing/filtering, fair-line detail, recent listings, and cross-deployer clustering, which is solid for a read-only analysis server. Minor gaps remain, such as direct market lookup or deployer-level metadata, but agents can work around them.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      MCP server for querying historical and real-time crypto market data across Hyperliquid, Hyperliquid HIP-3, and Lighter.xyz - orderbooks, trades, candles, funding, open interest, liquidations, and data quality metrics.
      100
      64 npm
      13
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A read-only MCP server exposing Polymarket's public prediction-market data. Search markets, read live odds and order books, pull historical probability time-series, and inspect public wallet positions.
      14
      46 PyPI
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A read-only MCP server for querying Hyperliquid perp markets, funding rates, order books, candles, and account positions/fills/funding for any address, without needing API keys or wallets.
      8
      2
      MIT