footballstack-mcp

FootballStack 축구 데이터 API용 MCP 서버. LLM 클라이언트에 실제 축구 데이터(일정, 순위, 라인업, 라이브 이벤트, 피치 좌표가 포함된 슛 단위 xG, 모델 기반 공정 확률)를 제공하여, 환각으로 만든 스코어라인 대신 실제 데이터를 제공합니다.

도구 12개, 프롬프트 1개. Node ≥ 20, 빌드 단계 없음.

설치

npx footballstack-mcp

환경 변수에 API 키를 설정하세요. 무료 티어: 월 1,000건 요청. 키는 footballstackapi.com/sign-in에서 받으세요.

Claude Desktop / Claude Code

{
  "mcpServers": {
    "footballstack": {
      "command": "npx",
      "args": ["-y", "footballstack-mcp"],
      "env": { "FOOTBALLSTACK_API_KEY": "fs_live_..." }
    }
  }
}

Cursor / Windsurf / 모든 stdio MCP 클라이언트

동일한 블록을 해당 클라이언트의 MCP 구성 파일에 넣으세요.

Related MCP server: worldcup-ai-forecaster

도구

프롬프트: scout_team_form — 팀을 확인하고, 최근 5경기를 가져와 결과 뒤의 xG를 읽습니다.

footballstack_search부터 시작하여 ID를 확인하세요. ID를 추측하면 할당량이 낭비됩니다: 404 및 빈 결과도 다른 요청과 마찬가지로 계량됩니다.

적용 범위, 정직하게 명시

카탈로그에는 75개 대회가 나열되어 있습니다. 깊이는 균일하지 않으며, 카탈로그는 깊은 적용 범위보다 넓습니다.

• 가장 깊은: Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României

• 확장 유럽: Eredivisie, Primeira Liga, Süper Lig, Pro League, Scottish Premiership

• 역사/분석 전용: Premier League, La Liga, Serie A, Ligue 1 (xG는 Understat에서 파생)

footballstack_competitions를 호출하여 구축 전에 리그를 확인하세요.

할당량 동작

• 무료: 월 1,000건, 분당 10건. 개발자 $9/월: 월 10,000건, 분당 60건, xG, 슛 맵, 라인업, 라이브 이벤트 및 공정 확률 포함. 프로 $29/월: 월 50,000건, 분당 180건.

• 초과 사용 요금 없음. 할당량이 소진되면 API는 429를 반환합니다. 이 서버는 빈 결과 대신 quota_or_rate_limit 오류로 표시합니다.

• 할당량은 매월 1일 UTC로 초기화됩니다.

• 모든 요청은 404 및 빈 결과를 포함하여 계량됩니다.

이 도구가 적합하지 않은 경우

• 여러 대회에 걸친 고빈도 라이브 폴링. 월 할당량은 이에 적합하지 않습니다 — 다른 곳의 일일 또는 초당 요금제가 더 저렴할 수 있습니다.

• 위의 깊은 적용 범위 목록에 없는 리그.

• 계약상 SLA, 가동 시간 크레딧 또는 지정 지원 담당자가 필요한 경우. 이 가격으로는 제공되지 않습니다.

개발

npm install
npm run smoke   # boots the server over stdio, lists tools, calls health

npm run smoke는 API 키 없이 작동합니다: footballstack_health는 실시간 상태를 반환하고, 키가 필요한 도구는 읽기 쉬운 missing_api_key 오류를 반환하여 "구성되지 않음"과 "오류"를 구분할 수 있습니다.

MIT.