Summary
This connects Claude to the UK's Companies House API for looking up registered company data. It's part of the Pipeworx gateway ecosystem, which means you can either use it standalone or access it alongside 673+ other data sources through their unified endpoint. The implementation supports their ask_pipeworx pattern where you ask questions in plain English instead of calling tools directly, and it handles tool selection and argument mapping for you. Bring your own Companies House API key. Useful when you need to pull statutory filings, officer details, or company profiles for UK entities without leaving your Claude workflow.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
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.
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
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
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.
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
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
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.
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
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
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.
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
querystringFree-text search query. Matched against company or officer names by the Companies House search engine (case-insensitive, fuzzy). Examples: 'Tesco', 'Revolut', 'John Smith'.
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.
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
locationvalueFilter by registered office locality. Free-text match against the registered office locality field (typically a town or city).
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).
company_typevalueFilter by company type. Common values: 'ltd' (private limited), 'plc' (public limited), 'llp' (limited liability partnership), 'charitable-incorporated-organisation', 'community-interest-company', 'limited-partnership', 'private-unlimited', 'registered-society-non-jurisdictional'.
company_statusvalueFilter by registration status. Valid values include: 'active', 'dissolved', 'liquidation', 'receivership', 'administration', 'voluntary-arrangement', 'converted-closed', 'insolvency-proceedings', 'registered', 'removed', 'open', 'closed'.
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.
company_name_excludesvalueSubstring that must NOT appear in the company name.
company_name_includesvalueSubstring that must appear in the company name.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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
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_officers`` hit.
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_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 naturals) — use ``natural-disqualification`` for humans and ``corporate-disqualification`` for companies acting as directors.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_officers`` hit.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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
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.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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). Copy from the ``refs.company_number`` field of any search-hit or response that references a company, or call ``search_companies`` first if you only have a name. Examples: '09370755', 'SC123456', 'OC301550'.
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
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.
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/csv' — but any MIME string is accepted. Check a document's ``resources`` map (via ``get_document_metadata``) to see which types are actually available for that document before calling this. Defaults to 'application/pdf'.default: application/pdf
mcp-companies-house
Companies House MCP — UK statutory company registry (BYO key)
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"companies-house": {
"url": "https://gateway.pipeworx.io/companies-house/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Companies House data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
