- Home
- MCP servers
- Companies House
Companies House
- typescript
8
GitHub Stars
typescript
Language
6 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"stefanoamorelli-companies-house-mcp": {
"command": "npx",
"args": [
"-y",
"companies-house-mcp-server"
],
"env": {
"COMPANIES_HOUSE_API_KEY": "your_api_key_here"
}
}
}
}You can access UK company data through a dedicated MCP server that exposes Companies House endpoints to MCP clients. This server consolidates 45+ endpoints for company information, searches, officers, filings, PSC data, and financial details, enabling you to build powerful queries and workflows against UK company records from your MCP-enabled tools.
How to use
Install the MCP server locally or run it directly to start querying Companies House data. You can perform comprehensive searches, retrieve detailed company profiles, examine filing histories, inspect officers and PSC information, and access financial details such as charges. Use MCP clients to call the available endpoints and assemble workflows that fit your needs.
How to install
Prerequisites: you need Node.js and npm installed on your system. You can verify Node.js is installed by running node -v and npm by running npm -v.
Option 1: Run the MCP server using npx (recommended for quick start)
npm install -g companies-house-mcp-server
npx companies-house-mcp-server
Option 2: Build from source and run locally
git clone https://github.com/stefanoamorelli/companies-house-mcp.git
cd companies-house-mcp
npm install
npm run build
Then run using the compiled file:
{
"mcpServers": {
"companies-house": {
"command": "node",
"args": ["/absolute/path/to/companies-house-mcp/dist/index.js"],
"env": {
"COMPANIES_HOUSE_API_KEY": "your_api_key_here"
}
}
}
}
Configuration and API key
You must provide an API key to access Companies House data. Obtain your key by registering at the Companies House Developer Hub and creating an application, then use that key in your MCP client configuration.
# Example Claude Desktop configuration using npx
{
"mcpServers": {
"companies-house": {
"command": "npx",
"args": ["-y", "companies-house-mcp-server"],
"env": {
"COMPANIES_HOUSE_API_KEY": "your_api_key_here"
}
}
}
}
Security and rate limits
The MCP server relies on your API key to authenticate with the upstream Companies House API. Be mindful of API rate limits: up to 600 requests per 5 minutes per API key. Some endpoints may have additional restrictions.
Build from source and run notes
If you prefer building from source, you can run the build process and then start the local server with the produced JavaScript file. Include the required environment variable for the API key in your startup configuration.
Available tools
search_companies
Search for companies by name or company number with pagination and filtering.
get_company_profile
Retrieve detailed information for a specific company, including profile data and key dates.
get_registered_office_address
Fetch the registered office address for a given company Number.
get_registers
Access information about company registers.
get_insolvency
Retrieve insolvency information for a company.
get_exemptions
Fetch exemptions disclosures for a company.
get_uk_establishments
Get UK establishments for foreign companies.
advanced_company_search
Perform advanced searches with multiple filters for more precise results.
search_all
Search across all resource types for broader discovery.
search_officers
Find company officers by name with pagination.
search_disqualified_officers
Search for disqualified officers by name.
alphabetical_search
Search companies by name prefix alphabetically.
dissolved_search
Find dissolved companies by query.
get_officers
Get list of company officers with options for register type and pagination.
get_officer_appointment
Retrieve details for a specific officer appointment.
get_officer_appointments_list
List all appointments for an officer.
get_corporate_officer_disqualification
Fetch corporate officer disqualification details.
get_natural_officer_disqualification
Fetch natural person disqualification details.
get_filing_history
Get a company’s filing history with category filtering and pagination.
get_filing_history_item
Get a specific filing item’s details.
get_charges
Retrieve a list of company charges.
get_charge_details
Get details for a specific charge.
get_persons_with_significant_control
List PSCs for a company.
get_psc_individual
Get individual PSC details.
get_psc_corporate_entity
Get corporate PSC details.
get_psc_legal_person
Get legal person PSC details.
get_psc_statements_list
Fetch PSC statements.
get_psc_statement
Get a specific PSC statement.
get_psc_individual_beneficial_owner
Retrieve individual PSC beneficial owner details.
get_psc_individual_verification
Retrieve individual PSC verification details.
get_psc_individual_full_record
Retrieve full PSC record for an individual.
get_psc_corporate_entity_beneficial_owner
Retrieve corporate entity PSC beneficial owner details.
get_psc_legal_person_beneficial_owner
Retrieve legal person PSC beneficial owner details.
get_psc_super_secure
Retrieve super-secure PSC details.
get_psc_super_secure_beneficial_owner
Retrieve super-secure PSC beneficial owner details.