footballstack-mcp

MCP-сервер для футбольного API FootballStack. Предоставляет 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 соревнований. Глубина неоднородна, и каталог шире, чем глубокое покрытие.

• Наиболее глубокое: Бундеслига, 2-я Бундеслига, Кубок DFB, Суперлига Румынии

• Расширенная Европа: Эредивизи, Примейра-Лига, Суперлига, Про-лига, шотландский Премьершип

• Исторические / только аналитика: Премьер-лига, Ла Лига, Серия А, Лига 1 (xG получен из Understat)

Вызовите footballstack_competitions и проверьте свою лигу, прежде чем строить на ней что-либо.

Поведение квоты

• Бесплатно: 1 000 запросов в месяц, 10 запросов/мин. Developer $9/мес: 10 000 запросов в месяц, 60 запросов/мин, включает xG, карты ударов, составы, события в реальном времени и справедливые коэффициенты. Pro $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.