SportAPI
Интеграция API

Спортивные данные прямо в Claude, Cursor и VS Code: live-матчи и коэффициенты через MCP

Как подключить live-матчи, счёт, статистику и коэффициенты к Claude, Cursor и VS Code через MCP-сервер SportAPI: установка одной командой, демо-режим без ключа и что спрашивать у ассистента.

Окно ИИ-ассистента, который отвечает на вопрос о live-матчах с помощью инструментов SportAPI

Спросите обычного ИИ-ассистента, какие матчи сейчас идут в live, и он либо признается, что не знает, либо уверенно назовёт счёт недельной давности. У языковой модели нет доступа к живым данным. Поиск по сайтам помогает плохо: страницы со счётом устаревают за минуту, а коэффициенты на них не разобрать.

Решение — MCP (Model Context Protocol, открытый стандарт подключения внешних инструментов к ИИ-ассистентам). У SportAPI есть свой MCP-сервер sportapi-mcp: бесплатный, с открытым кодом под лицензией MIT. Он даёт Claude, Cursor, VS Code и другим клиентам 11 инструментов для live- и prematch-матчей, счёта, live-статистики и коэффициентов. Без ключа сервер работает на демо-данных, а с ключом API спортивной линии SportAPI (от $30 в месяц за вид спорта) отвечает по текущим матчам. Устанавливается одной командой:

claude mcp add sportapi -- uvx sportapi-mcp

Что можно спросить у ассистента

Ассистент сам выбирает нужный инструмент и сам собирает ответ. Несколько примеров на демо-данных из документации:

ВопросЧто вызывает ассистентЧто получает
«Какие футбольные матчи сейчас идут и кто фаворит?»list_live_matches(sport_id=1)Live-матчи со счётом, минутой и основными коэффициентами
«Арсенал — Ковентри: как оцениваются тоталы?»get_match(..., markets=["Total"])Счёт, xG, удары и линия тоталов этого матча
«Когда следующий матч Манчестер Сити и какие коэффициенты?»search_matches(text="Manchester"), затем get_matchДата, турнир, исходы 1X2 и тоталы
«Какие главные матчи на выходных?»top_matches(line_type="prematch")До 10 самых популярных матчей
«Мой ключ SportAPI в порядке?»account_status()Срок действия, виды спорта, языки, число запросов за 7 дней

Ответ на второй вопрос в демо-режиме выглядит примерно так: «Арсенал ведёт 3:0 на 56-й минуте, xG 1,45 против 0,03. Больше 3,5 гола — 1,23, больше 4,5 — 2,09. Рынок ждёт четвёртый гол, но не пятый». Ассистент не придумывает цифры, а берёт их из ответа API.

В сервере есть и два готовых сценария (prompts): обзор live-ставок по виду спорта и сравнение рынков одного матча — с вероятностями, которые следуют из коэффициентов, маржой и справедливыми коэффициентами без маржи.

Как подключить MCP-сервер SportAPI

Сервер — это пакет Python (нужен Python 3.10+). Проще всего запускать его через uvx из инструмента uv: он сам скачивает пакет и запускает его в отдельном окружении. Ниже настройки для популярных клиентов. Блок env можно не указывать — тогда сервер запустится в демо-режиме.

Claude Desktop

Самый простой путь — файл sportapi-mcp.mcpb из последнего релиза на GitHub. Откройте его, и Claude Desktop установит расширение и спросит ключ (поле можно оставить пустым для демо). Второй вариант — добавить сервер вручную в claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "sportapi": {
      "command": "uvx",
      "args": ["sportapi-mcp"],
      "env": {
        "SPORTAPI_KEY": "YOUR_API_KEY",
        "SPORTAPI_BASE_URL": "https://YOUR_API_DOMAIN"
      }
    }
  }
}

Claude Code

Для демо хватит команды из начала статьи. С ключом и для всех ваших проектов:

claude mcp add sportapi --scope user -e SPORTAPI_KEY=YOUR_API_KEY -e SPORTAPI_BASE_URL=https://YOUR_API_DOMAIN -- uvx sportapi-mcp

Cursor

Тот же блок mcpServers, что и для Claude Desktop, в файле ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного проекта).

VS Code

В VS Code ключ лучше не писать в файл, а попросить редактор спросить его один раз и сохранить в защищённом хранилище. Файл .vscode/mcp.json:

{
  "inputs": [
    { "type": "promptString", "id": "sportapi-key", "description": "SportAPI key", "password": true }
  ],
  "servers": {
    "sportapi": {
      "type": "stdio",
      "command": "uvx",
      "args": ["sportapi-mcp"],
      "env": {
        "SPORTAPI_KEY": "${input:sportapi-key}",
        "SPORTAPI_BASE_URL": "https://YOUR_API_DOMAIN"
      }
    }
  }
}

Windsurf и другие клиенты, которые умеют запускать MCP-серверы, подключаются так же: команда uvx, аргумент sportapi-mcp, переменные окружения SPORTAPI_KEY и SPORTAPI_BASE_URL. Язык ответов задаёт SPORTAPI_LANGUAGE — например, ru, если этот язык включён для вашего ключа.

11 инструментов сервера

ИнструментНа что отвечает
list_sportsКакие виды спорта сейчас есть в live и prematch
get_menuДерево «вид спорта → страна → турнир» с ID
list_countriesСтраны с матчами по виду спорта
list_tournamentsТурниры вида спорта в стране
list_live_matchesLive-матчи: счёт, период, минута, основные коэффициенты
list_prematch_matchesБудущие матчи: топ, турнир, вся линия или календарь на ближайшие часы и дни
get_matchОдин матч: счёт, live-статистика, все рынки и коэффициенты, подсобытия
search_matchesПоиск матчей по названию команды
top_matchesДо 10 самых популярных матчей
top_championshipsДо 12 популярных чемпионатов
account_statusРежим работы и состояние ключа

