Счётчик Яндекс Метрики
Перейти к основному содержанию
Atomno labs
Работает на боевом сервере api.atomno-mcp.ru/mcp-fns-check/v1

API проверки контрагента по ИНН: реквизиты и признаки риска

Проверка контрагента перед сделкой — самый частый запрос к данным налоговой службы: действует ли компания, кто руководитель, нет ли признаков однодневки. Раньше на этой странице не было ни одного адреса запроса. Теперь есть: ниже полный перечень, снятый с боевого сервера, живой пример и честный список того, какие проверки риска пока молчат.

Что означает статус. Проверено запросом 2 августа 2026 года: сервис отвечает и отдаёт настоящие данные государственного реестра. Подключиться можно прямо сейчас и без ключа — 50 запросов в сутки с одного адреса. Важная оговорка: из восьми проверок риска сейчас отвечает одна, остальные семь источников недоступны. Сервис не выдаёт это за «всё чисто» — он перечисляет, кто именно не ответил, и требует ручной проверки. В реестре наших серверов запись пока помечена как «на финише» — она устарела относительно факта.

Строка из нашего реестра серверов: Hosted REST: на финише (api.atomno-mcp.ru)

Что даёт API проверки контрагента по ИНН

Проверка контрагента по ИНН через обмен по HTTP — это способ получить программно то, что человек обычно смотрит руками на сайте налоговой службы: действует ли юридическое лицо, его реквизиты из государственного реестра, кто руководитель. Ответ приходит структурированным, поэтому его можно встроить в форму заведения контрагента, в скоринг или в ночную переоценку базы поставщиков. Адрес доступа — api.atomno-mcp.ru/mcp-fns-check/v1, и попробовать его можно без ключа: бесплатный режим даёт 50 запросов в сутки с одного адреса, платный ключ поднимает потолок до 10 000.

Рабочих адреса два основных. Карточка контрагента по ИНН отдаёт реквизиты, ОГРН, КПП, состояние, дату регистрации и руководителя. Сводная проверка дополняет карточку разделом риска и итоговым решением. Тут нужна прямота: из восьми проверок риска сейчас отвечает только государственный реестр, семь источников недоступны — реестр банкротств отвечает отказом, картотека арбитражных дел закрыта для автоматических обращений, местные базы реестров налоговой службы на сервере ещё не загружены. Сервис пишет об этом в ответе и ставит решение «требуется ручная проверка» вместо «нарушений не найдено».

Что сервис отдаёт

Таблица ниже — возможности MCP-сервера, то есть пакета для ИИ-агентов. Адреса для обычного обмена по HTTP перечислены отдельным разделом чуть ниже: они сняты с боевого сервера 2 августа 2026 года из машинного описания интерфейса и проверены запросами.

Возможность Что делает Что подаётся Что приходит
check_inn Проверка ИНН: статус, реквизиты, риски. inn: str CompanyData { inn, ogrn, name, status, risks[], address }
check_ogrn Проверка по ОГРН. ogrn: str CompanyData
mass_address_check Признак массового адреса регистрации. address: str MassAddressInfo { is_mass, count, risk_level }
director_disqualification Проверка дисквалификации директора. inn: str | full_name: str DisqualificationInfo

Адреса запросов

Метод Путь Ключ Что делает
GET /mcp-fns-check/health не нужен Проверка живости — адрес проверен на боевом сервере
GET /mcp-fns-check/readyz не нужен Готовность: контекст сервиса и хранилище кэша
GET /mcp-fns-check/v1/openapi.json не нужен Машинное описание всех адресов
GET /mcp-fns-check/v1/basic-info/{inn} не нужен Карточка контрагента по ИНН: реквизиты, состояние, руководитель
POST /mcp-fns-check/v1/check-contractor не нужен Сводная проверка: карточка, состояние, восемь проверок риска, решение
POST /mcp-fns-check/v1/batch-check только платный ключ Пакетная проверка, до 100 идентификаторов за раз
GET /mcp-fns-check/v1/rnp/{inn} не нужен Реестр недобросовестных поставщиков — заглушка, данные ненастоящие
GET /mcp-fns-check/v1/fns-debt/{inn} не нужен Налоговая задолженность — заглушка, данные ненастоящие

Раньше здесь стоял один адрес с оговоркой «в боевой настройке может отличаться». Оговорка снята: перечень взят из машинного описания живого сервиса и проверен запросами. Обратите внимание на две особенности. Первая: проверки живости идут без части /v1 в адресе — так настроен шлюз. Вторая: адрес проверки банкротства физического лица есть в исходном коде, но на сервер выложена более старая сборка, и он отвечает «не найдено». Мы его в перечень не включаем.

