MCP server de Hyperodds
Commit 7 nov 2026Proporciona datos de mercado de Hyperliquid HIP-4 en vivo, incluyendo libros de órdenes, fair lines y comparaciones de reglas, a clientes MCP.
También conocido como usehyperodds/hyperodds-mcp
- Stars
- 0
- Herramientas
- 4
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 7 nov 2026
- Licencia
- MIT
¿Qué es Hyperodds MCP?
Proporciona datos de mercado de Hyperliquid HIP-4 en vivo, incluyendo libros de órdenes, fair lines y comparaciones de reglas, a clientes MCP. Expone 4 herramientas, como odds_markets, odds_cluster, odds_fair.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Hyperodds
Este servidor permite acceder a datos de mercado de Hyperliquid HIP-4 en vivo directamente desde tu entorno de desarrollo de IA. Proporciona información en tiempo real sobre mercados de resultados, incluyendo libros de órdenes, fair lines y comparaciones de reglas entre diferentes deployers. Los desarrolladores que utilicen Claude Desktop, Cursor, VS Code o Windsurf pueden integrar estos datos para analizar ventajas de mercado y liquidez directamente a través de su cliente MCP preferido.
La configuración utiliza un puente que se ejecuta en tu máquina local mediante stdio, el cual redirige las solicitudes a un servidor alojado. Requiere Node.js 22 o posterior y se puede instalar usando npx. El servicio es gratuito y no requiere una API key, aunque está sujeto a un límite de 1,000 llamadas a herramientas por día por dirección IP y un límite de velocidad de 5 solicitudes por segundo.
Esta herramienta es estrictamente de solo lectura, lo que significa que no puede ejecutar operaciones ni acceder a cuentas de usuario. Agrega datos de diversas fuentes como Polymarket, Kalshi, Deribit y Bybit para ofrecer una visión integral del mercado mediante herramientas específicas como odds_markets, odds_fair y odds_cluster.
Qué puedes hacer con él
- 1Identificar ventajas de mercado rentablesPide a la IA que encuentre mercados HIP-4 que ofrezcan el mayor potencial de beneficio tras contabilizar todas las comisiones de liquidación.
- 2Comparar reglas de mercado entre deployersComprueba si diferentes deployers de mercado tienen reglas coincidentes para la misma pregunta para evitar discrepancias.
- 3Verificar fuentes de fair lineInvestiga el origen y los niveles de confianza de la fair line para mercados de criptomonedas específicos.
- 4Monitorear listados de mercado recientesObtén una lista de los mercados creados más recientemente para mantenerte al tanto de nuevas oportunidades.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de Hyperodds MCP 4
Detectado desde el READMEodds_marketsodds_clusterodds_fairodds_new
| odds_markets | — | |
| odds_cluster | — | |
| odds_fair | — | |
| odds_new | — |
Configuración
HYPERODDS_MCP_URL
| Nombre | Descripción | Tipo |
|---|---|---|
| HYPERODDS_MCP_URL | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleusehyperodds/hyperodds-mcp is public and reachablegithub.com/usehyperodds/hyperodds-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-07github.com/usehyperodds/hyperodds-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre Hyperodds MCP
¿Qué herramientas proporciona Hyperodds MCP?
Expone 4 herramientas, incluidas odds_markets, odds_cluster, odds_fair, odds_new.
¿Este servidor permite realizar trading?
No, las herramientas son de solo lectura y no pueden realizar operaciones ni acceder a ninguna cuenta.
¿Necesito una API key para usar Hyperodds?
No, el servicio es gratuito y no requiere configuración de llaves.
¿Cuáles son los límites de uso?
Cada dirección IP está limitada a 1,000 llamadas a herramientas por día y un límite de velocidad de 5 solicitudes por segundo, con ráfagas de hasta 30.
¿Qué versión de Node.js es necesaria?
El paquete requiere la versión 22 de Node.js o posterior.