Hyperodds MCP server
Commit Nov 7, 2026Provides live Hyperliquid HIP-4 market data, including books, fair lines, and rule comparisons, to MCP clients.
Also known as usehyperodds/hyperodds-mcp
- Stars
- 0
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 7, 2026
- License
- MIT
What is Hyperodds MCP?
Hyperodds provides live Hyperliquid HIP-4 market data, including books, fair lines, and rule comparisons, to MCP clients. It exposes 4 tools, such as odds_markets, odds_cluster, odds_fair.
Summary generated from the project's README
About Hyperodds MCP server
Accessing live Hyperliquid HIP-4 market data from within your AI coding environment is what this server enables. It provides real-time information on outcome markets, including order books, fair lines, and rule comparisons across different deployers. Developers using Claude Desktop, Cursor, VS Code, or Windsurf can integrate this data to analyze market edges and liquidity directly through their preferred MCP client.
The setup uses a bridge running on your local machine via stdio that forwards requests to a hosted server. It requires Node.js 22 or later and can be installed using npx. The service is free to use and does not require an API key, though it is subject to a limit of 1,000 tool calls per day per IP address and a rate limit of 5 requests per second.
This tool is strictly read-only, meaning it cannot execute trades or access any user accounts. It aggregates data from various sources like Polymarket, Kalshi, Deribit, and Bybit to provide comprehensive market insights through specific tools like odds_markets, odds_fair, and odds_cluster.
What you can do with it
- 1Identify profitable market edgesAsk the AI to find HIP-4 markets that offer the highest potential profit after accounting for all settlement fees.
- 2Compare market rules across deployersCheck if different market deployers have matching rules for the same question to avoid discrepancies.
- 3Verify fair line sourcesInvestigate the origin and confidence levels of the fair line for specific cryptocurrency markets.
- 4Monitor recent market listingsRetrieve a list of the most recently created markets to stay updated on new opportunities.
Written from the project's README. Every use case is checked against a quote from it.
Hyperodds MCP tools 4
Detected from the READMEodds_marketsodds_clusterodds_fairodds_new
| odds_markets | — | |
| odds_cluster | — | |
| odds_fair | — | |
| odds_new | — |
Configuration
HYPERODDS_MCP_URL
| Name | Description | |
|---|---|---|
| HYPERODDS_MCP_URL | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableusehyperodds/hyperodds-mcp is public and reachablegithub.com/usehyperodds/hyperodds-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-07github.com/usehyperodds/hyperodds-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubGive 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.
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.
Hyperodds MCP questions
What tools does Hyperodds MCP provide?
It exposes 4 tools, including odds_markets, odds_cluster, odds_fair, odds_new.
Does this server allow trading?
No, the tools are read-only and cannot trade or access an account.
Do I need an API key to use Hyperodds?
No, the service is free and requires no key setup.
What are the usage limits?
Each IP address is limited to 1,000 tool calls per day and a rate limit of 5 requests per second, with bursts up to 30.
What Node.js version is required?
The package requires Node.js version 22 or later.