Общие правила обмена Хост api.atomno-mcp.ru, формат JSON, серверы в России. Ошибки приходят в JSON с полями error, message и message_ru.
Ключ доступа Заголовок Authorization: Bearer или X-API-Key — способ зависит от сервиса и указан в примерах.

Примеры запросов

Где под примером написано, что ответ настоящий, — он снят с боевого сервера и приведён как есть. Выдуманных ответов на этой странице нет.

Карточка контрагента — запрос без ключа

Живой запрос и настоящий ответ сервиса, снятые 2 августа 2026 года. Ответ сокращён: убраны пустые поля. Пустыми приходят адрес, учредители, виды деятельности, налоговый режим и уставный капитал — это отдельная доработка.


        curl https://api.atomno-mcp.ru/mcp-fns-check/v1/basic-info/7707083893

{
  "inn": "7707083893",
  "ogrn": "1027700132195",
  "kpp": "773601001",
  "type": "legal_entity",
  "status": "active",
  "name": {
    "full": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
    "short": "ПАО СБЕРБАНК"
  },
  "registration": { "date": "2002-08-16" },
  "director": {
    "full_name": "ПРЕЗИДЕНТ, ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ: Греф Герман Оскарович"
  },
  "data_source_meta": { "fetched_at": "2026-08-02T11:24:16.624784Z" }
}
      

Сводная проверка — и честный ответ о недоступных источниках

Тот же живой запрос, ответ сокращён до раздела риска. Так выглядит правильное поведение: сервис не пишет «нарушений не найдено», а перечисляет, кто именно не ответил, и требует ручной проверки. Из восьми проверок сейчас отвечает одна.


        curl -X POST https://api.atomno-mcp.ru/mcp-fns-check/v1/check-contractor \
  -H "Content-Type: application/json" \
  -d '{"identifier": "7707083893"}'

{
  "legal_status": {
    "status": "active",
    "status_label_ru": "Действующее",
    "sources_checked": ["egrul"],
    "warnings": ["Источник ЕФРСБ недоступен: ЕФРСБ вернул 403.. Статус только по ЕГРЮЛ."]
  },
  "risks": {
    "summary_ru": "Итоговый уровень риска: низкий. Не удалось выполнить проверок: 7 (см. errors). Проверок пропущено: 1 (нет данных, см. checks_skipped).",
    "checks_passed": [],
    "checks_skipped": ["mass_address"],
    "errors": [
      { "code": "mass_director", "error": "registry_empty" },
      { "code": "disqualified_director", "error": "registry_empty" },
      { "code": "bankruptcy_records", "error": "ЕФРСБ вернул 403." },
      { "code": "tax_debts", "error": "Прозрачный бизнес вернул 400." },
      { "code": "no_reporting", "error": "Прозрачный бизнес вернул 400." },
      { "code": "enforcement_proceedings", "error": "Не удалось декодировать JSON-ответ ФССП." },
      { "code": "active_lawsuits", "error": "КАД вернул 451." }
    ]
  },
  "verdict_action": "manual_review_required",
  "verdict_reason_ru": "Часть источников не ответила (7 из 8). Ручная верификация неответивших источников обязательна.",
  "tier": "free"
}
      

Правовое основание и источник данных

Проверка контрагента опирается на три разных государственных источника, и у каждого своя норма, которая делает сведения открытыми.

Реестр юридических лиц и индивидуальных предпринимателей Ведёт: Федеральная налоговая служба

Федеральный закон от 08.08.2001 № 129-ФЗ, пункт 1 статьи 6: сведения государственных реестров открыты и общедоступны, кроме прямо ограниченных законом.

Реестр дисквалифицированных лиц Ведёт: Федеральная налоговая служба

Кодекс об административных правонарушениях, часть 3 статьи 32.11: реестр открыт для всеобщего ознакомления и размещается на сайте налоговой службы.

Реестр малого и среднего предпринимательства Ведёт: Федеральная налоговая служба

Федеральный закон от 24.07.2007 № 209-ФЗ, часть 9 статьи 4.1: сведения размещаются на сайте налоговой службы 10-го числа каждого месяца и остаются открытыми пять лет.

Отдельно про адреса массовой регистрации: нормы, которая прямо объявляла бы такой перечень общедоступным, мы не нашли, поэтому проверка помечена демонстрационной и не продаётся как боевая. Официальную выписку из реестра дисквалифицированных лиц наш ответ не заменяет — её выдаёт сама налоговая служба как государственную услугу. И ещё одно: два адреса из перечня выше сейчас отдают заведомо ненастоящие данные — реестр недобросовестных поставщиков и налоговая задолженность. Они помечены полем ready: false, но опираться на них нельзя.

