Skillget

companies-house-mcp

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in packages/cli/package.json
  • network request — Outbound network request in packages/cli/src/api/client.ts
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This is an unofficial CLI and MCP server that provides an interface to the UK Companies House API. It allows users to search for companies, view profiles, trace officer networks, retrieve financial filings, and run automated due diligence checks directly from an AI client or terminal.

Security Assessment
The overall risk is Low. The tool requires you to supply your own free API key, meaning there are no hardcoded secrets or middleman backends. It does make expected outbound network requests exclusively to the official Companies House API to fetch the requested public data. The automated scanner flagged a recursive force deletion command (`rm -rf`) in the CLI package configuration. This is standard practice in the JavaScript ecosystem for cleaning build directories before compiling, and is not considered malicious. No dangerous system permissions are requested.

Quality Assessment
The project uses the standard MIT license and has seen very recent maintenance activity. It includes clear, comprehensive documentation. The primary concern is its low community visibility, having only 5 GitHub stars. Because it is a relatively new and untested project, it lacks the widespread community trust and peer review typically expected for enterprise-grade tools.

Verdict
Safe to use, though users should remember to handle their personal API keys securely.
SUMMARY

CLI and MCP server for the UK Companies House API — company search, profiles, officers, filings, ownership, and due diligence

README.md

Companies House CLI & MCP

npm: companies-house-cli
npm: companies-house-mcp
License: MIT

An unofficial CLI and MCP server for the UK Companies House API. Look up any UK company, check its officers, trace ownership, dig into filings, run a due diligence scan — from your terminal, your scripts, or directly inside Claude, Cursor, or any other AI tool that speaks MCP.

Everything runs on a free API key. No backend, no subscriptions, no middleman.

Documentation: companies-house.uk

Install

CLI — installs the ch binary:

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

MCP server — for Claude, Cursor, Zed, and others:

npx -y companies-house-mcp

Both packages use the same free API key from developer.company-information.service.gov.uk.

What it can do

Search and lookup

  • search_companies / ch search — find companies by name, with filters for status, type, SIC code, and location
  • search_officers / ch search-officers — find officers across all companies by name
  • get_company_profile / ch profile — full company profile: status, addresses, SIC codes, key dates

Officers and ownership

  • get_officers / ch officers — current and resigned directors, secretaries, and other officers
  • get_appointments — every company a given officer has ever been appointed to
  • get_ownership / ch ownership — persons with significant control (PSCs), corporate ownership chains

Filings and financials

  • get_filings / ch filings — full filing history with document links, filterable by category
  • get_filing_document — retrieve an individual filing document
  • get_charges / ch charges — charges and mortgages registered against the company
  • get_insolvency / ch insolvency — insolvency proceedings, liquidations, administrations

Due diligence

  • company_report / ch report — everything in one call: profile, officers, ownership, charges, filings, insolvency
  • due_diligence_check / ch check — automated red-flag scan with HIGH / MEDIUM / LOW severity ratings
  • officer_network / ch network — map a director's connections across every company they're linked to

Extended

  • get_company_registers — statutory registers (members, directors, secretaries, charges)
  • get_exemptions — disclosure exemptions
  • get_uk_establishments — UK establishments of overseas companies
  • get_officer_disqualifications — disqualification orders made against an officer

CLI quick reference

ch search "Anthropic"
ch profile 14604577
ch officers 14604577 --all
ch ownership 14604577
ch filings 14604577 --category accounts
ch charges 14604577
ch report 14604577
ch check 14604577
ch network "John Smith"
ch report 14604577 --json | jq '.profile.company_status'
ch report 14604577 --md > report.md

Full reference, flags, and output modes at companies-house.uk/cli.

MCP setup

Add to your client config with your API key and run npx -y companies-house-mcp. Detailed setup for Claude Desktop, Claude Code, Cursor, and Zed at companies-house.uk/mcp.

Development

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

See CONTRIBUTING.md for the full guide. Docs at companies-house.uk.

Disclaimer

Not affiliated with or endorsed by Companies House or the UK Government. Uses the publicly available Companies House API.

Licence

MIT

Reviews (0)

No results found