# companies-house [Health: Active]

**Category:** ⚖️ Legal  
**Repository:** https://github.com/aicayzer/companies-house-mcp  
**GitHub Stars:** 39  
**npm Downloads (last month):** 5148  
**Views:** 7  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/companies-house

## Description
MCP server and CLI for the UK Companies House API. Search, filings, officers, due diligence.

## Tools
Capabilities this server exposes over MCP:

- **company_report** — Read the main Companies House records for one company in a single call: profile, officers currently in post, persons with significant control, charges, the most recent filings and any insolvency record. The report states how much of each list it retrieved and what the register does not cover. Use this as the starting point for company research, then use the individual tools for anything the report shows is incomplete.
- **download_filing_document** — Retrieve the document filed for a Companies House filing and return it to you directly — PDF and other binary formats as an embedded binary resource, XHTML, XML and JSON as text. Reads the document metadata first, so it reports the available formats, page count and exact size, and refuses oversized content before transferring it. Get the document id from get_filings. Set metadata_only to inspect a document without retrieving it. The document is returned to you; this tool does not write files.
- **due_diligence_check** — Screen one company against what is recorded on the Companies House public register and report the entries a reviewer would want to look at: register status and status detail, insolvency records, outstanding charges, overdue accounts and confirmation statements, registered office disputes, officer changes, ownership records and company age. It reports observations drawn from filed data, together with the checks it ran and the checks it could not run. It is not a verification, credit check, sanctions or politically-exposed-person screening, or a clearance decision, and it never concludes that a company is sound.
- **get_appointments** — List every company appointment held by one officer id, current and past, with the company name, number, status, role and dates. An officer id identifies one person as recorded by Companies House; the same individual can hold more than one id if their details were filed differently. Use search_officers to obtain the id.
- **get_charges** — List the charges — mortgages, debentures and other security — registered against a UK company, with the persons entitled, creation and delivery dates, particulars and satisfaction status. Outstanding, part-satisfied and satisfied totals come from Companies House aggregate counts, so they stay correct even when the list is longer than one page. A registered charge records that security was granted; it says nothing about the current balance owed.
- **get_company_profile** — Read the Companies House register entry for one UK company: registered name, number, status and status detail, company type, incorporation date, registered office address, SIC codes, accounts and confirmation statement dates, and previous names. Use search_companies first if you only know the name.
- **get_company_registers** — Report where a company keeps its statutory registers of directors, secretaries, members and PSCs — at Companies House or at its own address. Companies House holds no register record for most companies, which the response reports as an absence rather than an error.
- **get_exemptions** — List the disclosure exemptions recorded for a UK company, with the dates each applies from and to. The most common is exemption from the persons-with-significant-control requirements for companies whose shares trade on a regulated market. Most companies have none.
- **get_filing_document** — Read the full detail of one filing by its transaction id: description, date, category, type, page count and the document id needed to retrieve the document itself. This returns the filing record, not the filed document — use download_filing_document for the document.
- **get_filings** — Read a company's filing history: accounts, confirmation statements, officer changes, charge registrations, resolutions and everything else it has filed. Each entry carries a transaction id and, where a scanned or rendered document exists, a document id. Pass that document id to download_filing_document to retrieve the document itself.
- **get_insolvency** — Read the insolvency record for a UK company: cases, case type, key dates, appointed practitioners and notes. Companies House returns no record for a company that has never been subject to insolvency proceedings, which the response reports as an absence rather than an error.
- **get_officer_disqualifications** — Look up an officer id in the Companies House register of disqualified directors and return any disqualification with its dates, statutory reason, court and the companies named. An empty result means no disqualification is recorded against that officer id — it is not a confirmation that the person has never been disqualified, since the same individual can appear under more than one id.
- **get_officers** — List a company's officers — directors, secretaries, LLP members and equivalents — with role, appointment date, resignation date, nationality, occupation and service address. Returns officers currently in post by default. Companies House offers no general server-side filter for officers still in post, so requesting them pages through the list until every one has been found; the response states how much of the register was read.
- **get_ownership** — List the persons with significant control (PSCs) recorded for a UK company — the individuals, corporate entities and legal persons that own or control it — with natures of control, notified date and ceased date. Ceased PSCs stay on the register and are returned alongside current ones, clearly marked. When no PSC is recorded the response explains why, distinguishing a market-listing exemption or a filed statement from a genuine gap.
- **get_uk_establishments** — List the UK establishments registered by an overseas company — its UK branches, each with its own company number and status. Applies to overseas companies, typically those with an FC-prefixed number; UK-incorporated companies have none.
- **officer_network** — Map every company one officer id is or was appointed to, split into current and past appointments with each company's status. Pages through the full appointment list rather than showing only the first page. Prefer officer_id: a name is only accepted when it matches exactly one officer, because officer names are not unique and picking the wrong match produces a confidently wrong network. Appointments are grouped by Companies House officer id, so one individual may hold more than one.
- **search_companies** — Find UK companies by name and return their company numbers. Supplying any of the status, type, incorporation date, location or SIC filters switches to the advanced search endpoint. This is a name lookup, not a bulk export: narrow the query rather than paging deeply.
- **search_officers** — Find company officers by name across the whole UK register. Returns each match with its officer id, service address, month and year of birth where published, and total appointment count. Use the officer id with get_appointments or officer_network. Names are not unique — check the birth date and address before treating two results as the same person.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "companies-house": {
    "command": "npx",
    "args": ["-y","companies-house-mcp"],
    "env": {
      "COMPANIES_HOUSE_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `COMPANIES_HOUSE_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What companies-house MCP server does

The companies-house MCP server gives AI assistants access to the UK Companies House public register through MCP tools. It can locate companies and officers, retrieve company records, inspect appointments and persons with significant control, review filing history, and obtain filed documents. A combined report tool gathers the main records for a company in one request, while a due-diligence tool produces a register-based screening summary.

The service is also available as a command-line package, but the MCP route is intended for use from supported AI clients. Requests use the caller's Companies House API key and go directly from the local environment to Companies House.

## How it works

Run the MCP package with `npx -y companies-house-mcp` and configure `COMPANIES_HOUSE_API_KEY` in the client. The server calls the Companies House API rather than routing data through a hosted intermediary. Companies House permits 600 requests per five-minute period per key; the client queues requests within that allowance and reports a limit when it cannot safely wait for the reset window.

The companies-house MCP server does not provide an independent data source or verification layer. It exposes information filed on the public register, including published officer service addresses and dates of birth, so applications should handle that information as personal data.

## Setup and configuration

Create a free API key through the Companies House developer portal, then add it to the MCP client's environment or configuration. The README specifically lists Claude Code, Claude Desktop, Codex, Cursor and Zed as client routes and provides client-specific setup instructions on the project's documentation site.

The repository can also be built locally with pnpm after cloning. The documented development sequence installs dependencies, builds the project and runs unit tests. An optional Cloudflare Worker can be deployed into the user's own account for remote access, but that is separate from the local MCP process.

## Tools and capabilities

Available operations cover the following areas:

- Search companies by name, with filters for status, type, incorporation date, location and SIC code.
- Search officers across the register.
- Retrieve company profiles, charges, insolvency information, registers, exemptions and UK establishments.
- List current officers, inspect officer appointments and map an officer's wider appointment network.
- Find persons with significant control and officer disqualifications.
- Read filing history, inspect an individual filing and download the filed PDF.
- Generate a company report or run a due-diligence screening check.

## Limitations and notes

The companies-house MCP server reflects what companies file; Companies House performs basic completeness checks but does not establish that the information is accurate. Its due-diligence operation is a screening summary, not a credit check, sanctions or politically exposed person check, identity verification, or clearance decision.

The register does not cover trading performance, litigation or beneficial ownership outside the persons-with-significant-control rules. An absence of adverse entries means only that no relevant adverse entry was filed or identified by the available checks. The project is not affiliated with or endorsed by Companies House or the UK Government.

_Full upstream README: https://allmcps.com/mcp/companies-house/readme_