KontragentPro

MCP-сервер KontragentPro

MCP-сервер KontragentPro позволяет проверять российские компании по ИНН прямо в диалоге с ИИ-ассистентом: вы спрашиваете про контрагента, ассистент сам обращается к реестрам и отвечает данными из ЕГРЮЛ, отчётности ФНС и реестра банкротств. Устанавливается одной строкой, работает без регистрации.

Установка в Claude Desktop

Откройте «Настройки → Developer → Edit Config» и добавьте сервер в раздел mcpServers. Перезапустите приложение — инструменты появятся в списке.

{
  "mcpServers": {
    "kontragentpro": {
      "command": "uvx",
      "args": ["kontragentpro-mcp"]
    }
  }
}

Команда uvx скачивает пакет kontragentpro-mcp с PyPI и запускает его без установки в систему. Если предпочитаете pip — pip install kontragentpro-mcp, затем команда kontragentpro-mcp.

Установка в Cursor

«Settings → MCP → Add new server», тип command, та же команда uvx kontragentpro-mcp. Конфигурация совпадает с Claude Desktop, потому что сервер общается по stdio — стандартному транспорту Model Context Protocol.

Инструменты сервера

Сервер объявляет пять инструментов. Ассистент выбирает нужный сам, исходя из вопроса.

Инструмент	Что делает
get_company	Сводная карточка юрлица по ИНН одним запросом
get_company_financials	Многолетняя финансовая динамика из ГИР БО ФНС
get_company_timeline	Лента событий: банкротства, проверки, товарные знаки
search_companies	Подбор юрлиц по годовому доходу (открытые данные ФНС), региону, ОКВЭД, численности
check_account	Остаток дневной квоты по вашему ключу

Лимиты и ключ

Без ключа доступно 5 запросов в минуту — этого хватает попробовать, но одна развёрнутая проверка компании занимает несколько вызовов подряд. Бесплатный ключ поднимает лимит до 60 запросов в минуту и 100 в сутки; выдаётся сразу в личном кабинете на странице для разработчиков. Ключ передаётся серверу переменной окружения KONTRAGENTPRO_API_KEY.

Источники данных

MCP-сервер не хранит данные: это обёртка над публичным API v2, который отдаёт сведения из государственных реестров — ЕГРЮЛ ФНС, ГИР БО ФНС (бухгалтерская отчётность), ЕФРСБ (банкротства), ЕРКНМ Генеральной прокуратуры (проверки), Роспатент (товарные знаки), реестры санкций и иностранных агентов Минюста. У каждого блока в ответе указан источник, поэтому ассистент может сослаться на него в своём ответе. Те же реестры мы выкладываем агрегированными наборами на странице открытых данных.

Если ассистент не нужен

Те же данные доступны без установки чего-либо: откройте проверку по ИНН прямо на сайте или подберите компании через каталог юрлиц с фильтрами по годовому доходу, региону и ОКВЭД. Для встраивания в своё приложение подойдёт REST API; условия и лимиты платного тарифа — на странице тарифов.

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

Что такое MCP и зачем он нужен

Model Context Protocol — открытый протокол, по которому ИИ-ассистент вызывает внешние инструменты. Без него ассистент отвечает про компанию по памяти обучающих данных, и сведения устаревшие. С MCP-сервером KontragentPro он обращается к реестрам в момент вопроса и отвечает актуальными данными.

Нужен ли API-ключ

Нет. Без ключа работает анонимный доступ, 5 запросов в минуту. Ключ нужен, если упираетесь в лимит: с ним 60 запросов в минуту и 100 в сутки, бесплатно.

В каких клиентах работает

В любом MCP-клиенте со stdio-транспортом: Claude Desktop, Cursor, Claude Code и других. Сервер опубликован в официальном реестре Model Context Protocol под именем io.github.kontragentpro/kontragentpro-mcp.

Чем отличается от REST API

Данные и лимиты одни и те же. REST API вызывается из вашего кода, MCP-сервер — самим ассистентом, писать код не нужно. Если встраиваете проверку в своё приложение или CRM, берите REST API.

Можно ли посмотреть исходный код

Да, сервер открыт под лицензией MIT: github.com/kontragentpro/kontragentpro-mcp. Пакет публикуется на PyPI, текущая версия 0.2.2.