Companies House MCP

CLI e MCP do Companies House

Leia o registro público do Companies House do Reino Unido a partir do seu terminal, dos seus scripts ou de um assistente de IA. Pesquise empresas, leia seus registros, rastreie a propriedade, consulte arquivamentos e baixe os próprios documentos arquivados.

Tudo funciona com sua própria chave de API gratuita. Sem backend hospedado, sem chave compartilhada, sem proxy — as solicitações vão da sua máquina diretamente para o Companies House.

Documentação: companies-house.uk

Escolha seu caminho

Em um assistente de IA — Claude Code, Claude Desktop, Codex, Cursor, Zed:

npx -y companies-house-mcp

Defina COMPANIES_HOUSE_API_KEY na configuração do cliente. Configuração completa para cada cliente: companies-house.uk/mcp.

No terminal — o comando ch:

npm install -g companies-house-cli
ch config set-key your-key-here
ch report 00445790

Referência completa: companies-house.uk/cli.

No seu próprio servidor — um Cloudflare Worker opcional que você implanta na sua própria conta, para que o Claude Code possa acessá-lo remotamente. Consulte companies-house.uk/self-hosting ou o guia de implantação.

Obtenha uma chave de API gratuita em developer.company-information.service.gov.uk. Leva cerca de um minuto.

O que você pode fazer

Encontre uma empresa — search_companies / ch search por nome, com filtros para status, tipo, data de incorporação, localização e código SIC. search_officers / ch search-officers encontra pessoas em todo o registro.

Leia o registro — get_company_profile / ch profile para status, endereços, códigos SIC e datas de arquivamento. get_charges, get_insolvency, get_company_registers, get_exemptions e get_uk_establishments para o restante.

Rastreie pessoas e propriedade — get_officers / ch officers para quem está no cargo, get_appointments e officer_network para todos os lugares onde uma pessoa é nomeada, get_ownership / ch ownership para pessoas com controle significativo e get_officer_disqualifications para o registro de diretores desqualificados.

Leia os arquivamentos — get_filings / ch filings para o histórico de arquivamentos, get_filing_document para um arquivamento em detalhes e download_filing_document / ch document para o próprio PDF arquivado.

Obtenha o panorama completo de uma vez — company_report / ch report lê os registros principais em uma única chamada. due_diligence_check / ch check tria uma empresa contra o registro e relata as entradas que um revisor gostaria de examinar.

Referência completa de parâmetros: companies-house.uk/tools.

O que isto não é

O Companies House registra o que as empresas arquivam. Ele realiza verificações básicas de completude, mas não verifica se as informações são precisas.

Portanto, nada aqui é uma verificação, uma consulta de crédito, uma triagem de sanções ou de pessoas politicamente expostas, ou uma decisão de liberação. due_diligence_check é um resumo de triagem: informa o que está no registro e o que não pôde verificar. Nunca conclui que uma empresa é sólida. A ausência de entradas adversas significa que nada adverso foi arquivado.

O registro também não cobre desempenho comercial, litígios ou propriedade benéfica mantida fora do regime de pessoas com controle significativo. A verificação de identidade para diretores existentes e PSCs ainda está sendo implementada sob a Lei de Crime Econômico e Transparência Corporativa, portanto, um nome no registro não significa que a pessoa por trás dele passou por verificação de identidade.

Sua chave, seus dados

Sua chave de API permanece com você. A CLI a lê de --key, depois de COMPANIES_HOUSE_API_KEY, depois de ~/.config/companies-house/config.json, que é gravado com permissões somente do proprietário. ch config show imprime apenas os últimos quatro caracteres.

Nada é enviado a lugar algum, exceto ao Companies House. Não há telemetria.

O Companies House permite 600 solicitações a cada cinco minutos por chave. O cliente enfileira as solicitações para permanecer dentro desse limite e, se atingir o limite, espera apenas quando o Companies House diz que a janela está prestes a ser redefinida — caso contrário, relata o limite em vez de travar.

Os registros de diretores incluem endereços de serviço e datas de nascimento conforme publicados no registro público. Trate-os como os dados pessoais que são.

Desenvolvimento

git clone https://github.com/aicayzer/companies-house-mcp.git
cd companies-house-mcp
pnpm install && pnpm build && pnpm test:unit

Consulte CONTRIBUTING.md.

Aviso legal

Não afiliado ou endossado pelo Companies House ou pelo Governo do Reino Unido. Usa a API pública do Companies House.

Licença

MIT