Summary
Plugs Claude directly into the UK Companies House API with your free government key. You get search across 5+ million companies and officers, full profile lookups, filing history with document retrieval, PSC ownership chains, charge registers, insolvency records, and officer appointment networks. The due diligence check runs automated red flag scans with severity ratings. Also ships as a standalone CLI if you want the same tooling in your terminal. Useful for compliance work, investor research, supplier vetting, or any workflow where you need to pull UK corporate data without leaving your editor.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
22 tools
search_companiesFind UK companies by name using the Companies House search engine. Returns matches with company number, name, current status, incorporation date, and registered office. Call this first when the user mentions a company by name — the returned company_number is the key required b...2 params
Find UK companies by name using the Companies House search engine. Returns matches with company number, name, current status, incorporation date, and registered office. Call this first when the user mentions a company by name — the returned company_number is the key required b...
Parameters* required
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
search_officersFind company officers (directors, secretaries, LLP members) by name. Returns matches with an opaque officer_id, the officer's name, and a sample appointment. Call this when the user asks about an individual by name; the returned officer_id feeds ``get_officer_appointments`` to...2 params
Find company officers (directors, secretaries, LLP members) by name. Returns matches with an opaque officer_id, the officer's name, and a sample appointment. Call this when the user asks about an individual by name; the returned officer_id feeds ``get_officer_appointments`` to...
Parameters* required
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
search_disqualified_officersFind officers on the public register of disqualified UK company directors. Use this to check whether a named person has been banned from acting as a director. The returned officer_id can be passed to ``get_natural_officer_disqualification`` (for humans) or ``get_corporate_offi...2 params
Find officers on the public register of disqualified UK company directors. Use this to check whether a named person has been banned from acting as a director. The returned officer_id can be passed to ``get_natural_officer_disqualification`` (for humans) or ``get_corporate_offi...
Parameters* required
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
alphabetical_companies_searchBrowse UK companies alphabetically starting from a given name prefix. Results are ordered by company name, not by relevance. Prefer ``search_companies`` for fuzzy/ranked matching; use this only when the user explicitly wants alphabetical ordering (e.g. "list companies starting...2 params
Browse UK companies alphabetically starting from a given name prefix. Results are ordered by company name, not by relevance. Prefer ``search_companies`` for fuzzy/ranked matching; use this only when the user explicitly wants alphabetical ordering (e.g. "list companies starting...
Parameters* required
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
search_dissolved_companiesFind companies that have been dissolved (no longer on the live register) by name. Returns matches with company number, previous names, and dates of incorporation and dissolution. Use this when the user is researching a company that may have been struck off or liquidated. For c...2 params
Find companies that have been dissolved (no longer on the live register) by name. Returns matches with company number, previous names, and dates of incorporation and dissolution. Use this when the user is researching a company that may have been struck off or liquidated. For c...
Parameters* required
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
advanced_company_searchSearch UK companies with structured filters (name tokens, status, type, SIC, location). Prefer this over ``search_companies`` when the user wants to narrow by multiple criteria (e.g. "active PLCs in Manchester with SIC 62020"). All filters are optional; at least one filter sho...7 params
Search UK companies with structured filters (name tokens, status, type, SIC, location). Prefer this over ``search_companies`` when the user wants to narrow by multiple criteria (e.g. "active PLCs in Manchester with SIC 62020"). All filters are optional; at least one filter sho...
Parameters* required
company_name_excludesvalueSubstring that must NOT appear in the company name.
company_name_includesvalueSubstring that must appear in the company name.
company_statusvalueFilter by registration status. Valid values include: 'active', 'dissolved', 'liquidation', 'receivership', 'administration', 'voluntary-arrangement', 'converted-closed', 'insolvency-proceedings', '...
company_typevalueFilter by company type. Common values: 'ltd' (private limited), 'plc' (public limited), 'llp' (limited liability partnership), 'charitable-incorporated-organisation', 'community-interest-company',...
locationvalueFilter by registered office locality. Free-text match against the registered office locality field (typically a town or city).
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
sic_codesvalueFilter by UK SIC 2007 industry classification codes. Pass a list of 5-digit codes as strings (e.g. ['62020', '62090'] for IT consulting).
get_company_profileFetch the full Companies House profile for a UK company. Returns registered name, status, company type, incorporation/dissolution dates, registered office, accounting reference dates, SIC codes, and previous names. This is usually the first call after you have a company_number...1 params
Fetch the full Companies House profile for a UK company. Returns registered name, status, company type, incorporation/dissolution dates, registered office, accounting reference dates, SIC codes, and previous names. This is usually the first call after you have a company_number...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
get_company_registersReport where a company holds each of its statutory registers. Indicates, per register type (directors, secretaries, members, PSCs, LLP members, usual residential addresses), whether the register is kept at Companies House or at the company's Single Alternative Inspection Locat...1 params
Report where a company holds each of its statutory registers. Indicates, per register type (directors, secretaries, members, PSCs, LLP members, usual residential addresses), whether the register is kept at Companies House or at the company's Single Alternative Inspection Locat...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
get_company_uk_establishmentsList UK establishments (branches) of an overseas-incorporated company. Only applies to overseas companies (``company_type`` = ``oversea-company``) that have registered one or more establishments in the UK. Returns ``None`` for purely UK-incorporated companies.1 params
List UK establishments (branches) of an overseas-incorporated company. Only applies to overseas companies (``company_type`` = ``oversea-company``) that have registered one or more establishments in the UK. Returns ``None`` for purely UK-incorporated companies.
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
get_officer_listList the officers currently or formerly appointed at a specific company. Covers directors, secretaries, and LLP members. Each entry carries an ``appointment_id`` (scoped to this company) and an ``officer_id`` (the person's global identifier) that can be passed to ``get_officer...2 params
List the officers currently or formerly appointed at a specific company. Covers directors, secretaries, and LLP members. Each entry carries an ``appointment_id`` (scoped to this company) and an ``officer_id`` (the person's global identifier) that can be passed to ``get_officer...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
get_officer_appointmentsList every company appointment (current and past) held by a given officer. Use this after ``search_officers`` or ``get_officer_list`` to see the full directorship history of a person across the entire UK register. Each entry includes the company number, the role, and appointme...2 params
List every company appointment (current and past) held by a given officer. Use this after ``search_officers`` or ``get_officer_list`` to see the full directorship history of a person across the entire UK register. Each entry includes the company number, the role, and appointme...
Parameters* required
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
officer_idstringOpaque Companies House officer identifier (a URL-safe base64 string). Copy from the ``refs.officer_id`` field of a ``search_officers`` hit, a ``get_officer_list`` item, or a ``search_disqualified_o...
get_officer_disqualificationFetch the full disqualification order for an officer. One tool covers both disqualification variants: - ``natural-disqualification`` for human directors — returns reasons, date ranges, nationality, any permission-to-act grants, and prior variations. - ``corporate-disqualificat...2 params
Fetch the full disqualification order for an officer. One tool covers both disqualification variants: - ``natural-disqualification`` for human directors — returns reasons, date ranges, nationality, any permission-to-act grants, and prior variations. - ``corporate-disqualificat...
Parameters* required
kindstringWhether the disqualified officer is a natural person (human) or a corporate body. ``search_disqualified_officers`` items distinguish these via their ``date_of_birth`` field (present only for natura...one of
natural-disqualification · corporate-disqualificationofficer_idstringOpaque Companies House officer identifier (a URL-safe base64 string). Copy from the ``refs.officer_id`` field of a ``search_officers`` hit, a ``get_officer_list`` item, or a ``search_disqualified_o...
get_company_psc_listList the persons with significant control (PSCs) declared for a company. PSCs are the individuals or entities that ultimately own or control the company (typically >25% of shares, >25% of voting rights, or right to appoint directors). Each entry's ``kind`` field indicates the...2 params
List the persons with significant control (PSCs) declared for a company. PSCs are the individuals or entities that ultimately own or control the company (typically >25% of shares, >25% of voting rights, or right to appoint directors). Each entry's ``kind`` field indicates the...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
get_company_psc_statementsList PSC statements recorded against a company. Statements are formal declarations about PSC status rather than concrete PSCs (e.g. "the company has no registrable person with significant control", "investigation ongoing"). Complements ``get_company_psc_list`` — a company may...2 params
List PSC statements recorded against a company. Statements are formal declarations about PSC status rather than concrete PSCs (e.g. "the company has no registrable person with significant control", "investigation ongoing"). Complements ``get_company_psc_list`` — a company may...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
get_company_pscFetch the full record for a single person with significant control (PSC). This single tool covers every PSC variant (individual, corporate-entity, legal-person, super-secure, plus their beneficial-owner counterparts). Dispatch is driven by the ``kind`` argument — **copy it str...3 params
Fetch the full record for a single person with significant control (PSC). This single tool covers every PSC variant (individual, corporate-entity, legal-person, super-secure, plus their beneficial-owner counterparts). Dispatch is driven by the ``kind`` argument — **copy it str...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
kindstringThe kind of PSC to fetch. Copy the value straight from the ``kind`` field of the corresponding ``get_company_psc_list`` item — it is one of the eight literal values listed.one of
individual-person-with-significant-control · individual-beneficial-owner · corporate-entity-person-with-significant-control · corporate-entity-beneficial-owner · legal-person-person-with-significant-control · legal-person-beneficial-ownerpsc_idstringOpaque PSC notification identifier. Copy from the ``refs.psc_id`` field of the matching ``get_company_psc_list`` item.
get_company_chargesList all registered charges (security interests over assets) for a company. A charge is a form of security granted to a lender against company assets (mortgages, debentures, fixed/floating charges). Use when assessing the company's debt exposure or encumbrances. Returns ``None...1 params
List all registered charges (security interests over assets) for a company. A charge is a form of security granted to a lender against company assets (mortgages, debentures, fixed/floating charges). Use when assessing the company's debt exposure or encumbrances. Returns ``None...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
get_company_charge_detailsFetch full details of a single charge registered against a company. Returns the charge's classification, particulars, secured details, persons entitled, transactions (creation, amendment, satisfaction), and any associated insolvency cases. Use after ``get_company_charges`` wit...2 params
Fetch full details of a single charge registered against a company. Returns the charge's classification, particulars, secured details, persons entitled, transactions (creation, amendment, satisfaction), and any associated insolvency cases. Use after ``get_company_charges`` wit...
Parameters* required
charge_idstringCompanies House charge identifier. Copy from the ``refs.charge_id`` field of the matching ``get_company_charges`` item.
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
get_company_filing_historyList a company's filing history — every document submitted to Companies House. Covers the full statutory history: incorporation, accounts, confirmation statements (formerly annual returns), officer appointments and resignations, address changes, share capital changes, resoluti...2 params
List a company's filing history — every document submitted to Companies House. Covers the full statutory history: incorporation, accounts, confirmation statements (formerly annual returns), officer appointments and resignations, address changes, share capital changes, resoluti...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
next_page_tokenvalueOpaque cursor from a previous page's pagination.next_page. Omit on the first call; pass the previous response's token to fetch the next page.
get_company_insolvencyFetch insolvency proceedings (liquidation, administration, CVA, etc.) for a company. Returns ``None`` for the vast majority of companies. Populated when the company has been or is subject to formal insolvency: liquidation, receivership, administration, company voluntary arrang...1 params
Fetch insolvency proceedings (liquidation, administration, CVA, etc.) for a company. Returns ``None`` for the vast majority of companies. Populated when the company has been or is subject to formal insolvency: liquidation, receivership, administration, company voluntary arrang...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
get_company_exemptionsFetch any exemptions granted to a company from certain filing requirements. Exemptions typically apply to PSC-register obligations for companies whose shares are admitted to trading on certain regulated markets, or to disclosure-and-transparency-rules exemptions. Returns ``Non...1 params
Fetch any exemptions granted to a company from certain filing requirements. Exemptions typically apply to PSC-register obligations for companies whose shares are admitted to trading on certain regulated markets, or to disclosure-and-transparency-rules exemptions. Returns ``Non...
Parameters* required
company_numberstringUK company number assigned by Companies House. 1-10 alphanumeric characters, typically 8 digits, possibly with an alpha prefix (e.g. 'SC' for Scotland, 'NI' for Northern Ireland, 'OC' for an LLP)....
get_document_metadataFetch metadata for a single filed document (PDF, JSON, XML, …). Returns the document's identifiers, page count, filename, filing category, and a ``resources`` map keyed by MIME type showing the content-length and timestamps for each representation the API can serve. Use the ma...1 params
Fetch metadata for a single filed document (PDF, JSON, XML, …). Returns the document's identifiers, page count, filename, filing category, and a ``resources`` map keyed by MIME type showing the content-length and timestamps for each representation the API can serve. Use the ma...
Parameters* required
document_idstringCompanies House document identifier. Copy from the ``refs.document_id`` field of a ``get_company_filing_history`` item. Only populated when the filing has a downloadable document attached.
get_document_contentReturn a downloadable URL for a single filed Companies House document. The tool itself does not transfer bytes — it returns a short-lived HTTP URL (~10 minutes) pointing at this server's own ``/documents/{signed_token}`` route. Fetching the URL streams the raw document with th...2 params
Return a downloadable URL for a single filed Companies House document. The tool itself does not transfer bytes — it returns a short-lived HTTP URL (~10 minutes) pointing at this server's own ``/documents/{signed_token}`` route. Fetching the URL streams the raw document with th...
Parameters* required
content_typestringMIME type of the document representation to download. The Companies House API advertises: 'application/pdf', 'application/json', 'application/xml', 'application/xhtml+xml', 'application/zip', 'text...default: application/pdf
document_idstringCompanies House document identifier. Copy from the ``refs.document_id`` field of a ``get_company_filing_history`` item. Only populated when the filing has a downloadable document attached.
Companies House CLI and MCP
Read the UK Companies House public register from your terminal, your scripts, or an AI assistant. Search companies, read their records, trace ownership, pull filings and download the filed documents themselves.
Everything runs on your own free API key. No hosted backend, no shared key, no proxy — requests go from your machine straight to Companies House.
Documentation: companies-house.uk
Pick your route
In an AI assistant — Claude Code, Claude Desktop, Codex, Cursor, Zed:
npx -y companies-house-mcp
Set COMPANIES_HOUSE_API_KEY in the client's config. Full setup for each client: companies-house.uk/mcp.
In the terminal — the ch command:
npm install -g companies-house-cli
ch config set-key your-key-here
ch report 00445790
Full reference: companies-house.uk/cli.
On your own server — an optional Cloudflare Worker you deploy into your own account, so Claude Code can reach it remotely. See companies-house.uk/self-hosting, or the deployment guide.
Get a free API key at developer.company-information.service.gov.uk. It takes about a minute.
What you can do
Find a company — search_companies / ch search by name, with filters for status, type, incorporation date, location and SIC code. search_officers / ch search-officers finds people across the whole register.
Read its record — get_company_profile / ch profile for status, addresses, SIC codes and filing dates. get_charges, get_insolvency, get_company_registers, get_exemptions and get_uk_establishments for the rest.
Trace people and ownership — get_officers / ch officers for who is in post, get_appointments and officer_network for everywhere one person is appointed, get_ownership / ch ownership for persons with significant control, and get_officer_disqualifications for the disqualified directors register.
Read the filings — get_filings / ch filings for the filing history, get_filing_document for one filing in detail, and download_filing_document / ch document for the filed PDF itself.
Get the whole picture at once — company_report / ch report reads the main records in a single call. due_diligence_check / ch check screens a company against the register and reports the entries a reviewer would want to look at.
Full parameter reference: companies-house.uk/tools.
What this is not
Companies House records what companies file. It carries out basic completeness checks but does not verify that the information is accurate.
So nothing here is a verification, a credit check, a sanctions or politically-exposed-person screening, or a clearance decision. due_diligence_check is a screening summary: it tells you what is on the register and what it could not check. It never concludes that a company is sound. An absence of adverse entries means nothing adverse has been filed.
The register also does not cover trading performance, litigation, or beneficial ownership held outside the persons-with-significant-control regime. Identity verification for existing directors and PSCs is still being rolled out under the Economic Crime and Corporate Transparency Act, so a name on the register does not mean the person behind it has been identity-checked.
Your key, your data
Your API key stays with you. The CLI reads it from --key, then COMPANIES_HOUSE_API_KEY, then ~/.config/companies-house/config.json, which is written with owner-only permissions. ch config show prints only the last four characters.
Nothing is sent anywhere except Companies House. There is no telemetry.
Companies House allows 600 requests per five minutes per key. The client queues requests to stay inside that, and if it does hit the limit it waits only when Companies House says the window is about to reset — otherwise it reports the limit rather than stalling.
Officer records include service addresses and dates of birth as published on the public register. Treat them as the personal data they are.
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.
Disclaimer
Not affiliated with or endorsed by Companies House or the UK Government. Uses the public Companies House API.
Licence
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
COMPANIES_HOUSE_API_KEYAPI key from developer.company-information.service.gov.uk — free to register
Categories
Registryactive
Packagecompanies-house-mcp
TransportSTDIO
UpdatedMar 28, 2026