Все инструменты только читают данные: через MCP-сервер нельзя сделать ставку или что-то изменить в аккаунте. У подробного матча бывает больше 200 рынков, поэтому get_match по умолчанию отдаёт 15 и принимает фильтр, например ["1X2", "Total"]. Так ответ не съедает контекст ассистента.

Демо-режим и рабочий ключ

Без ключа сервер отвечает примерами из документации SportAPI. Каждый такой ответ помечен "source": "demo", поэтому ассистент не выдаст снимок за live-данные. Демо покрывает футбол: live- и prematch-списки, два подробных матча, поиск по «Manchester» и «Perth», топ-матчи. На запросы о других видах спорта сервер отвечает, что есть в демо и как получить ключ.

С ключом те же вопросы работают по всем видам спорта вашей подписки и по текущим матчам. Сервер сам соблюдает рекомендованные интервалы обновления: повторный вопрос раньше чем через 7 секунд для live-списка получит сохранённый снимок, а не новый запрос к API. Сколько бы раз ассистент ни вызвал инструмент, лишней нагрузки не будет.

Зачем это разработчику, аналитику и автору контента

Разработчику в Cursor или VS Code. Ассистент видит настоящую структуру ответа API, а не придумывает её. Попросите: «напиши функцию, которая выводит live-матчи с коэффициентами 1X2» — и код будет опираться на реальные поля. Для интеграции с приёмом ставок get_match(include_pointers=true) добавит к исходам oc_pointer, который нужен Coupon API. Если ассистент пишет интеграцию с нуля, дайте ему ещё и инструкцию для ИИ-агентов — в ней собраны правила работы с API.

Аналитику. Сценарий сравнения рынков считает вероятности и маржу по коэффициентам одного матча. Удобно, чтобы быстро оценить линию перед матчем, без таблиц и скриптов.

Автору контента. Анонс матча дня, итоги тура, подборка live-матчей для канала — ассистент собирает текст по свежим данным. Как поставить такие публикации на поток, мы разбирали в статье про Telegram-канал на автопилоте.

Если вы работаете в ChatGPT, посмотрите статью про прогнозы на спорт через ChatGPT: там данные SportAPI подключаются к собственному GPT через Actions или к своему боту через вызов функций.

Ошибки при подключении

  • Ключ в общем чате или в Git. Храните его в настройках MCP-клиента или в защищённом хранилище, как в примере для VS Code.
  • Ключ не работает с вашего компьютера. Ключ SportAPI привязан к разрешённым IP-адресам или сайтам. MCP-сервер обычно работает на вашем компьютере, поэтому его адрес должен быть разрешён для ключа. Инструмент account_status показывает, какой IP видит SportAPI.
  • Задан только один из двух параметров. Для live-данных нужны и SPORTAPI_KEY, и SPORTAPI_BASE_URL. Без обоих сервер работает в демо.
  • HTTP-режим открыт в интернет. У сервера есть режим Streamable HTTP, но своей авторизации у него нет. Держите его на localhost или за своим шлюзом, иначе вашим ключом воспользуется любой.
  • Демо принимают за live. В демо данные из документации за август–октябрь 2026 года. Ассистент об этом пишет — не пропускайте пометку.
  • Ожидают от ассистента точных прогнозов. Коэффициенты показывают, как рынок оценивает шансы, но не гарантируют результат.

Сколько стоит

Что нужноСтоимость
MCP-сервер sportapi-mcpбесплатно, открытый код, лицензия MIT
Демо-режимбесплатно, без ключа
Live-данные одного вида спорта: матчи, коэффициенты, краткая live-статистикаот $30 в месяц
Проверка до оплатыТестовый ключ на 2 дня, все виды спорта

Частые вопросы

Что такое MCP-сервер простыми словами?

Это небольшая программа, которая даёт ИИ-ассистенту инструменты: «найти матч», «показать коэффициенты», «проверить ключ». Ассистент сам решает, когда их вызвать, и строит ответ на полученных данных.

Нужен ли ключ, чтобы попробовать?

Нет. Без ключа сервер работает в демо-режиме на примерах из документации по футболу. Для текущих матчей и других видов спорта нужен ключ SportAPI — тестовый на 2 дня или платный.

Какие клиенты поддерживаются?

Claude Desktop, Claude Code, Cursor, VS Code, Windsurf и другие клиенты, которые умеют запускать MCP-серверы. Для Claude Desktop есть установка в один клик через файл .mcpb.

Можно ли через MCP делать ставки?

Нет. Все 11 инструментов только читают данные. Приём и расчёт ставок — это отдельный продукт, Coupon API, и он подключается к вашему серверу, а не к ассистенту.

На каком языке будут названия команд и турниров?

По умолчанию на английском. Переменная SPORTAPI_LANGUAGE включает другой язык, если он доступен для вашего ключа. Демо-данные — только на английском.

Где найти сервер в каталогах MCP?

В официальном реестре MCP, на Smithery и Glama — под названием sportapi-mcp. Код и релизы — на GitHub, пакет — на PyPI.

С чего начать

  1. Установите uv и выполните claude mcp add sportapi -- uvx sportapi-mcp или добавьте сервер в Cursor и VS Code.
  2. Спросите ассистента: «какие футбольные матчи сейчас идут и кто фаворит?» — и посмотрите ответ на демо-данных.
  3. Получите тестовый ключ и задайте тот же вопрос по текущим матчам своего вида спорта.

Напишите менеджеру SportAPI в Telegram, что подключаете MCP-сервер, — вы получите тестовый ключ к live-матчам и коэффициентам SportAPI и сможете спрашивать ассистента о сегодняшних матчах.

← Все статьи