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. Возвращает выручку, себестоимость продаж, валовую прибыль, операционную прибыль, чистую прибыль, основные средства, оборотные активы, совокупный капитал, чистые активы, кредиторскую задолженность и среднесписочную численность сотрудников за текущий и предыдущий отчётный год. Также включает accounts_type (full, abbreviated, micro, dormant или unknown) и блок data_quality, который показывает, какие поля удалось извлечь, а какие отсутствовали. period_end - это конец отчётного периода, который покрывают цифры (год, на котором заканчивается отчётность), а НЕ дата подачи отчётности; дата подачи - это data_quality.filed_on. Другие поля data_quality: filing_type (код формы Companies House: AA, AAMD или AC(NI)), period_end_source и accounts_type_source (как определили эти два значения) и accounts_description_code (дословный код Companies House, например unaudited-abridged, micro-entity). Отчётность типа unaudited-abridged, small и audit-exemption-subsidiary относится к abbreviated, а не к full, и не содержит отчёта о прибылях и убытках (проверьте has_profit_loss). accounts_type принимает значение unknown, когда определить его не удалось; не считайте, что это full. Ответ может прийти с available: false и unavailable_reason: image_pdf (отчётность подана в виде отсканированного PDF, частое явление для крупных компаний вроде Tesco), no_ixbrl_filings (нет цифровой подачи) или dissolved. Это значит, что извлечь цифры не удалось; это не значит, что у компании нет отчётности. Кэшируется на 7 дней.

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

Получает реестр PSC (Persons with Significant Control) для компании из Великобритании. Возвращает физлиц, корпоративные структуры и юридических лиц, которым принадлежит 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-юрлиц ни одного из этих полей проверки нет. Их company_number заполняется только при подтверждённой регистрации в Companies House, в остальных случаях он null, так что никогда не воспринимайте null как пропущенное значение, которое нужно искать. То, что они указали, лежит в registry_number и registry_name, а registry_is_companies_house подсказывает, как это читать: true - регистрация в Companies House, null - номер был указан, но его нельзя привязать к британскому реестру (например, иностранный реестр), false - номер не указывался. kind может быть unknown для типа PSC, который мы не классифицируем, а дословная строка от Companies House лежит в kind_raw. Также определяет исключения 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 неизвестен), а исходное значение лежит в kind_raw. И то и другое - находки, а не ошибки. У корпоративного узла company_number заполняется только для подтверждённой регистрации в Companies House, иначе null; номер, который был подан, лежит в registry_number вместе с registry_name, а registry_is_companies_house равен true (Companies House), null (номер подан, но его нельзя привязать к британскому реестру) или false (номер не подавался). Проверка личности по 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 сообщает, сколько компаний…

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