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 search for Apple UK companies"
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 Server
A Model Context Protocol (MCP) server that provides AI assistants with access to UK Companies House data. This server enables AI tools to search for companies, retrieve detailed company profiles, officer information, and filing history through the official Companies House API.
Features
Company Search: Search for UK companies by name or keyword
Company Profiles: Get detailed company information including registration details, addresses, and status
Officer Information: Retrieve lists of company officers (directors, secretaries, etc.)
Filing History: Access company filing history and documents
MCP Compatible: Works with any MCP-compatible AI assistant or client
Related MCP server: companieswise
Prerequisites
Node.js 18 or higher
Companies House API key (free registration at Companies House Developer Hub)
Installation
Clone the repository:
git clone <repository-url>
cd companies-house-mcpInstall dependencies:
npm installSet up environment variables:
cp .env.example .env
# Edit .env and add your Companies House API keyBuild the project:
npm run buildConfiguration
Create a .env file in the project root:
COMPANIES_HOUSE_API_KEY=your_api_key_here
COMPANIES_HOUSE_BASE_URL=https://api.company-information.service.gov.ukGetting a Companies House API Key
Visit the Companies House Developer Hub
Create an account or sign in
Register a new application
Copy your API key to the
.envfile
Usage
Development
Start the development server with hot reload:
npm run devProduction
Build and start the production server:
npm run build
npm startDocker
Run using Docker:
docker build -t companies-house-mcp .
docker run -e COMPANIES_HOUSE_API_KEY=your_api_key_here companies-house-mcpOr use Docker Compose:
docker-compose upMCP Client Configuration
Local Development (Stdio Transport)
For local development or direct MCP client usage:
{
"mcpServers": {
"companies-house": {
"command": "node",
"args": ["/absolute/path/to/companies-house-mcp/dist/index.js"],
"env": {
"COMPANIES_HOUSE_API_KEY": "your_api_key_here"
}
}
}
}Cloud Deployment (HTTP Bridge)
For cloud deployment where the HTTP server runs remotely:
Start HTTP server on cloud server:
npm run start:httpConfigure client to use HTTP bridge:
{
"mcpServers": {
"companies-house-http": {
"command": "node",
"args": ["/absolute/path/to/companies-house-mcp/simple-http-bridge.js"],
"env": {
"COMPANIES_HOUSE_API_KEY": "your_api_key_here",
"MCP_HTTP_SERVER_URL": "http://your-server:3000"
}
}
}
}Note: For cloud deployment, see README-HTTP.md for detailed HTTP bridge configuration.
Available Tools
The server provides the following tools for AI assistants:
1. search_companies
Search for UK companies by name or keyword.
Parameters:
query(string, required): Search query for company name or keyworditems_per_page(number, optional): Number of results to return (default: 20)
Example:
{
"name": "search_companies",
"arguments": {
"query": "Apple",
"items_per_page": 10
}
}2. get_company_profile
Get detailed company profile information.
Parameters:
company_number(string, required): Company number (e.g., "12345678")
Example:
{
"name": "get_company_profile",
"arguments": {
"company_number": "12345678"
}
}3. get_company_officers
Get list of company officers (directors, secretaries, etc.).
Parameters:
company_number(string, required): Company number (e.g., "12345678")
Example:
{
"name": "get_company_officers",
"arguments": {
"company_number": "12345678"
}
}4. get_company_filings
Get company filing history.
Parameters:
company_number(string, required): Company number (e.g., "12345678")items_per_page(number, optional): Number of filings to return (default: 25)
Example:
{
"name": "get_company_filings",
"arguments": {
"company_number": "12345678",
"items_per_page": 50
}
}Development
Scripts
Core MCP Server (Stdio):
npm run dev- Start development server with hot reloadnpm run build- Compile TypeScript to JavaScriptnpm run start- Start production stdio servernpm run type-check- Run TypeScript type checking
HTTP Bridge (Cloud Deployment):
npm run start:http- Start HTTP server for cloud deploymentnpm run dev:http- Start HTTP server in development modenpm run bridge- Start HTTP bridge client
Project Structure
companies-house-mcp/
├── src/
│ ├── index.ts # Stdio MCP server entry point
│ ├── server.ts # Core MCP server implementation
│ ├── http-index.ts # HTTP server entry point
│ ├── http-server.ts # HTTP server implementation
│ ├── types.ts # TypeScript type definitions
│ └── services/
│ └── companies-house.ts # Companies House API client
├── simple-http-bridge.js # HTTP bridge client
├── dist/ # Compiled JavaScript files
├── .env # Environment variables
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── Dockerfile # Docker configuration
├── docker-compose.yml # Docker Compose configuration
├── README.md # Main documentation
└── README-HTTP.md # HTTP bridge documentationAPI Rate Limits
The Companies House API has rate limits. Please refer to the official documentation for current limits and best practices.
Error Handling
The server includes comprehensive error handling:
API errors are wrapped in MCP error format
Invalid company numbers return appropriate error messages
Network errors are caught and reported
Missing API keys are detected at startup
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
License
This project is licensed under the ISC License.
Support
For issues related to:
This MCP server: Open an issue in this repository
Companies House API: Visit the Companies House Developer Hub
Model Context Protocol: Visit the MCP documentation
Disclaimer
This is an unofficial client for the Companies House API. Please ensure you comply with the Companies House API terms of service and data usage policies.
Available Tools
4 toolsget_company_filingsC
Get company filing history
Inputs: company_number (required), items_per_page.
get_company_officersA
Get list of company officers (directors, secretaries, etc.)
Inputs: company_number (required).
get_company_profileC
Get detailed company profile information
Inputs: company_number (required).
search_companiesB
Search for UK companies by name or keyword
Inputs: query (required), items_per_page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct aspect of company data: search, profile, officers, and filings. There is no overlap between these operations, and an agent can easily select the correct tool based on the information needed.
All tool names follow a consistent verb_noun pattern with snake_case: search_ and get_ prefixed to the resource type. This makes the API predictable and easy to navigate.
With only 4 tools, the server is compact but still provides the core look-up operations for a company information API. While not exhaustive, the count is reasonable for a focused, single-domain server.
The set covers the primary read-only workflows: finding a company, viewing its details, officers, and filings. Notable omissions like charges or persons of significant control might be expected, but for a basic Companies House integration, the surface is largely complete.
Maintenance
Related MCP Connectors
UK Companies House company search, officers and PSC via the official API. Runs on Apify.
UK Companies House and KYB: search, officers, owners (PSC), filings, charges, banned directors
Company data for AI agents: enrich a domain, UK Companies House records, Y Combinator companies.
UK company records from Companies House, with alerts on new filings, officer and status changes.
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- FlicenseBqualityDmaintenanceProvides access to UK Companies House public data, enabling search and retrieval of company profiles, officers, filing history, and more through natural language queries.12-
- AlicenseNot gradedqualityDmaintenanceEnables querying UK company data including search, profiles, officers, filings, and persons with significant control via Companies House API.MIT