companies-house-mcp

mcp
Security Audit
Warn
Health Pass
  • License รขโ‚ฌโ€ License: AGPL-3.0
  • Description รขโ‚ฌโ€ Repository has a description
  • Active repo รขโ‚ฌโ€ Last push 0 days ago
  • Community trust รขโ‚ฌโ€ 15 GitHub stars
Code Warn
  • network request รขโ‚ฌโ€ Outbound network request in src/api/base-client.ts
Permissions Pass
  • Permissions รขโ‚ฌโ€ No dangerous permissions requested
Purpose
This MCP server acts as a bridge to the UK Companies House API, allowing AI clients to search for and retrieve detailed public company data, filing histories, and officer information.

Security Assessment
Overall risk: Low. The tool makes expected outbound network requests specifically to the official UK government API endpoint to fetch company data. It does not execute arbitrary shell commands, request dangerous local system permissions, or appear to contain hardcoded secrets. The only sensitive element to be aware of is that your personal Companies House API key is passed via environment variables, which is a standard and secure practice.

Quality Assessment
The project demonstrates strong health indicators. It is actively maintained, with repository updates pushed as recently as today. It includes standard development features like tests, linting, and type checking. The code is fully open-source under the AGPL-3.0 license (though note that this specific license requires you to open-source your entire derived application if you modify and host the tool's source code). Community trust is modest but growing, currently backed by 15 GitHub stars.

Verdict
Safe to use, provided you adhere to the AGPL-3.0 licensing constraints and safely manage your API key.
SUMMARY

๐Ÿ‡ฌ๐Ÿ‡ง๐Ÿฆ MCP server for UK Companies House API - Search companies, retrieve detailed information, filing history, officers, and charges data through the Model Context Protocol

README.md

Companies House MCP Server

Companies House MCP Server - Demo

Access UK company data through the Companies House API directly in MCP clients.

Features

45+ tools covering the full Companies House API:

  • Company info โ€” profile, registered address, registers, insolvency, exemptions, UK establishments
  • Search โ€” companies (basic & advanced), officers, disqualified officers, dissolved companies, alphabetical
  • Officers โ€” directors list, appointments, disqualifications
  • Filing history โ€” accounts, annual returns, document details
  • PSC (ownership) โ€” individuals, corporate entities, legal persons, statements, verification
  • Charges โ€” mortgages, debentures, charge details

Setup

1. Get an API key

Register at the Companies House Developer Hub and create an application.

2. Configure your MCP client

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac, %APPDATA%\Claude\claude_desktop_config.json on Windows):

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

Build from source (optional)

git clone https://github.com/stefanoamorelli/companies-house-mcp.git
cd companies-house-mcp
npm install && npm run build

Then point your MCP client to node /path/to/companies-house-mcp/dist/index.js.

Development

npm test            # Run tests
npm run typecheck   # Type checking
npm run lint        # Linting
npm run build       # Build
npm run dev         # Run locally

API Rate Limits

600 requests per 5 minutes per API key. Some endpoints may have additional restrictions.

License

GNU Affero General Public License v3.0 โ€” see LICENSE.

For commercial licensing: [email protected]

ยฉ 2025 Stefano Amorelli (https://amorelli.tech)

Reviews (0)

No results found