Спортивные данные прямо в Claude, Cursor и VS Code: live-матчи и коэффициенты через MCP
Как подключить live-матчи, счёт, статистику и коэффициенты к Claude, Cursor и VS Code через MCP-сервер 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_matches | Live-матчи: счёт, период, минута, основные коэффициенты |
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.
С чего начать
- Установите uv и выполните
claude mcp add sportapi -- uvx sportapi-mcpили добавьте сервер в Cursor и VS Code. - Спросите ассистента: «какие футбольные матчи сейчас идут и кто фаворит?» — и посмотрите ответ на демо-данных.
- Получите тестовый ключ и задайте тот же вопрос по текущим матчам своего вида спорта.
Напишите менеджеру SportAPI в Telegram, что подключаете MCP-сервер, — вы получите тестовый ключ к live-матчам и коэффициентам SportAPI и сможете спрашивать ассистента о сегодняшних матчах.