Перейти к основному содержанию
ФНС / НалогиОткрытое ядро

mcp-egrul — ЕГРЮЛ

Российские реквизиты организации по ИНН или ОГРН.

Подключение и доступ

Отдельное подключение здесь не оформляется.

Доступ по этому направлению оформляется в составе «Проверки контрагента». Состав и ограничения указаны на странице проверки.

Источник отдельного клиента не подключён; сведения пакета контрагента имеют свои границы.

В исходной документации указан локальный пакет atomno-mcp-egrul. Его наличие не подтверждает доступ к источнику.

Вкратце

Российские реквизиты организации по ИНН или ОГРН. Источник отдельного клиента не подключён; сведения пакета контрагента имеют свои границы.

Пример в чате

Учебный пример, не живой ответ. Размещённый доступ к этому составу данных не подтверждён (реквизиты по ИНН 7707083893 — демо-данные, не живой ответ).

atomno-egrul Демо · полные реквизиты, учредители, история директоров

Источник данных:ФНС России (egrul.nalog.ru) . Atomno MCP не аффилирован с провайдером.

Установка

Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.

Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):

Конфигурация (переменные окружения)

Переменная Описание Где взять Required Default
MCP_EGRUL_TOKEN API token для Pro tier (hosted) Отдельный размещённый доступ не подтверждён; см. ограничения выше no —
MCP_EGRUL_LOG_LEVEL Уровень логирования — no INFO

Инструменты MCP-сервера

Сервер регистрирует 4инструмента для AI-агента. Все входные данные строго проверяются.

Ниже — описанные в документации инструменты. Их наличие не подтверждает успешный вызов или доступ к источнику.

get_company async tool

Полные реквизиты юрлица по ИНН или ОГРН.

Input
identifier: str (ИНН или ОГРН)
Output
Company { inn, ogrn, kpp, name, status, address, founders[], directors[], okveds[] }
search_companies async tool

Поиск юрлиц по названию или фрагменту реквизитов.

Input
query: str, limit?: int
Output
list[CompanyShort]
get_director_history async tool

История смены директоров (Pro).

Input
inn: str
Output
list[DirectorRecord]
get_founders async tool

Учредители юрлица с долями.

Input
inn: str
Output
list[Founder { name, type, share }]

Примеры использования

Реальные запросы для AI-агента в Cursor / Claude Code:

  • get_company: «Используй mcp-egrul инструмент get_company и полные реквизиты юрлица по инн или огрн.»
  • search_companies: «Используй mcp-egrul инструмент search_companies и поиск юрлиц по названию или фрагменту реквизитов.»
  • get_director_history: «Используй mcp-egrul инструмент get_director_history и история смены директоров (pro).»

Решение проблем

1. uvx не найден

Установите uv: pipx install uv (или pip install uv). После этого uvx доступен в PATH.

2. MCP не подцепился в Cursor

Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью (Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.

Полное руководство по решению проблем → /docs/troubleshooting

FAQ

Можно ли подключить отдельный размещённый доступ к ЕГРЮЛ?
Отдельный размещённый сервис пока не предлагается для подключения. Наличие клиентского пакета не открывает доступ к реестру; дата состояния и ограничения указаны в описании выше.
Какие реквизиты нужны для запроса к ЕГРЮЛ?
Клиент описывает получение сведений об организациях и ИП по ИНН или ОГРН. Входные поля конкретного инструмента приведены выше; наличие идентификатора не заменяет доступ к источнику.
Можно ли заменить ИНН организации совпадением названия?
Не подменяйте идентификатор похожим названием. Используйте поддерживаемые ИНН или ОГРН из описания инструмента и сопоставляйте полученную карточку с нужной организацией.
Как установить mcp-egrul?
В разделе «Установка» выберите свой клиент и используйте приведённую команду uvx atomno-mcp-egrul. Файл и структура настройки зависят от клиента; пошаговые инструкции доступны в разделе документации. Требуемая версия Python указана в метаданных пакета на PyPI.
Нужен ли MCP-клиент для собственного сайта или CRM?
Если данные получает код вашего бэкенда, используйте REST API доступного продукта. MCP подходит для агента в совместимом приложении. Состав источников и ограничения продукта не расширяются при смене способа подключения.
Это открытый код?
Да, mcp-egrul распространяется под лицензией MIT. Исходный код: https://github.com/atomno-mcp/mcp-egrul. Код можно скопировать и доработать под себя.
Где сообщить об ошибке?
Раздел Issues на GitHub: https://github.com/atomno-mcp/mcp-egrul/issues. Или напишите mcp@atomno.com.

Changelog

Текущая версия: v0.1.10. Полная история — GitHub Releases. Прежние формулировки витрины — в истории изменений сайта.

Правовая оговорка

Atomno MCP не аффилирован с ФНС России (egrul.nalog.ru). mcp-egrul использует публичные / коммерческие интерфейсы источника. Ответственность за соблюдение лимитов и условий использования источника — на пользователе. Лицензия: MIT.

Связанные задачи

Если реквизиты уже известны, можно перейти к ограниченной проверке российской организации по ИНН или ОГРН. Состав и даты источников проверяются отдельно.

Состав проверки и доступ уточняйте в документации.

Проверка контрагента

Открытое ядро

Ограниченная проверка российской организации по ИНН или ОГРН.

В составе проверки: ЕГРЮЛ, Санкционные списки. Отдельные покупки не нужны.

Просмотр кода

Копируется исходный текст. Переносы меняют только отображение.

Текст

Поиск по сайту

Введите хотя бы два символа.

Tab — переход по ссылкам · Esc — закрыть