companies-house

This MCP server exposes a suite of tools for querying and retrieving data from Companies House. It includes capabilities to search for companies, fetch detailed company profiles, list officers, retrieve filing histories, view charges, obtain PSC information, and search officers by name. Each tool supports a verbose mode for more detailed responses and a compact mode for essential fields, with pagination available for tools that return multiple results. The server is designed to be used either via CLI integration (e.g., Claude Desktop) or as a direct Node.js process in your environment.

To use, connect to the server through the available tools (e.g., search_companies, get_company_profile, get_company_officers, get_filing_history, get_company_charges, get_persons_with_significant_control, search_officers). Provide the required parameters such as query text, companyNumber, or other filters, and optionally set verbose to true for full details. You can run the server locally with your API key, then direct Claude or your MCP client to the appropriate command line or Node entry point as documented in the README.

Prerequisites

• Node.js 18 or higher
• Companies House API key (free from https://developer.company-information.service.gov.uk)

Quick Start

# Install globally
npm install -g companies-house-mcp

# Run with your API key
COMPANIES_HOUSE_API_KEY=your_api_key_here companies-house-mcp --api-key YOUR_API_KEY

Development Setup

# Clone repository
git clone https://github.com/aicayzer/companies-house-mcp
cd companies-house-mcp

# Install dependencies
npm install

# Set up environment
echo "COMPANIES_HOUSE_API_KEY=your_api_key_here" > .env

# Build project
npm run build

# Run tests
npm test

# Start development server
npm run dev

Usage with Claude Desktop

{
  "mcpServers": {
    "companies-house": {
      "command": "npx",
      "args": ["-y", "companies-house-mcp"],
      "env": {
        "COMPANIES_HOUSE_API_KEY": "${COMPANIES_HOUSE_API_KEY}"
      }
    }
  }
}

Running Locally with Direct Path

{
  "mcpServers": {
    "companies-house": {
      "command": "node",
      "args": ["/path/to/your/companies-house-mcp/dist/index.js", "--api-key", "YOUR_API_KEY_HERE"]
    }
  }
}

Environment variables: Always provide COMPANIES_HOUSE_API_KEY. The server supports DEBUG for verbose internal logs. If you encounter rate limit issues, the server includes automatic rate limiting and response caching to minimize API calls. For Docker deployment, a Dockerfile is included and you can build/run with your API key as an environment variable. If using Claude Desktop, you can wire the MCP server using either the npx-based or node-based entry point depending on your workflow. Ensure your API key is kept secure and not committed to version control.