Skip to main content
Glama
companies-house-mcp

companies-house-mcp

by mikeyhu

companies-house-mcp

A STDIO-based MCP server that exposes the UK Companies House public data API as tools for MCP clients (Claude Desktop, Claude Code, etc.).

Setup

  1. Get an API key. Register at https://developer.company-information.service.gov.uk/, create an application, and generate a key of type REST.

  2. Install dependencies (using uv, already configured for this project):

    uv sync

    (Or with plain pip in a virtualenv: pip install -e .)

  3. Set the API key in your environment:

    export COMPANIES_HOUSE_API_KEY=your-key-here

    See .env.example for reference — this project does not auto-load .env files; set the variable in your shell or in your MCP client's server config.

Related MCP server: companieswise

Running

Directly over stdio:

uv run companies-house-mcp

With the MCP Inspector for interactive testing:

uv run mcp dev src/companies_house_mcp/server.py

Registering with Claude Code / Claude Desktop

Claude Code:

claude mcp add companies-house \
  -e COMPANIES_HOUSE_API_KEY=your-key-here \
  -- uv --directory /Users/michaelhughes/companies-house-mcp run companies-house-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "companies-house": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/michaelhughes/companies-house-mcp",
        "run",
        "companies-house-mcp"
      ],
      "env": {
        "COMPANIES_HOUSE_API_KEY": "your-companies-house-rest-api-key"
      }
    }
  }
}

Tools

Tool

Description

search_companies

Search for companies by name or company number

search_officers

Search for officers (directors, secretaries, etc.) by name

get_company_profile

Full profile of a company (status, SIC codes, incorporation date, etc.)

get_registered_office_address

A company's registered office address

list_company_officers

Officers of a company, current and past

list_filing_history

A company's filing history

get_filing_history_item

Detail of a single filing history item

list_persons_with_significant_control

Persons with significant control (PSCs) over a company

list_charges

Charges (mortgages) registered against a company

get_charge

Detail of a single charge

get_insolvency

Insolvency practice information, if any

list_uk_establishments

UK establishments linked to a company (overseas companies)

Company numbers may be passed with or without leading zeros (e.g. 123456 is normalized to 00123456); alphanumeric-prefixed numbers (e.g. SC123456) are left as-is (upper-cased). Company numbers, charge IDs, and filing transaction IDs are all validated to contain only letters and digits before being used in a request — anything else (e.g. stray /, .., ?) is rejected with a clear error rather than silently altering the request.

get_insolvency, list_charges, list_persons_with_significant_control, and list_uk_establishments return a clear empty result (e.g. {"cases": [], "message": "No insolvency data for this company"}) rather than an error when a company simply has none of that data — Companies House 404s these endpoints both for "no data" and for a nonexistent company, so this distinction is made by double-checking the company profile before treating a 404 as "empty."

Companies House rate-limits API keys to 600 requests per 5 minutes; a 429 response is surfaced as a clear tool error including the Retry-After value.

Testing

uv run pytest

Available Tools

12 tools
get_chargeB

Get the detail of a single charge (mortgage) registered against a company.

Inputs: charge_id (required), company_number (required). Returns: id, etag, links, status, +17 more

get_company_profileA

Get the full profile of a company (status, SIC codes, incorporation date, address, etc.).

Inputs: company_number (required). Returns: etag, type, links, subtype, +26 more

get_filing_history_itemB

Get the detail of a single filing history item for a company.

Inputs: company_number (required), transaction_id (required). Returns: date, type, links, pages, +10 more

get_insolvencyB

Get insolvency practice information for a company, if any.

Inputs: company_number (required). Returns: etag, cases, status, message

get_registered_office_addressC

Get a company's registered office address.

Inputs: company_number (required). Returns: po_box, region, care_of, country, +5 more

list_chargesC

List charges (mortgages) registered against a company.

Inputs: company_number (required). Returns: etag, items, message, total_count, +3 more

list_company_officersB

List current and past officers (directors, secretaries, etc.) of a company.

Inputs: company_number (required), order_by, start_index, register_type, +2 more. Returns: etag, kind, items, links, +6 more

list_filing_historyC

List a company's filing history (annual returns, accounts, resolutions, etc.).

Inputs: company_number (required), category, start_index, items_per_page. Returns: etag, kind, items, start_index, +3 more

list_persons_with_significant_controlC

List persons with significant control (PSCs) over a company.

Inputs: company_number (required), start_index, register_view, items_per_page. Returns: etag, kind, items, links, +6 more

list_uk_establishmentsC

List UK establishments linked to a company (relevant for overseas companies).

Inputs: company_number (required). Returns: etag, kind, items, links, +1 more

search_companiesC

Search for companies by name or company number.

Inputs: q (required), start_index, restrictions, items_per_page. Returns: etag, kind, items, start_index, +2 more

search_officersC

Search for company officers (directors, secretaries, etc.) by name.

Inputs: q (required), start_index, items_per_page. Returns: kind, items, start_index, total_results, +1 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 12 tools

    Disambiguation5/5

    Every tool targets a distinct entity (company profile, charges, officers, filing history, PSCs, UK establishments, insolvency, registered address) or search type (companies, officers), with no overlap in purpose.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using snake_case (e.g., get_company_profile, list_charges, search_companies), with uniform prefixes for single resources (get_), collections (list_), and searches (search_).

    Tool Count5/5

    12 tools is well-scoped for a company information API, covering core data types without being excessive or too few.

    Completeness5/5

    The tool surface covers all major Companies House data types: profile, officers, charges, filing history, PSCs, insolvency, establishments, and address, plus search for companies and officers. No obvious gaps for a read-only API.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      35
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides 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.
      3
      49 npm
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search and retrieve UK Companies House data including company profiles, officers, and filing history via the official API.
      4
      199 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying UK company data including search, profiles, officers, filings, and persons with significant control via Companies House API.
      MIT