vdmeu/registrum-mcp

Возвращает несколько представлений одной британской компании в одном запросе: профиль, соответствие ECCTA, финансовые данные, PSC и директоров. Этот способ предпочтительнее вызова get_company, get_compliance, get_financials, get_psc и get_directors по отдельности: он возвращает те же данные за один вызов API и один кредит вместо пяти и за один цикл. Параметр include ограничивает выборку только нужными секциями; если его опустить, вернутся все пять. Профиль возвращается всегда. Частичные результаты нормальны и не считаются ошибками: любая секция может вернуться как null, когда она недоступна для этой компании или не входит в тарифный план вызывающей стороны: финансовые данные равны null для компании, которая не подала машиночитаемую отчетность, а соответствие ECCTA требует тарифа Pro. О нулевой секции нужно сообщать как о «недоступно», а не как о неудачном поиске или об отсутствии базового факта. Ошибка возникает только при отсутствии компании, и это 404. Каждая секция содержит ровно то, что возвращает ее собственный endpoint, включая verification_status ECCTA для физических лиц, поэтому правила различения статусов «ожидает» и «просрочено» применимы и здесь.

Получает обогащённый профиль британской компании по номеру Companies House. Возвращает название, статус, тип, дату регистрации, юридический адрес, коды SIC с описаниями, статус отчётности, статус confirmation statement и производные поля, которых нет в сыром API Companies House: company_age_years и accounts.overdue.

Проверяет статус верификации личности в рамках ECCTA для компании из Великобритании: кто уже подтвердил свою личность в Companies House, у кого статус ещё pending, а у кого срок просрочен. Закон об экономических преступлениях и корпоративной прозрачности (ECCTA) требует, чтобы каждый директор и лицо со значительным контролем (PSC) подтвердили свою личность; с 18 ноября 2026 года закон начнёт применяться принудительно, после чего непрошедшие верификацию должностные лица смогут блокировать подачу документов. Возвращает для каждой компании счётчики (directors_total, directors_verified, directors_pending, directors_overdue) и такие же для PSC, а также unverified_persons с именем, ролью, статусом и индивидуальным сроком каждого человека. ВАЖНО: 'pending' означает, что срок ещё не истёк. Это НЕ нарушение и не должно сообщаться как нарушение. Только 'overdue' означает, что срок был пропущен. Требуется тариф Pro или выше. Кэшируется в течение 24 часов.

Получает текущих и бывших должностных лиц для британской компании. Несмотря на название инструмента, не каждая запись является директором: список - полный реестр должностных лиц, поэтому каждая запись содержит officer_role, например 'director', 'secretary', 'corporate-secretary' или 'llp-member', а также булево значение is_board_director, которое равно false для секретарей. Сообщайте о каждом человеке по его собственному officer_role: никогда не описывайте весь список как directors. Каждое должностное лицо включает name, officer_role, is_board_director, appointment date, resignation date (если применимо), nationality, occupation, month and year of birth, ECCTA verification status, а также список других компаний, в которых они назначены или были назначены, каждая со своим officer_role. Это дает вам полную картину корпоративной истории должностного лица за один вызов.

Возвращает структурированные финансовые данные по британской компании, извлечённые из её iXBRL-отчётности, поданной в Companies House. Включает выручку, себестоимость продаж, валовую прибыль, операционную прибыль, чистую прибыль, основные средства, оборотные активы, общий капитал, чистые активы, кредиторскую задолженность и среднюю численность сотрудников за текущий и предыдущий отчётный год. Также содержит тип отчётности (full/abbreviated/micro/dormant) и блок data_quality, указывающий, какие поля были извлечены, а какие отсутствовали в поданной отчётности. Кэшируется на 7 дней.

Строит карту корпоративной сети, связанной с британской компанией через общих директоров. Возвращает все компании, связанные через общих членов совета директоров, до указанной глубины. Каждая связанная компания включает её название, номер, статус и директоров, общих с исходной компанией. Полезно для выявления структур корпоративных групп, отношений связанных сторон и перекрёстных связей директоров.

Получает реестр PSC (лиц со значительным контролем) для британской компании. Возвращает физических лиц, корпоративные организации и юридических лиц, которые владеют 25%+ акций, имеют 25%+ голосующих прав или обладают значительным влиянием или контролем. Каждая запись PSC включает расшифрованные типы контроля на простом английском (например, 'Owns 25-50% of shares' вместо сырых кодов). Индивидуальные записи PSC также содержат проверку личности по ECCTA: verification_status (verified, pending, overdue или unknown), identity_verified, identity_verified_on и verification_deadline. Поле pending означает, что срок для этого лица ещё не истёк, и это не нарушение; unknown означает, что Companies House не публикует запись о таком лице, это отсутствие данных, а не нарушение. Только overdue означает, что срок был пропущен. Записи PSC для корпоративных организаций включают номер компании для обхода цепочки владения и не содержат полей проверки. Также определяет освобождения от PSC для листинговых PLC. Кэшируется на 24 часа.

Прослеживает полную цепочку владения для британской компании, рекурсивно переходя по PSC корпоративных организаций. Возвращает дерево, показывающее, кто в конечном счёте контролирует компанию: физические лица (UBO), иностранные организации или юридические лица, а также причину завершения каждой ветви. Каждый узел содержит terminal_reason: natural_person, foreign_entity, legal_person, super_secure, unverified_registry, unknown_kind, depth_limit, not_found, cycle_detected или psc_exempt. Два значения легко перепутать: unverified_registry означает, что регистрационный номер был указан, но его нельзя привязать к реестру Companies House (иностранный реестр или реестр, который мы не распознаём); это вывод о структуре владения, а не ошибка или сбой. unknown_kind означает, что Companies House вернул тип PSC, который мы не классифицируем; исходное значение находится в поле kind_raw. Проверка личности по ECCTA: каждый узел, соответствующий физическому лицу, на любой глубине, включая конечных бенефициарных владельцев, для установления которых построена эта цепочка, содержит поля verification_status (verified, pending, overdue или unknown), identity_verified (true, false только при статусе overdue, в остальных случаях null), identity_verified_on и verification_deadline. ВАЖНО: статус pending означает, что собственный срок этого лица ещё не истёк; это не нарушение требований, и его нельзя указывать как нарушение. Статус unknown означает, что Companies House не публикует записей об этом человеке; это отсутствие данных, а не нарушение. Только статус overdue означает, что срок был пропущен. Узлы корпораций, юридических лиц и узлы super-secure не содержат ни одного из этих полей, поэтому никогда не описывайте саму компанию как имеющую неподтверждённую личность. chain_metadata сообщает, сколько компаний было обработано, и общую стоимость в API-кредитах. Используйте его для проверок KYB (Know Your Business), AML-скрининга или любых задач, требующих сведений о бенефициарной собственности за пределами непосредственного слоя PSC.

Поиск компаний Великобритании по названию. Возвращает список подходящих компаний с их регистрационным номером, статусом, типом и зарегистрированным адресом. Используйте этот инструмент в первую очередь, если у вас есть только название компании и нужен её регистрационный номер.