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 |
- Ограничение посуточное: 50 запросов в сутки без ключа, 10 000 по платному ключу. Счёт сбрасывается в полночь по всемирному времени.
- В каждом ответе приходят заголовки x-ratelimit-limit, x-ratelimit-remaining и x-ratelimit-reset — остаток видно до того, как упрётесь в потолок.
- Заголовок X-Cache показывает, взят ли ответ из кэша. Срок жизни — сутки. На карточке контрагента кэш пока не срабатывает, это в доработках.
- Машинное описание всех адресов открыто без ключа: /mcp-fns-check/v1/openapi.json.
- Два адреса из семи — заглушки с ненастоящими данными: реестр недобросовестных поставщиков и налоговая задолженность. Они помечены полем ready: false.
Адреса запросов
| Метод | Путь | Ключ | Что делает |
|---|---|---|---|
| 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? +
Как передавать ключ доступа? +
Что будет, если реестр не ответил во время проверки? +
Проверка заменяет юридическое заключение? +
Как узнать остаток запросов? +
Запросить доступ к проверке контрагентов
Карточку и сводную проверку можно попробовать без ключа прямо сейчас — примеры выше рабочие. Ключ нужен для больших объёмов и пакетной проверки. Опишите сценарий: скажем прямо, какие проверки риска уже отвечают, а каких пока нет. Почта для писем: sales@atomno.com .
Запросить доступОтвет сервиса — сводка сведений из открытых государственных реестров на момент запроса, а не юридическое заключение. Недоступность источника мы не выдаём за отсутствие записей.