Hyperodds MCP server
Commit 7 Nov 2026Menyediakan data pasar Hyperliquid HIP-4 secara live, termasuk order books, fair lines, dan perbandingan aturan, kepada klien MCP.
Juga dikenal sebagai usehyperodds/hyperodds-mcp
- Stars
- 0
- Tools
- 4
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 7 Nov 2026
- Lisensi
- MIT
Apa itu Hyperodds MCP?
Menyediakan data pasar Hyperliquid HIP-4 secara live, termasuk order books, fair lines, dan perbandingan aturan, kepada klien MCP. Server ini menyediakan 4 tool, seperti odds_markets, odds_cluster, odds_fair.
Ringkasan dibuat dari README proyek
Tentang Hyperodds MCP server
Server ini memungkinkan Anda mengakses data pasar Hyperliquid HIP-4 secara live langsung dari lingkungan coding AI Anda. Server ini menyediakan informasi real-time mengenai outcome markets, termasuk order books, fair lines, dan perbandingan aturan di berbagai deployer yang berbeda. Developer yang menggunakan Claude Desktop, Cursor, VS Code, atau Windsurf dapat mengintegrasikan data ini untuk menganalisis market edges dan likuiditas secara langsung melalui MCP client pilihan Anda.
Setup ini menggunakan bridge yang berjalan di mesin lokal Anda via stdio yang meneruskan request ke server yang di-host. Anda memerlukan Node.js 22 atau versi yang lebih baru dan dapat menginstalnya menggunakan npx. Layanan ini gratis digunakan dan tidak memerlukan API key, meskipun tunduk pada batasan 1.000 tool calls per hari per alamat IP dan rate limit 5 request per detik.
Tool ini bersifat strictly read-only, yang berarti tidak dapat mengeksekusi trade atau mengakses akun pengguna mana pun. Tool ini mengagregasi data dari berbagai sumber seperti Polymarket, Kalshi, Deribit, dan Bybit untuk memberikan wawasan pasar yang komprehensif melalui tool spesifik seperti odds_markets, odds_fair, dan odds_cluster.
Apa yang bisa Anda lakukan dengannya
- 1Identifikasi market edges yang menguntungkanMinta AI untuk menemukan pasar HIP-4 yang menawarkan potensi profit tertinggi setelah memperhitungkan semua biaya settlement.
- 2Bandingkan aturan pasar antar deployerPeriksa apakah deployer pasar yang berbeda memiliki aturan yang sama untuk pertanyaan yang sama guna menghindari diskrepansi.
- 3Verifikasi sumber fair lineInvestigasi asal-usul dan tingkat kepercayaan dari fair line untuk pasar cryptocurrency tertentu.
- 4Pantau listing pasar terbaruDapatkan daftar pasar yang paling baru dibuat agar tetap update dengan peluang-peluang baru.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool Hyperodds MCP 4
Terdeteksi dari READMEodds_marketsodds_clusterodds_fairodds_new
| odds_markets | — | |
| odds_cluster | — | |
| odds_fair | — | |
| odds_new | — |
Konfigurasi
HYPERODDS_MCP_URL
| Nama | Deskripsi | Tipe |
|---|---|---|
| HYPERODDS_MCP_URL | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauusehyperodds/hyperodds-mcp is public and reachablegithub.com/usehyperodds/hyperodds-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-07github.com/usehyperodds/hyperodds-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang Hyperodds MCP
Tool apa yang disediakan Hyperodds MCP?
Server ini menyediakan 4 tool, termasuk odds_markets, odds_cluster, odds_fair, odds_new.
Apakah server ini memungkinkan untuk trading?
Tidak, tool yang tersedia bersifat read-only dan tidak dapat melakukan trading atau mengakses akun.
Apakah saya memerlukan API key untuk menggunakan Hyperodds?
Tidak, layanan ini gratis dan tidak memerlukan pengaturan key.
Apa saja batasan penggunaannya?
Setiap alamat IP dibatasi 1.000 tool calls per hari dengan rate limit 5 request per detik, dengan burst hingga 30 request.
Versi Node.js apa yang dibutuhkan?
Package ini memerlukan Node.js versi 22 atau yang lebih baru.