공식 MCP 서버Odds API MCP 서버
AI 어시스턴트를 위한

Claude, Codex, Cursor, VS Code를 450개 이상 북메이커의 실시간 배당률과 과거 배당률에 연결하세요. 가격, 라인 변동, 밸류 베팅, 베팅 결과를 평소 말투로 물어보거나, 어시스턴트에게 코드를 맡기세요.

설정하기 API 키 받기

무료 오픈 소스 · 도구 33개 · npm, Docker, Claude Desktop 원클릭 설치

설정

1분 안에 연결 완료

API 키 받기
플랜과 북메이커를 고르세요. 결제가 완료되는 즉시 대시보드에 키가 표시됩니다.
AI 도구에 서버 추가하기
명령어 하나 또는 JSON 블록 하나를 붙여 넣으세요. 서버는 npx나 Docker로 내 컴퓨터에서 실행되며, 키는 환경 변수에서 읽습니다.
평소 말투로 질문하기
어시스턴트가 알맞은 도구를 골라 API를 호출하고 실시간 가격으로 답합니다. 같은 데이터로 코드를 작성하고 테스트할 수도 있습니다.

터미널에서 실행

claude mcp add odds-api \
  --env ODDS_API_KEY="your-api-key" \
  -- npx -y odds-api-mcp-server

터미널에서 실행

codex mcp add odds-api \
  --env ODDS_API_KEY="your-api-key" \
  -- npx -y odds-api-mcp-server

claude_desktop_config.json에 추가

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": [
        "-y",
        "odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

.cursor/mcp.json에 추가

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": [
        "-y",
        "odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

.vscode/mcp.json에 추가

