Вкратце
Российские реквизиты организации по ИНН или ОГРН. Источник отдельного клиента не подключён; сведения пакета контрагента имеют свои границы.
Пример в чате
Учебный пример, не живой ответ. Размещённый доступ к этому составу данных не подтверждён (реквизиты по ИНН 7707083893 — демо-данные, не живой ответ).
Источник данных:ФНС России (egrul.nalog.ru) . Atomno MCP не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
В терминале (Claude Code CLI):
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
Конфигурация (переменные окружения)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| MCP_EGRUL_TOKEN | API token для Pro tier (hosted) | Отдельный размещённый доступ не подтверждён; см. ограничения выше | no | — |
| MCP_EGRUL_LOG_LEVEL | Уровень логирования | — | no | INFO |
Инструменты MCP-сервера
Сервер регистрирует 4инструмента для AI-агента. Все входные данные строго проверяются.
Ниже — описанные в документации инструменты. Их наличие не подтверждает успешный вызов или доступ к источнику.
get_company async tool Полные реквизиты юрлица по ИНН или ОГРН.
identifier: str (ИНН или ОГРН) Company { inn, ogrn, kpp, name, status, address, founders[], directors[], okveds[] } search_companies async tool Поиск юрлиц по названию или фрагменту реквизитов.
query: str, limit?: int list[CompanyShort] get_director_history async tool История смены директоров (Pro).
inn: str list[DirectorRecord] get_founders async tool Учредители юрлица с долями.
inn: str 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?
Нужен ли MCP-клиент для собственного сайта или CRM?
Это открытый код?
Где сообщить об ошибке?
Changelog
Текущая версия: v0.1.10. Полная история — GitHub Releases. Прежние формулировки витрины — в истории изменений сайта.
Исходный код и задачи
- GitHub: atomno-mcp/mcp-egrul
- PyPI: atomno-mcp-egrul
- Issues: atomno-mcp/mcp-egrul/issues
Правовая оговорка
Atomno MCP не аффилирован с ФНС России (egrul.nalog.ru). mcp-egrul использует публичные / коммерческие интерфейсы источника. Ответственность за соблюдение лимитов и условий использования источника — на пользователе. Лицензия: MIT.
