companies-house-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@companies-house-mcp Get company profile for 01234567"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
companies-house-mcp
A STDIO-based MCP server that exposes the UK Companies House public data API as tools for MCP clients (Claude Desktop, Claude Code, etc.).
Setup
Get an API key. Register at https://developer.company-information.service.gov.uk/, create an application, and generate a key of type REST.
Install dependencies (using uv, already configured for this project):
uv sync(Or with plain
pipin a virtualenv:pip install -e .)Set the API key in your environment:
export COMPANIES_HOUSE_API_KEY=your-key-hereSee
.env.examplefor reference — this project does not auto-load.envfiles; set the variable in your shell or in your MCP client's server config.
Related MCP server: companieswise
Running
Directly over stdio:
uv run companies-house-mcpWith the MCP Inspector for interactive testing:
uv run mcp dev src/companies_house_mcp/server.pyRegistering with Claude Code / Claude Desktop
Claude Code:
claude mcp add companies-house \
-e COMPANIES_HOUSE_API_KEY=your-key-here \
-- uv --directory /Users/michaelhughes/companies-house-mcp run companies-house-mcpClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"companies-house": {
"command": "uv",
"args": [
"--directory",
"/Users/michaelhughes/companies-house-mcp",
"run",
"companies-house-mcp"
],
"env": {
"COMPANIES_HOUSE_API_KEY": "your-companies-house-rest-api-key"
}
}
}
}Tools
Tool | Description |
| Search for companies by name or company number |
| Search for officers (directors, secretaries, etc.) by name |
| Full profile of a company (status, SIC codes, incorporation date, etc.) |
| A company's registered office address |
| Officers of a company, current and past |
| A company's filing history |
| Detail of a single filing history item |
| Persons with significant control (PSCs) over a company |
| Charges (mortgages) registered against a company |
| Detail of a single charge |
| Insolvency practice information, if any |
| UK establishments linked to a company (overseas companies) |
Company numbers may be passed with or without leading zeros (e.g. 123456 is
normalized to 00123456); alphanumeric-prefixed numbers (e.g. SC123456) are
left as-is (upper-cased). Company numbers, charge IDs, and filing transaction
IDs are all validated to contain only letters and digits before being used in
a request — anything else (e.g. stray /, .., ?) is rejected with a clear
error rather than silently altering the request.
get_insolvency, list_charges, list_persons_with_significant_control, and
list_uk_establishments return a clear empty result (e.g.
{"cases": [], "message": "No insolvency data for this company"}) rather than
an error when a company simply has none of that data — Companies House 404s
these endpoints both for "no data" and for a nonexistent company, so this
distinction is made by double-checking the company profile before treating a
404 as "empty."
Companies House rate-limits API keys to 600 requests per 5 minutes; a 429
response is surfaced as a clear tool error including the Retry-After value.
Testing
uv run pytestAvailable Tools
12 toolsget_chargeB
Get the detail of a single charge (mortgage) registered against a company.
Inputs: charge_id (required), company_number (required). Returns: id, etag, links, status, +17 more
get_company_profileA
Get the full profile of a company (status, SIC codes, incorporation date, address, etc.).
Inputs: company_number (required). Returns: etag, type, links, subtype, +26 more
get_filing_history_itemB
Get the detail of a single filing history item for a company.
Inputs: company_number (required), transaction_id (required). Returns: date, type, links, pages, +10 more
get_insolvencyB
Get insolvency practice information for a company, if any.
Inputs: company_number (required). Returns: etag, cases, status, message
get_registered_office_addressC
Get a company's registered office address.
Inputs: company_number (required). Returns: po_box, region, care_of, country, +5 more
list_chargesC
List charges (mortgages) registered against a company.
Inputs: company_number (required). Returns: etag, items, message, total_count, +3 more
list_company_officersB
List current and past officers (directors, secretaries, etc.) of a company.
Inputs: company_number (required), order_by, start_index, register_type, +2 more. Returns: etag, kind, items, links, +6 more
list_filing_historyC
List a company's filing history (annual returns, accounts, resolutions, etc.).
Inputs: company_number (required), category, start_index, items_per_page. Returns: etag, kind, items, start_index, +3 more
list_persons_with_significant_controlC
List persons with significant control (PSCs) over a company.
Inputs: company_number (required), start_index, register_view, items_per_page. Returns: etag, kind, items, links, +6 more
list_uk_establishmentsC
List UK establishments linked to a company (relevant for overseas companies).
Inputs: company_number (required). Returns: etag, kind, items, links, +1 more
search_companiesC
Search for companies by name or company number.
Inputs: q (required), start_index, restrictions, items_per_page. Returns: etag, kind, items, start_index, +2 more
search_officersC
Search for company officers (directors, secretaries, etc.) by name.
Inputs: q (required), start_index, items_per_page. Returns: kind, items, start_index, total_results, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Every tool targets a distinct entity (company profile, charges, officers, filing history, PSCs, UK establishments, insolvency, registered address) or search type (companies, officers), with no overlap in purpose.
All tools follow a consistent verb_noun pattern using snake_case (e.g., get_company_profile, list_charges, search_companies), with uniform prefixes for single resources (get_), collections (list_), and searches (search_).
12 tools is well-scoped for a company information API, covering core data types without being excessive or too few.
The tool surface covers all major Companies House data types: profile, officers, charges, filing history, PSCs, insolvency, establishments, and address, plus search for companies and officers. No obvious gaps for a read-only API.
Maintenance
Related MCP Connectors
UK Companies House and KYB: search, officers, owners (PSC), filings, charges, banned directors
UK company records from Companies House, with alerts on new filings, officer and status changes.
UK company data: search, officers, owners, shareholders, filed accounts, new companies, KYB checks.
UK Companies House company search, officers and PSC via the official API. Runs on Apify.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables looking up UK companies, officers, ownership, filings, and running due diligence checks via the Companies House API, usable from AI tools like Claude or Cursor.35MIT

companieswiseofficial
AlicenseAqualityCmaintenanceProvides verified UK company lookup and number validation for AI agents using official Companies House data. Enables lookup of registered details by number, validation of company number format, and search by company name.349 npmApache 2.0- AlicenseAqualityDmaintenanceEnables AI assistants to search and retrieve UK Companies House data including company profiles, officers, and filing history via the official API.4199 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying UK company data including search, profiles, officers, filings, and persons with significant control via Companies House API.MIT