Hyperodds MCP server
Commit 7. Nov. 2026Liefert Live-Hyperliquid HIP-4 Marktdaten, einschließlich Orderbooks, Fair Lines und Regelvergleichen, an MCP-Clients.
Auch bekannt als usehyperodds/hyperodds-mcp
- Stars
- 0
- Tools
- 4
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 7. Nov. 2026
- Lizenz
- MIT
Was ist Hyperodds MCP?
Liefert Live-Hyperliquid HIP-4 Marktdaten, einschließlich Orderbooks, Fair Lines und Regelvergleichen, an MCP-Clients. Er stellt 4 Tools bereit, etwa odds_markets, odds_cluster, odds_fair.
Zusammenfassung generiert aus dem README des Projekts
Über Hyperodds MCP server
Dieser Server ermöglicht es dir, live Hyperliquid HIP-4 Marktdaten direkt aus deiner AI-Coding-Umgebung abzurufen. Er liefert Echtzeit-Informationen zu Outcome-Märkten, einschließlich Orderbooks, Fair Lines und Regelvergleichen über verschiedene Deployer hinweg. Entwickler, die Claude Desktop, Cursor, VS Code oder Windsurf nutzen, können diese Daten integrieren, um Marktvorteile und Liquidität direkt über ihren bevorzugten MCP-Client zu analysieren.
Das Setup nutzt eine Bridge, die lokal auf deinem Rechner via stdio läuft und die Requests an einen gehosteten Server weiterleitet. Es wird Node.js 22 oder neuer benötigt und kann via npx installiert werden. Der Service ist kostenlos und benötigt keinen API-Key, unterliegt jedoch einem Limit von 1.000 Tool-Calls pro Tag pro IP-Adresse sowie einem Rate Limit von 5 Requests pro Sekunde.
Dieses Tool ist strikt read-only, was bedeutet, dass es keine Trades ausführen oder auf Benutzerkonten zugreifen kann. Es aggregiert Daten aus verschiedenen Quellen wie Polymarket, Kalshi, Deribit und Bybit, um umfassende Markteinblicke durch spezifische Tools wie odds_markets, odds_fair und odds_cluster zu liefern.
Was du damit machen kannst
- 1Profitable Marktvorteile identifizierenFrage die AI, um HIP-4 Märkte zu finden, die nach Berücksichtigung aller Settlement-Gebühren das höchste Gewinnpotenzial bieten.
- 2Marktregeln über Deployer hinweg vergleichenPrüfe, ob verschiedene Markt-Deployer für dieselbe Frage identische Regeln haben, um Diskrepanzen zu vermeiden.
- 3Fair-Line-Quellen verifizierenUntersuche den Ursprung und das Konfidenzniveau der Fair Line für spezifische Kryptowährungs-Märkte.
- 4Aktuelle Markteintritte überwachenRufe eine Liste der zuletzt erstellten Märkte ab, um über neue Chancen auf dem Laufenden zu bleiben.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Hyperodds MCP tools 4
Erkannt aus dem READMEodds_marketsodds_clusterodds_fairodds_new
| odds_markets | — | |
| odds_cluster | — | |
| odds_fair | — | |
| odds_new | — |
Konfiguration
HYPERODDS_MCP_URL
| Name | Beschreibung | Typ |
|---|---|---|
| HYPERODDS_MCP_URL | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarusehyperodds/hyperodds-mcp is public and reachablegithub.com/usehyperodds/hyperodds-mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-07github.com/usehyperodds/hyperodds-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenGive 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 Fragen
Welche Tools bietet Hyperodds MCP?
Er stellt 4 Tools bereit, darunter odds_markets, odds_cluster, odds_fair, odds_new.
Ermöglicht dieser Server Trading?
Nein, die Tools sind read-only und können keine Trades ausführen oder auf ein Konto zugreifen.
Benötige ich einen API-Key, um Hyperodds zu nutzen?
Nein, der Service ist kostenlos und erfordert keine Key-Konfiguration.
Wie hoch sind die Nutzungslimits?
Jede IP-Adresse ist auf 1.000 Tool-Calls pro Tag und ein Rate Limit von 5 Requests pro Sekunde begrenzt, mit Bursts von bis zu 30.
Welche Node.js Version wird benötigt?
Das Package erfordert Node.js Version 22 oder neuer.