KontragentPro MCP: проверка компаний по ИНН
KontragentPro MCP server
Официальный MCP KontragentPro, который без ключа проверяет российские компании по ИНН: ЕГРЮЛ, отчетность ФНС, банкротства, проверки и санкционные списки
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает открытые реестры, никаких операций записи или платежей
- Ключ опциональный и повышает только лимит запросов, а не права доступа к чужим данным
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kontragentpro-mcp-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio kontragentpro-mcp -- uvx kontragentpro-mcp==0.3.0Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"kontragentpro-mcp": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"kontragentpro-mcp": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"kontragentpro-mcp","type":"stdio","command":"uvx","args":["kontragentpro-mcp==0.3.0"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"kontragentpro-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add kontragentpro-mcp -- uvx kontragentpro-mcp==0.3.0Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.kontragentpro-mcp]
command = "uvx"
args = ["kontragentpro-mcp==0.3.0"]Если файл уже есть, допишите блок в конец.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user kontragentpro-mcp uvx kontragentpro-mcp==0.3.0Или добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"kontragentpro-mcp": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"kontragentpro-mcp": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"kontragentpro-mcp": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"kontragentpro-mcp": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"kontragentpro-mcp": {
"type": "local",
"command": [
"uvx",
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"kontragentpro-mcp": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"kontragentpro-mcp": {
"command": "uvx",
"args": [
"kontragentpro-mcp==0.3.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
KONTRAGENTPRO_API_KEYсекрет, необязательная- Optional API key from https://kontragentpro.ru/developers. Without it the anonymous free tier is used.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь в конфигурацию MCP клиента команду uvx kontragentpro-mcp без ключа для теста, затем запрашивай проверку компаний по ИНН через get_company и get_company_financials; для повышения лимитов получи ключ на kontragentpro.ru/developers и пропиши его в переменной KONTRAGENTPRO_API_KEY.
Другие способы из описания автора
uvx kontragentpro-mcpЗапуск без установки через uv, команда из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает публичный API KontragentPro v2 в пять инструментов: search_companies подбирает юрлица по фильтрам (годовой доход по открытым данным ФНС, регион, ОКВЭД, штат, статус банкротства), get_company отдает сводную карточку компании одним запросом по ИНН, get_company_financials возвращает многолетнюю динамику из ГИР БО ФНС, а если ее нет, возвращает годовой снимок открытых данных, get_company_timeline собирает ленту событий: банкротства, проверки Генпрокуратуры, товарные знаки, записи Вестника, иноагенты. check_account показывает баланс, план и дневную квоту, но требует ключ. Все данные идут из официальных открытых реестров: ЕГРЮЛ/ЕГРИП, ФНС, ЕФРСБ, Роспатент, списки санкций и иноагентов, каждый блок карточки указывает источник и дату получения.
Для кого. Для юристов, финансистов и основателей, которым нужна быстрая проверка контрагента по ИНН без обязательной регистрации.
Подходит, если
- Нужно быстро проверить компанию по ИНН: статус, учредителей, банкротство
- Нужна многолетняя динамика выручки и других показателей из отчетности ФНС
- Нужен подбор списка компаний по региону, ОКВЭД или доходу без готового ИНН
Не подходит, если
- Нужны повышенные лимиты запросов или проверка остатка баланса: для check_account и большего дневного лимита нужен ключ KONTRAGENTPRO_API_KEY
- Нужна официальная выписка ЕГРЮЛ для суда или банка: сервис прямо говорит, что не заменяет ее
- Нужны данные не из открытых источников, например закрытая финансовая отчетность
Пример запроса к агенту
Проверь контрагента с ИНН 7736207543 и покажи динамику выручки за 5 летОграничения
Без ключа сервер работает в анонимном бесплатном режиме с пониженным лимитом запросов. Данные предоставляются «как есть» из открытых источников и прямо не являются заменой официальной выписки. Часть отчетности берется из ГИР БО ФНС, а при ее отсутствии подставляется только годовой снимок открытых данных, то есть глубина истории у разных компаний может отличаться.
Как отключить. Удалите блок kontragentpro из mcpServers в конфигурации клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| KONTRAGENTPRO_API_KEY секрет | Ключ из личного кабинета для повышенных лимитов и check_account, без него сервер работает анонимно с пониженным лимитом. |
| KONTRAGENTPRO_API_BASE | Базовый URL API, по умолчанию https://kontragentpro.ru/api/v2. |
| KONTRAGENTPRO_TIMEOUT | HTTP-таймаут в секундах, по умолчанию 30. |
Проверка безопасности
- Только читает открытые реестры, никаких операций записи или платежей
- Ключ опциональный и повышает только лимит запросов, а не права доступа к чужим данным
Коротко о README
Двуязычный README описывает тонкую обертку над публичным API KontragentPro v2 с пятью инструментами проверки компаний по открытым российским реестрам. Показаны установка через uvx и pip, конфигурация для Claude Desktop и Cursor, пример запроса и таблица переменных окружения с бесплатным ключом на сайте. Отдельно перечислены источники данных с указанием, что каждый блок карточки несет отметку источника и даты. Лицензия MIT.
Частые вопросы
Обязателен ли ключ API?
Нет, без ключа сервер работает в анонимном режиме с пониженным лимитом, ключ нужен только для повышенных лимитов и check_account.
Заменяет ли сервис официальную выписку ЕГРЮЛ?
Нет, README прямо говорит, что данные предоставляются как есть и не заменяют официальную выписку.
Похожие
Набор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке
inn-check-ru: светофор риска по ИНН
inn-check-ru
Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной