Legal Entity Resolver

Resolve um domínio de empresa para sua entidade legal registrada e retorna o número da empresa, número de IVA e endereço registrado.

Documentação

Servidor MCP Legal Entity Resolver

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

Servidor MCP para o ator Legal Entity Resolver da Mamba Labs no Apify.

Forneça um domínio de empresa e ele retorna a entidade legal registrada por trás dele: nome legal, número da empresa, jurisdição, status, LEI e número de IVA. Uma linha plana por domínio, 24 campos, pronto para Clay ou um CRM.

Instalação

npx -y @mambalabsdev/mcp-legal-entity-resolver

Claude Desktop

{
  "mcpServers": {
    "mamba-legal-entity-resolver": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-legal-entity-resolver"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

Obtenha um token do Apify em console.apify.com/account/integrations.

Ferramenta

resolve_legal_entity

Domínio da empresa na entrada, a entidade legal registrada por trás dele na saída.

EntradaTipoObrigatórioObservações
domainstringsimUm único domínio de empresa, por exemplo monzo.com. Protocolo e caminho são removidos.
legal_name_hintstringnãoIgnora a consulta de domínio e vai direto aos registros com este nome. Use quando você já tem o nome legal e só quer o registro.
jurisdiction_hintstringnãoCódigo de país ISO-2. GB/UK consulta a Companies House, US consulta a SEC EDGAR, FR consulta o registro francês Sirene (SIREN), NO consulta o registro norueguês Brreg (organisasjonsnummer). Cada um consulta a GLEIF em paralelo. Qualquer outro código consulta apenas a GLEIF. Deixe vazio para consultar todos os cinco.
match_strictnessenumnãoexact aceita um registro apenas quando os nomes legais normalizados são iguais. fuzzy retorna o melhor candidato pontuado com confiança abaixo de 100 e um aviso em rejected_candidates. Padrão exact.
validate_vatbooleannãoExecuta qualquer número de IVA encontrado nas páginas da própria empresa pelo serviço VIES da UE e retorna o nome que a VIES possui para ele, como uma verificação cruzada em relação ao nome do registro. Padrão true.
skipCacheenumnãofalse usa o cache, 90 dias para uma empresa resolvida e 7 dias para um nulo. true força uma nova consulta. Padrão false.

Um nulo é o produto, não uma lacuna

Os endpoints de busca de registros são imprecisos e sempre retornam algo. Pegar o melhor resultado da busca dá a você um número de empresa errado com confiança mais vezes do que não. Este ator aceita uma correspondência apenas quando os nomes legais são idênticos após a normalização, e é por isso que aproximadamente 6 domínios em 10 são resolvidos em vez de 10 em 10, e por que os 6 valem a pena agir.

Leia match_method, match_confidence e rejected_candidates antes de agir com base em uma correspondência. A rigidez de fuzzy é um modo de pesquisa: ela entregará a você uma empresa errada com confiança na maioria dos domínios.

Três registros são consultados: UK Companies House, GLEIF e SEC EDGAR.

Cobrança

Você é cobrado por domínio resolvido, mais o evento de início do ator da plataforma. Preços do registro de preços ao vivo, lidos em 2026-10-05:

EventoPreço por evento (USD)Disparado quando
domain-resolved$0,007 no plano Free, até $0,00595 em planos Apify superioresUm domínio consultado: as páginas da própria empresa são buscadas e lidas para um nome legal, e então até três registros de empresas são consultados para uma correspondência exata. Cobrado independentemente de um registro corresponder, porque o trabalho é o mesmo de qualquer forma e cobrar apenas por correspondências empurraria este Ator para adivinhar. Não cobrado quando o domínio não pode ser alcançado de forma alguma.
apify-actor-start$0,00005Cobrado quando o Ator começa a rodar. O número de eventos cobrados depende da memória do Ator (um evento por GB, mínimo um evento).

Resultados em cache são 90 dias para uma empresa resolvida e 7 dias para um nulo. A página do ator no Apify traz os preços atuais. Executar este servidor consome créditos do Apify.

O que este servidor faz e não faz

É um cliente leve para o ator do Apify. Ele passa sua entrada adiante e retorna a saída do ator inalterada. Todo comportamento descrito acima vive no ator, não aqui.

Isto não é um banco de dados de empresas e não é um produto de crédito ou risco. Não pontua empresas, não as classifica, nem diz se você deve negociar com elas. Responde a uma pergunta: qual entidade legal registrada está por trás deste domínio.

Erros são expostos, nunca engolidos. Uma entrada inválida, um token inválido, um saldo esgotado, um tempo limite ou uma execução que retorna qualquer coisa que não seja um conjunto de dados voltam como um erro explícito de ferramenta em vez de um resultado vazio.

Como cada chamada é executada

Cada chamada inicia a execução do ator, faz polling até que termine e então lê o conjunto de dados. A execução tem permissão de 1.800 segundos. Se a execução ainda estiver em andamento quando esta chamada parar de esperar, a chamada retorna o id da execução e um link de console em vez de um tempo limite, para que o resultado nunca seja perdido.

Fonte

O ator está na Apify Store. Este wrapper é licenciado sob MIT.

Construído por Mamba Labs