Hyperodds MCP server
2026년 11월 7일 커밋오더북, 페어 라인, 규칙 비교를 포함한 실시간 Hyperliquid HIP-4 시장 데이터를 MCP 클라이언트에 제공합니다.
다른 이름 usehyperodds/hyperodds-mcp
- 스타
- 0
- Tools
- 4
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 7일
- 라이선스
- MIT
Hyperodds MCP란?
오더북, 페어 라인, 규칙 비교를 포함한 실시간 Hyperliquid HIP-4 시장 데이터를 MCP 클라이언트에 제공합니다. 4개 도구를 제공합니다. 예: odds_markets, odds_cluster, odds_fair.
프로젝트 README에서 생성된 요약
Hyperodds MCP server 정보
이 서버를 사용하면 AI 코딩 환경 내에서 실시간 Hyperliquid HIP-4 시장 데이터에 접근할 수 있습니다. 오더북, 페어 라인, 그리고 서로 다른 디플로이어 간의 규칙 비교를 포함하여 결과 시장에 대한 실시간 정보를 제공합니다. Claude Desktop, Cursor, VS Code 또는 Windsurf를 사용하는 개발자는 선호하는 MCP 클라이언트를 통해 이 데이터를 통합하여 시장의 우위와 유동성을 직접 분석할 수 있습니다.
설정 방식은 로컬 머신에서 stdio를 통해 실행되는 브릿지가 요청을 호스팅 서버로 전달하는 구조입니다. Node.js 22 이상이 필요하며 npx를 사용하여 설치할 수 있습니다. 서비스는 무료로 제공되며 API 키가 필요하지 않지만, IP 주소당 하루 1,000회의 도구 호출 및 초당 5회의 요청 제한이 적용됩니다.
이 도구는 엄격하게 읽기 전용으로 작동하며, 거래를 실행하거나 사용자 계정에 접근할 수 없습니다. odds_markets, odds_fair, odds_cluster와 같은 특정 도구를 통해 Polymarket, Kalshi, Deribit, Bybit 등 다양한 소스의 데이터를 집계하여 포괄적인 시장 통찰력을 제공합니다.
활용 사례
- 1수익성 있는 시장 우위 식별모든 결제 수수료를 고려한 후 가장 높은 잠재적 수익을 제공하는 HIP-4 시장을 AI에게 찾아달라고 요청합니다.
- 2디플로이어별 시장 규칙 비교불일치를 방지하기 위해 서로 다른 시장 디플로이어가 동일한 질문에 대해 일치하는 규칙을 가지고 있는지 확인합니다.
- 3페어 라인 소스 검증특정 암호화폐 시장의 페어 라인 출처와 신뢰 수준을 조사합니다.
- 4최근 시장 상장 모니터링최근에 생성된 시장 목록을 가져와 새로운 기회에 대한 최신 정보를 유지합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Hyperodds MCP 도구 4
README에서 감지됨odds_marketsodds_clusterodds_fairodds_new
| odds_markets | — | |
| odds_cluster | — | |
| odds_fair | — | |
| odds_new | — |
구성
HYPERODDS_MCP_URL
| 이름 | 설명 | 유형 |
|---|---|---|
| HYPERODDS_MCP_URL | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능usehyperodds/hyperodds-mcp is public and reachablegithub.com/usehyperodds/hyperodds-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-07github.com/usehyperodds/hyperodds-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음4 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Give 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 질문
Hyperodds MCP는 어떤 도구를 제공하나요?
4개 도구를 제공합니다. 예: odds_markets, odds_cluster, odds_fair, odds_new.
이 서버로 거래가 가능한가요?
아니요, 도구는 읽기 전용이며 거래를 수행하거나 계정에 접근할 수 없습니다.
Hyperodds를 사용하려면 API 키가 필요한가요?
아니요, 이 서비스는 무료이며 별도의 키 설정이 필요하지 않습니다.
사용량 제한은 어떻게 되나요?
IP 주소당 하루 1,000회의 도구 호출로 제한되며, 초당 5회의 요청 제한이 적용됩니다. 일시적으로 최대 30회까지 요청이 가능합니다.
필요한 Node.js 버전은 무엇인가요?
이 패키지는 Node.js 버전 22 이상이 필요합니다.