Serveur MCP Hyperodds
Commit 7 nov. 2026Fournit des données de marché Hyperliquid HIP-4 en direct, incluant les carnets d'ordres, les fair lines et les comparaisons de règles, aux clients MCP.
Aussi connu sous usehyperodds/hyperodds-mcp
- Étoiles
- 0
- Outils
- 4
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 7 nov. 2026
- Licence
- MIT
Qu'est-ce que Hyperodds MCP ?
Fournit des données de marché Hyperliquid HIP-4 en direct, incluant les carnets d'ordres, les fair lines et les comparaisons de règles, aux clients MCP. Il expose 4 outils, comme odds_markets, odds_cluster, odds_fair.
Résumé généré à partir du README du projet
À propos du MCP server Hyperodds
Ce serveur permet d'accéder aux données de marché Hyperliquid HIP-4 en direct directement depuis votre environnement de codage IA. Il fournit des informations en temps réel sur les marchés de résultats, notamment les carnets d'ordres, les fair lines et les comparaisons de règles entre différents deployers. Les développeurs utilisant Claude Desktop, Cursor, VS Code ou Windsurf peuvent intégrer ces données pour analyser les opportunités de marché et la liquidité directement via leur client MCP préféré.
La configuration utilise un bridge s'exécutant sur votre machine locale via stdio qui transmet les requêtes à un serveur hébergé. Il nécessite Node.js 22 ou une version ultérieure et peut être installé via npx. Le service est gratuit et ne nécessite pas de clé API, bien qu'il soit soumis à une limite de 1 000 appels d'outils par jour par adresse IP et à une limite de débit de 5 requêtes par seconde.
Cet outil est strictement en lecture seule, ce qui signifie qu'il ne peut pas exécuter de transactions ni accéder à des comptes utilisateurs. Il agrège des données provenant de diverses sources telles que Polymarket, Kalshi, Deribit et Bybit pour fournir des analyses de marché complètes via des outils spécifiques comme odds_markets, odds_fair et odds_cluster.
Ce que vous pouvez faire avec
- 1Identifier des opportunités de marché rentablesDemandez à l'IA de trouver les marchés HIP-4 offrant le potentiel de profit le plus élevé après prise en compte de tous les frais de règlement.
- 2Comparer les règles de marché entre les deployersVérifiez si différents deployers de marché appliquent des règles identiques pour une même question afin d'éviter les écarts.
- 3Vérifier les sources des fair linesÉtudiez l'origine et les niveaux de confiance de la fair line pour des marchés de cryptomonnaies spécifiques.
- 4Surveiller les nouveaux listings de marchéRécupérez la liste des marchés créés le plus récemment pour rester informé des nouvelles opportunités.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Outils MCP Hyperodds 4
Détectés depuis le READMEodds_marketsodds_clusterodds_fairodds_new
| odds_markets | — | |
| odds_cluster | — | |
| odds_fair | — | |
| odds_new | — |
Configuration
HYPERODDS_MCP_URL
| Nom | Description | Type |
|---|---|---|
| HYPERODDS_MCP_URL | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleusehyperodds/hyperodds-mcp is public and reachablegithub.com/usehyperodds/hyperodds-mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-07github.com/usehyperodds/hyperodds-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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.
Questions sur Hyperodds MCP
Quels outils Hyperodds MCP fournit-il ?
Il expose 4 outils, dont odds_markets, odds_cluster, odds_fair, odds_new.
Ce serveur permet-il de trader ?
Non, les outils sont en lecture seule et ne permettent pas de trader ni d'accéder à un compte.
Ai-je besoin d'une clé API pour utiliser Hyperodds ?
Non, le service est gratuit et ne nécessite aucune configuration de clé.
Quelles sont les limites d'utilisation ?
Chaque adresse IP est limitée à 1 000 appels d'outils par jour avec une limite de débit de 5 requêtes par seconde, avec des pics allant jusqu'à 30.
Quelle version de Node.js est requise ?
Le package nécessite Node.js version 22 ou ultérieure.