{
  "servers": {
    "odds-api": {
      "command": "npx",
      "args": [
        "-y",
        "odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

모든 MCP 클라이언트 지원, Node.js 불필요

{
  "mcpServers": {
    "odds-api": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ODDS_API_KEY",
        "oddsapi/odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop을 쓰시나요? 최신 릴리스에서 .mcpb 파일을 내려받아 여세요. Claude가 키를 묻고 나머지는 알아서 처리합니다.

예시

이런 걸 물어볼 수 있습니다

실시간 데이터로 답하는 실제 질문입니다. 각 질문 아래에 어시스턴트가 답할 때 호출하는 도구가 표시됩니다.

이번 주말 Premier League 경기 중 승무패 배당에서 Bet365와 Unibet의 차이가 가장 큰 경기는?
get_eventsget_multi_odds
Arsenal 대 Chelsea 경기의 Over 2.5골 배당이 어제부터 Bet365에서 어떻게 움직였어?
search_eventsget_odds_movements
오늘 밤 가장 빠르게 떨어지고 있는 NBA 배당은?
get_dropping_odds
지금 Betano의 밸류 베팅을 기대값 순으로 정렬해서 보여 줘.
get_value_bets
어제 Liverpool의 Premier League 경기에서 아시안 핸디캡 -1과 Over 2.5골에 걸었어. 베팅이 적중했어?
get_historical_eventsgrade_bets
내 북메이커들 사이에서 2%가 넘는 아비트라지가 나오면 Telegram으로 메시지를 보내는 Python 스크립트를 작성해 줘.
get_documentationget_arbitrage_bets

도구

도구 33개로 API 전체를

도구가 v3 API 전체를 다루기 때문에, 어시스턴트가 채팅에서 찾은 내용은 코드에서도 똑같이 동작합니다.

배당률

get_odds: 경기 하나의 모든 마켓을 최대 30개 북메이커에서
get_multi_odds: 최대 10개 경기의 배당을 한 번의 호출로
get_updated_odds: 특정 타임스탬프 이후 바뀐 배당만
get_odds_summary: 북메이커 전체에서 라인별 최고·평균·최저·공정 가격
get_odds_movements: 북메이커 한 곳에서 라인 하나의 가격 기록
get_dropping_odds: 오픈 이후 가장 많이 떨어진 라인을 종목·리그별로

경기

get_events: 종목, 리그, 팀, 날짜, 상태별 경기 일정
get_event: ID로 경기 하나 조회
get_live_events: 지금 진행 중인 모든 경기
search_events: 팀 이름으로 경기 찾기

베팅 도구

get_value_bets: 북메이커의 기대값이 플러스인 가격
get_arbitrage_bets: 내 북메이커 간 아비트라지 기회

기록과 정산

get_historical_events: 종목, 리그, 날짜별 종료된 경기
search_historical_events: 팀 이름으로 종료된 경기 찾기
get_historical_odds: 종료된 경기의 마감 배당과 최종 스코어
get_closing_lines: 최대 10개 리그의 마감 배당을 한 번에
get_settlements: 최대 50개 경기의 상태와 피리어드별 최종 스코어
grade_bets: 최대 50건의 베팅을 적중, 미적중, 무효, 절반으로 정산

골프 아웃라이트

list_outrights: 투어별 대회와 각 대회에 가격을 내는 북메이커 수
get_outright_odds: 대회 우승, Top 5/10/20, 컷 통과 배당
get_outright_results: 최종 순위와 각 마켓의 적중 결과

참조 데이터

get_sports: 모든 종목과 슬러그
get_leagues: 종목별 리그와 경기 수
get_markets: 종목별 정확한 마켓 이름, 프리매치와 라이브
get_bookmakers: 모든 북메이커와 활성 여부
get_participants: 종목별 팀과 선수
get_participant: ID로 팀 또는 선수 하나 조회
get_mappings: 우리 경기와 선택지에 대응하는 북메이커 자체 ID

내 계정과 문서

get_selected_bookmakers: 내 플랜의 북메이커
select_bookmakers: 선택 목록에 북메이커 추가
clear_selected_bookmakers: 선택 목록 초기화, 12시간에 한 번
get_usage: 시간당 한도, 남은 요청 수, 초기화 시각
get_documentation: 처음부터 동작하는 코드를 위한 전체 API 문서

작동 방식

내 컴퓨터에서 실행되고, 실시간 API를 읽습니다

키는 내 컴퓨터에만

서버는 stdio로 로컬에서 실행되며 api.odds-api.io와 직접 통신합니다. 중간에 거치는 곳이 없고, 키는 MCP 설정 안에 있습니다.

API와 같은 데이터

450개 이상의 북메이커, 34개 종목, 프리매치와 라이브를 하나의 JSON 스키마로. 어시스턴트가 보는 데이터가 곧 코드가 받는 데이터입니다.

어시스턴트가 읽을 수 있는 문서

서버는 전체 문서와 OpenAPI 명세를 MCP 리소스로 제공합니다. 코드를 요청하면 어시스턴트가 실제 필드 이름부터 확인합니다.

모든 플랜에 포함

MCP 서버는 무료 오픈 소스입니다. 도구 호출은 일반 API 요청이며 시간당 5,000회 요청 한도에 포함됩니다.

자주 묻는 질문

MCP 서버에 관한 질문

Odds API MCP 서버란 무엇인가요?

Odds-API.io의 공식 Model Context Protocol 서버입니다. Claude, Codex, Cursor 같은 AI 어시스턴트에 33개의 도구를 제공해 450개 이상 북메이커의 실시간·과거 배당률, 경기, 밸류 베팅, 아비트라지, 베팅 결과를 읽을 수 있게 합니다.

어떤 AI 도구에서 쓸 수 있나요?

stdio 방식의 MCP를 지원하는 모든 클라이언트에서 쓸 수 있습니다. Claude Code, Claude Desktop, Codex, Cursor, GitHub Copilot을 쓰는 VS Code, Windsurf, Zed가 포함됩니다. Claude Desktop에는 원클릭 설치 파일도 있습니다.

유료 플랜이 필요한가요?

네. 서버에는 API 키가 필요하고, 키는 모든 유료 플랜에 포함됩니다. 가장 저렴한 플랜은 Solo(월 £49, 북메이커 2곳)입니다. MCP 서버 자체에는 추가 비용이 없습니다.

어시스턴트는 어떤 북메이커를 볼 수 있나요?

플랜에서 선택한 북메이커입니다. 어시스턴트에게 get_selected_bookmakers를 실행해 달라고 하면 확인할 수 있습니다. 종목, 리그, 경기 같은 참조 데이터는 모든 북메이커에 대해 제공됩니다.

실시간 배당률에도 쓸 수 있나요?

네. get_live_events는 진행 중인 경기를 보여 주고 get_odds는 현재 가격을 반환합니다. 내 앱에서 스트리밍으로 받으려면 WebSocket API를 쓰세요. 그 코드도 어시스턴트가 작성해 줄 수 있습니다.

API 키는 안전한가요?

서버는 내 컴퓨터에서 실행되며 키를 api.odds-api.io에만 보냅니다. 호스팅된 프록시는 없습니다. 코드는 MIT 라이선스로 GitHub에 공개되어 있습니다.

어시스턴트가 베팅을 할 수 있나요?

아니요. 서버는 데이터를 읽기만 합니다. 북메이커에 로그인하거나 베팅을 할 수 없습니다.

llms.txt 문서와는 무엇이 다른가요?

llms.txt는 어시스턴트가 코드를 작성할 수 있도록 문서를 제공합니다. MCP 서버는 대화하는 동안 어시스턴트가 API를 호출해 실시간 데이터로 작업할 수 있게 해 줍니다. 대부분 둘 다 사용합니다.

어시스턴트에 실시간 배당률을

모든 플랜에 MCP 서버, 시간당 5,000회 요청, 모든 종목과 마켓이 포함됩니다. 월간 또는 연간으로 결제하고, 언제든 해지할 수 있습니다.

플랜 보기 AI 설정 가이드 Claude 튜토리얼