api.atomno-mcp.ru/mcp-egrul/v1 API ЕГРЮЛ: карточка юрлица и ИП по ИНН или ОГРН
Реестр юридических лиц и предпринимателей ведёт налоговая служба, а сведения из него нужны почти любому продукту, который работает с компаниями: от формы подстановки реквизитов до карточки поставщика в закупочном сервисе. Ниже — что именно готовится отдавать наш адрес доступа, какие пути уже описаны и чего в описании пока нет.
Что означает статус. Пути зафиксированы в черновом справочнике по коду бэкенда, но запуск не завершён: самостоятельной регистрации нет, ключ выдаётся точечно под согласованный сценарий. Пока это не боевой сервис с открытым доступом.
Строка из нашего реестра серверов: Hosted REST: на финише (api.atomno-mcp.ru)
Что такое API ЕГРЮЛ и какие данные оно возвращает
API ЕГРЮЛ — это доступ по протоколу HTTP к сведениям Единого государственного реестра юридических лиц и предпринимателей: программа передаёт ИНН или ОГРН и получает карточку организации структурированным ответом, без ручного ввода кода с картинки на сайте налоговой службы. В линейке Atomno такой доступ живёт на общем хосте api.atomno-mcp.ru под префиксом /mcp-egrul/v1 и находится в состоянии «на финише»: пути описаны, ключи выдаются точечно, публичной самостоятельной регистрации ещё нет.
Черновой справочник описывает восемь путей: карточка по ИНН, карточка по ОГРН, поиск по наименованию, универсальная карточка через параметр запроса, список учредителей, сведения о руководителе, две проверки живости сервиса и пакетный запрос до ста идентификаторов за раз. Сведения реестра общедоступны в силу пункта 1 статьи 6 Федерального закона № 129-ФЗ, поэтому использовать их в своём продукте закон разрешает. Тот же набор данных доступен через MCP-сервер mcp-egrul, если внутри продукта уже работает ИИ-агент с вызовом инструментов.
Что сервис отдаёт
Состав карточки одинаков для доступа по HTTP и для MCP-сервера — модели ответа общие. Ниже список возможностей так, как он объявлен в реестре наших серверов: название, что подаётся на вход и что приходит в ответе.
| Возможность | Что делает | Что подаётся | Что приходит |
|---|---|---|---|
| get_company | Полные реквизиты юрлица по ИНН или ОГРН. | identifier: str (ИНН или ОГРН) | Company { inn, ogrn, kpp, name, status, address, founders[], directors[], okveds[] } |
| search_companies | Поиск юрлиц по названию или фрагменту реквизитов. | query: str, limit?: int | list[CompanyShort] |
| get_director_history | История смены директоров (Pro). | inn: str | list[DirectorRecord] |
| get_founders | Учредители юрлица с долями. | inn: str | list[Founder { name, type, share }] |
- Поиск по названию принимает строку запроса, ограничение количества и признак «только действующие».
- Пакетный путь принимает до ста идентификаторов в одном обращении и относится к платному тарифу.
- В ответах приходят заголовки с остатком лимита запросов — конкретные числа зависят от тарифа и фиксируются в договоре.
- История смены руководителей объявлена как возможность платного тарифа, а не бесплатного клиента.
Адреса запросов
| Метод | Путь | Ключ | Что делает |
|---|---|---|---|
| GET | /mcp-egrul/v1/health | не нужен | Проверка живости сервиса |
| GET | /mcp-egrul/v1/ready | не нужен | Готовность: база и кэш |
| GET | /mcp-egrul/v1/companies/inn/{inn} | ключ | Карточка по ИНН: 10 цифр — организация, 12 — предприниматель |
| GET | /mcp-egrul/v1/companies/ogrn/{ogrn} | ключ | Карточка по ОГРН или ОГРНИП |
| GET | /mcp-egrul/v1/companies/search | ключ | Поиск по наименованию: параметры q, limit, only_active |
| GET | /mcp-egrul/v1/companies/card | ключ | Универсальная карточка: параметр inn или ogrn |
| GET | /mcp-egrul/v1/companies/{inn}/founders | ключ | Учредители, только для 10-значного ИНН |
| GET | /mcp-egrul/v1/companies/{inn}/director | ключ | Сведения о руководителе |
| POST | /mcp-egrul/v1/companies/bulk | ключ, платный тариф | Пакетный запрос — до 100 ИНН за раз |
Это черновой справочник: пути собраны из кода бэкенда и описаны в разделе документации о REST-доступе. Точные договорные условия и предельные значения фиксируются под конкретный сценарий, а полное машинное описание интерфейса выдаётся вместе с тестовым ключом — открытого файла со схемой на шлюзе пока нет.
api.atomno-mcp.ru, формат JSON,
серверы в России. Ошибки приходят в JSON с полями error, message и message_ru.
Authorization: Bearer или
X-API-Key — способ зависит от сервиса
и указан в примерах.
Примеры запросов
Где под примером написано, что ответ настоящий, — он снят с боевого сервера и приведён как есть. Выдуманных ответов на этой странице нет.
Запрос карточки по ИНН
Пример приведён в разделе документации о REST-доступе. Ключ в примере — заглушка, реальный выдаётся при подключении. Полный состав полей ответа в открытой документации не зафиксирован, поэтому мы его здесь не приводим.
curl https://api.atomno-mcp.ru/mcp-egrul/v1/companies/inn/7707083893 \
-H "Authorization: Bearer <ваш-ключ>"
Правовое основание и источник данных
Мы берём только то, что государственный орган сам опубликовал и объявил общедоступным. Для реестра юридических лиц это одна норма, и она же ограничивает нас в том, чего брать нельзя.
Федеральный закон от 08.08.2001 № 129-ФЗ, пункт 1 статьи 6: сведения и документы государственных реестров открыты и общедоступны, кроме сведений, доступ к которым закон прямо ограничил.
Данные документов, удостоверяющих личность, мы не отдаём: тот же пункт 1 статьи 6 выдаёт их только государственным органам, судам и внебюджетным фондам. Отдельно стоит знать про сводную проверку контрагентов: в ней проверка по реестру сейчас возвращает реквизиты, ОГРН, КПП, состояние, дату регистрации и руководителя, а учредители, адрес и основной вид деятельности пока не приходят.
По каждому реестру — норма, которая делает сведения открытыми, перечень полей и то, чего мы сознательно не берём: источники данных и правовые основания . Первоисточник этого сервиса — ФНС России (egrul.nalog.ru) . Atomno MCP не аффилирован с ним.
Чем это отличается от MCP-сервера
Данные одни и те же, отличается способ обращения. Обмен по HTTP разбирает ваш код, MCP-сервер — языковая модель внутри вашего продукта или редактора.
Берите обмен по HTTP, если
- У вас витрина, справочник или форма подстановки реквизитов — обычный обмен по HTTP проще.
- Бэкенд написан на PHP, Go, Node или Java и языковой модели внутри нет.
- Данные нужны бизнес-логике: сверка контрагента, автозаполнение договора, выгрузка в учётную систему.
Берите MCP-сервер, если
- Внутри продукта уже есть ИИ-агент, который сам выбирает инструменты.
- Хочется получить готовые описания инструментов и типизированные ошибки, а не писать обёртки руками.
- Нужно быстро попробовать данные в редакторе кода — сервер ставится одной строкой.
Один и тот же бэкенд, разные способы обращения. Разница в том, кто разбирает ответ: ваш код или языковая модель. Подробности про сам сервер и установку в редактор — на странице MCP-сервера.
Чего пока нет
Мы предпочитаем назвать пробел, чем показать красивую страницу и подвести вас на этапе интеграции. Здесь и то, чего нет в документации, и то, что не работает в самом сервисе.
- Полный состав полей карточки в открытой документации не описан — приходит вместе с ключом.
- Коды ошибок и предельные значения лимитов для этого префикса публично не зафиксированы.
- Открытого файла с машинным описанием интерфейса на шлюзе нет: он отдаёт заглушку закрытой беты.
Вопросы и ответы
Можно ли уже получить ключ к API ЕГРЮЛ? +
Чем карточка по ИНН отличается от карточки по ОГРН? +
Сколько компаний можно запросить за один раз? +
Законно ли использовать сведения ЕГРЮЛ в своём сервисе? +
Что придёт в ответе, если реестр не ответил? +
Запросить доступ к API ЕГРЮЛ
Расскажите, какие поля карточки нужны и какой ожидается объём обращений. Мы честно скажем, что уже отдаётся, а что ещё в работе, и выдадим тестовый ключ вместе с описанием интерфейса. Почта для писем: sales@atomno.com .
Запросить доступОтвет сервиса — сводка сведений из открытых государственных реестров на момент запроса, а не юридическое заключение. Недоступность источника мы не выдаём за отсутствие записей.