Companies House MCP

Companies House CLI and MCP

Lee el registro público de Companies House del Reino Unido desde tu terminal, tus scripts o un asistente de IA. Busca empresas, lee sus registros, rastrea la propiedad, obtén presentaciones y descarga los documentos presentados.

Todo funciona con tu propia clave de API gratuita. Sin backend alojado, sin clave compartida, sin proxy: las solicitudes van directamente desde tu máquina a Companies House.

Documentación: companies-house.uk

Elige tu ruta

En un asistente de IA — Claude Code, Claude Desktop, Codex, Cursor, Zed:

npx -y companies-house-mcp

Configura COMPANIES_HOUSE_API_KEY en la configuración del cliente. Configuración completa para cada cliente: companies-house.uk/mcp.

En la terminal — el comando ch:

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

Referencia completa: companies-house.uk/cli.

En tu propio servidor — un Worker de Cloudflare opcional que despliegas en tu propia cuenta, para que Claude Code pueda acceder a él de forma remota. Consulta companies-house.uk/self-hosting, o la guía de despliegue.

Obtén una clave de API gratuita en developer.company-information.service.gov.uk. Tarda aproximadamente un minuto.

Lo que puedes hacer

Encontrar una empresa — search_companies / ch search por nombre, con filtros por estado, tipo, fecha de constitución, ubicación y código SIC. search_officers / ch search-officers encuentra personas en todo el registro.

Leer su registro — get_company_profile / ch profile para estado, direcciones, códigos SIC y fechas de presentación. get_charges, get_insolvency, get_company_registers, get_exemptions y get_uk_establishments para el resto.

Rastrear personas y propiedad — get_officers / ch officers para quién está en el cargo, get_appointments y officer_network para todos los cargos de una persona, get_ownership / ch ownership para personas con control significativo, y get_officer_disqualifications para el registro de directores inhabilitados.

Leer las presentaciones — get_filings / ch filings para el historial de presentaciones, get_filing_document para una presentación en detalle, y download_filing_document / ch document para el PDF presentado.

Obtener la imagen completa de una vez — company_report / ch report lee los registros principales en una sola llamada. due_diligence_check / ch check examina una empresa contra el registro e informa de las entradas que un revisor querría consultar.

Referencia completa de parámetros: companies-house.uk/tools.

Lo que esto no es

Companies House registra lo que las empresas presentan. Realiza controles básicos de integridad, pero no verifica que la información sea precisa.

Por lo tanto, nada aquí es una verificación, una comprobación de crédito, un cribado de sanciones o de personas políticamente expuestas, ni una decisión de autorización. due_diligence_check es un resumen de cribado: te indica lo que hay en el registro y lo que no pudo comprobar. Nunca concluye que una empresa sea sólida. La ausencia de entradas adversas significa que no se ha presentado nada adverso.

El registro tampoco cubre el rendimiento comercial, los litigios ni la propiedad efectiva mantenida fuera del régimen de personas con control significativo. La verificación de identidad de directores existentes y PSC (personas con control significativo) todavía se está implementando en virtud de la Ley de Delitos Económicos y Transparencia Corporativa, por lo que un nombre en el registro no significa que la persona detrás de él haya pasado una verificación de identidad.

Tu clave, tus datos

Tu clave de API permanece contigo. La CLI la lee de --key, luego de COMPANIES_HOUSE_API_KEY, y luego de ~/.config/companies-house/config.json, que se escribe con permisos exclusivos del propietario. ch config show muestra solo los últimos cuatro caracteres.

No se envía nada a ningún sitio excepto a Companies House. No hay telemetría.

Companies House permite 600 solicitudes por cada cinco minutos por clave. El cliente pone las solicitudes en cola para mantenerse dentro de ese límite, y si alcanza el límite, espera solo cuando Companies House indica que la ventana está a punto de restablecerse; de lo contrario, informa del límite en lugar de detenerse.

Los registros de oficiales incluyen direcciones de servicio y fechas de nacimiento tal como se publican en el registro público. Trátalos como los datos personales que son.

Desarrollo

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

Consulta CONTRIBUTING.md.

Aviso legal

No está afiliado ni respaldado por Companies House ni por el Gobierno del Reino Unido. Utiliza la API pública de Companies House.

Licencia

MIT