Companies House MCP Server

A Model Context Protocol (MCP) server providing comprehensive access to the UK Companies House API. Search companies, get detailed profiles, officer information, filing history, persons with significant control, charges, and more.

Features

• 🔍 Company Search - Search for companies by name or number
• 🏢 Company Profiles - Get detailed company information
• 👥 Officers - Access director and secretary information
• 📄 Filing History - View company filings and submissions
• 🎯 PSC Data - Persons with Significant Control information
• ⚖️ Charges - View registered charges against companies
• 💼 Insolvency - Company insolvency information
• 🚫 Disqualified Officers - Search for disqualified directors

Installation & Setup

Step 1: Get Your Companies House API Key

Get a free API key from Companies House:

1. Visit https://developer.company-information.service.gov.uk/
2. Click "Register" and create an account
3. Sign in and click "Register an application"
4. Fill in the application details (name can be anything like "Claude MCP")
5. Copy your API key (it looks like: 5e9be388-f0e1-4b5a-bc44-982aba20227a)

Step 2: Configure Claude Desktop

MacOS: Open ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: Open %APPDATA%\Claude\claude_desktop_config.json

Copy and paste this configuration (replace YOUR_API_KEY_HERE with your actual API key):

{
  "mcpServers": {
    "companieshouse": {
      "command": "npx",
      "args": ["-y", "@biznezstack/companieshouse-mcp"],
      "env": {
        "COMPANIESHOUSE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Example with a real API key:

{
  "mcpServers": {
    "companieshouse": {
      "command": "npx",
      "args": ["-y", "@biznezstack/companieshouse-mcp"],
      "env": {
        "COMPANIESHOUSE_API_KEY": "5e9be388-f0e1-4b5a-bc44-982aba20227a"
      }
    }
  }
}

Note: If you already have other MCP servers configured, just add the companieshouse entry inside your existing mcpServers object.

Step 3: Restart Claude Desktop

1. Quit Claude Desktop completely
2. Reopen Claude Desktop
3. The Companies House MCP server will load automatically

Step 4: Test It Works

In Claude, try asking:

• "Search for companies named HSBC"
• "Get company profile for 00000006"

You should see Claude using the Companies House tools to fetch real data!

📋 Already Have Other MCP Servers?

If your Claude config already has other servers, combine them like this:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    },
    "companieshouse": {
      "command": "npx",
      "args": ["-y", "@biznezstack/companieshouse-mcp"],
      "env": {
        "COMPANIESHOUSE_API_KEY": "YOUR_API_KEY_HERE"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_token"
      }
    }
  }
}

Just add the companieshouse block alongside your existing servers!

Usage Examples

Once configured, you can ask Claude questions like:

• "Search for companies named 'Tech Solutions'"
• "Get the company profile for company number 00000006"
• "Who are the directors of HSBC Holdings plc?"
• "Show me the filing history for company 12345678"
• "Find persons with significant control for company XYZ Ltd"
• "Are there any charges registered against company ABC123?"
• "Search for disqualified officers named John Smith"

Available Tools

Company Search & Lookup

• search_companies - Search for UK companies
• search_companies_alphabetically - Alphabetical company search
• search_dissolved_companies - Search dissolved companies
• get_company_profile - Get detailed company profile
• get_company_registered_office - Get registered office address

Officers

• get_company_officers - List company officers
• search_officers - Search for officers by name
• get_officer_appointments - Get all appointments for an officer

Filing History

• get_company_filing_history - Get company filings
• get_filing_history_item - Get specific filing details

Persons with Significant Control (PSC)

• get_company_psc - List PSCs for a company
• get_individual_psc - Get individual PSC details
• get_corporate_entity_psc - Get corporate entity PSC details
• get_legal_person_psc - Get legal person PSC details

Charges

• get_company_charges - List company charges
• get_charge_details - Get specific charge details

Other Information

• get_company_insolvency - Insolvency information
• get_company_exemptions - Company exemptions
• get_company_registers - Register information
• get_uk_establishments - UK establishments for overseas companies

Disqualified Officers

• search_disqualified_officers - Search disqualified officers
• get_natural_disqualification - Natural person disqualification details
• get_corporate_disqualification - Corporate disqualification details

Development

Local Development

1. Clone the repository

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. For development with auto-rebuild:

   npm run watch

Testing Locally

To test the server locally, you can run it directly with your API key:

export COMPANIESHOUSE_API_KEY=your_api_key_here
npm run build
node dist/index.js

API Rate Limits

The Companies House API has rate limits:

• 600 requests per 5 minutes per IP address

Please be mindful of these limits when making requests.

Resources

• Companies House Developer Hub
• API Documentation
• Model Context Protocol

License

MIT License - see LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues related to:

• This MCP Server: Open an issue on GitHub
• Companies House API: Contact Companies House support
• Claude Desktop: Contact Anthropic support