mcp · balldontlie-api — MCP-сервер BALLDONTLIE для Claude Code
Удалённый MCP-сервер к спортивному API BALLDONTLIE: агент получает инструменты по лигам и видам спорта — от NBA и NFL до Dota 2 и F1.
claude mcp add --transport http balldontlie-api-mcp https://mcp.balldontlie.io/mcpЧто делает mcp
Это MCP-сервер, который работает по HTTP и не требует локального запуска: в конфигурацию клиента прописывается адрес https://mcp.balldontlie.io/mcp. Каталог инструментов сгенерирован из публичных OpenAPI-спецификаций API, поэтому методы, пути и параметры совпадают с исходником. В нынешнем наборе 529 инструментов из 27 спецификаций — NBA, NFL, MLB, NHL, футбольные лиги, F1, теннис, киберспорт. Точное число и ревизию отдаёт /health.
Каждый запрос требует ключ BALLDONTLIE в заголовке Authorization: Bearer YOUR_API_KEY. Без него не пройдут ни инициализация, ни просмотр списка инструментов. Часть инструментов Account по умолчанию выключена: они создают ключи, меняют подписку и возвращают ссылки на биллинг-сессии. Чтобы их включить, на сервере ставится ENABLE_SENSITIVE_ACCOUNT_TOOLS=true — только точное значение, любые другие написания флаг не поднимают.
Для проверки каталога удобно вызвать tools/list и посмотреть входные схемы. Логи и трейсинг не содержат значений авторизации, тел запросов и ошибок апстрима.
Какие задачи решает
- Получить статистику игрока NBA прямо в чате агента
- Сверить расписание матчей EPL без похода на сайт API
- Вытащить таблицу лиги по ходу диалога с моделью
- Проверить составы команд NHL из редактора
- Запросить данные по Dota 2 и Valorant тем же ключом
Примеры запросов агенту
- Покажи таблицу NBA за этот сезон
- Найди последние матчи
nba_get_teamsи выведи список команд - Собери расписание EPL на неделю
Как установить mcp
Командой платформы: удалённый сервер
claude mcp add --transport http balldontlie-api-mcp https://mcp.balldontlie.io/mcpКомандой платформы: удалённый сервер
codex mcp add balldontlie-api-mcp --url https://mcp.balldontlie.io/mcpФайл настроек
{
"mcpServers": {
"balldontlie-api-mcp": {
"url": "https://mcp.balldontlie.io/mcp"
}
}
}Файл настроек
{
"servers": {
"balldontlie-api-mcp": {
"type": "http",
"url": "https://mcp.balldontlie.io/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http balldontlie-api-mcp https://mcp.balldontlie.io/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp
Как установить mcp в Claude Code?
Выполните claude mcp add --transport http balldontlie-api-mcp https://mcp.balldontlie.io/mcp. После этого сервер появится в списке MCP-серверов и запросит ключ BALLDONTLIE при обращении.
Что делает mcp?
Открывает агенту доступ к спортивным данным BALLDONTLIE через набор MCP-инструментов, сгенерированных из публичных OpenAPI-спецификаций API.
Нужен ли ключ API?
Да, каждый запрос идёт с заголовком Authorization: Bearer YOUR_API_KEY. Без действующего ключа не работают ни просмотр инструментов, ни операции.
Похожие MCP-серверы
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Сначала — mcp от других авторов.