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.