По каждому реестру — норма, которая делает сведения открытыми, перечень полей и то, чего мы сознательно не берём: источники данных и правовые основания . Первоисточник этого сервиса — ФНС России (egrul.nalog.ru) . Atomno MCP не аффилирован с ним.

Чем это отличается от MCP-сервера

Данные одни и те же, отличается способ обращения. Обмен по HTTP разбирает ваш код, MCP-сервер — языковая модель внутри вашего продукта или редактора.

Берите обмен по HTTP, если

  • Проверка встроена в форму заведения контрагента или в согласование договора.
  • Нужна ночная переоценка всей базы поставщиков по расписанию.
  • Результат идёт в отчёт для комплаенс-службы, а не в диалог с моделью.

Берите MCP-сервер, если

  • Юрист или закупщик общается с ассистентом текстом и просит «проверь эту компанию».
  • Агент должен сам решить, какие проверки запускать по контексту переписки.
  • Нужно попробовать данные в редакторе кода до принятия решения о договоре.

Для сводной проверки есть готовая посадочная страница с таблицей состояния каждой проверки — там видно, что уже отдаёт боевые данные, а что в подключении.

Чего пока нет

Мы предпочитаем назвать пробел, чем показать красивую страницу и подвести вас на этапе интеграции. Здесь и то, чего нет в документации, и то, что не работает в самом сервисе.

  • Из восьми проверок риска отвечает одна. Реестр банкротств и картотека арбитражных дел отказывают в автоматическом обращении, местные базы реестров налоговой службы на сервере ещё не загружены, разбор ответа службы приставов сломан.
  • Реестр недобросовестных поставщиков и налоговая задолженность — заглушки. Опаснее всего первая: она утверждает, что реальная компания включена в реестр, и подкрепляет это правдоподобной датой. Убираем.
  • Карточка приходит неполной: адрес, учредители, виды деятельности, налоговый режим и уставный капитал всегда пустые.
  • Кэш на карточке контрагента не срабатывает — каждый запрос идёт к источнику и тратит суточный лимит.
  • Итоговая оценка риска остаётся «низкой» даже когда семь проверок не отработали. Пояснение рядом верное, но само число вводит в заблуждение того, кто читает только его.
  • На сервер выложена не самая свежая сборка: проверка банкротства физического лица есть в коде, но на боевом адресе отвечает «не найдено».

Вопросы и ответы

Можно ли прямо сейчас проверить контрагента по ИНН через ваш обмен по HTTP? +
Да, и даже без ключа. Запрос вида GET /mcp-fns-check/v1/basic-info/7707083893 отдаёт карточку из государственного реестра; бесплатный режим — 50 запросов в сутки с одного адреса. Ключ нужен, если требуется больший объём или пакетная проверка.
Как передавать ключ доступа? +
Заголовком Authorization: Bearer и ваш ключ. Это важно не перепутать: у соседнего сервиса налоговых расчётов другая схема — заголовок X-API-Key. Если заголовка нет вообще, запрос обрабатывается в бесплатном режиме, а не отклоняется.
Что будет, если реестр не ответил во время проверки? +
Сервис не пишет «нарушений не найдено». Он перечисляет в разделе errors каждый неответивший источник с причиной, ставит решение «требуется ручная проверка» и в тексте указывает, сколько проверок из восьми не отработало. Сейчас, честно говоря, не отрабатывают семь — над этим идёт работа.
Проверка заменяет юридическое заключение? +
Нет. Ответ — сводка сведений из открытых государственных реестров на момент запроса. Мы не выводим из наличия записи оценок добросовестности или платёжеспособности. Финальное решение остаётся за вашим процессом проверки контрагентов.
Как узнать остаток запросов? +
Из заголовков ответа: x-ratelimit-limit — потолок, x-ratelimit-remaining — сколько осталось, x-ratelimit-reset — момент сброса счётчика в секундах эпохи Unix. Счёт посуточный, обнуляется в полночь по всемирному времени.

Запросить доступ к проверке контрагентов

Карточку и сводную проверку можно попробовать без ключа прямо сейчас — примеры выше рабочие. Ключ нужен для больших объёмов и пакетной проверки. Опишите сценарий: скажем прямо, какие проверки риска уже отвечают, а каких пока нет. Почта для писем: sales@atomno.com .

Запросить доступ

Ответ сервиса — сводка сведений из открытых государственных реестров на момент запроса, а не юридическое заключение. Недоступность источника мы не выдаём за отсутствие записей.