# UK Companies House MCP Server (`rl1987/companies-house-mcp`) Actor MCP server exposing UK Companies House company/officer/disqualification search and full company details as tools. - **URL**: https://apify.com/rl1987/companies-house-mcp.md - **Developed by:** [R.L.](https://apify.com/rl1987) (community) - **Categories:** Lead generation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 price for completing a tool calls This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README MCP server for the free, public [UK Companies House company search](https://find-and-update.company-information.service.gov.uk/search?q=). **Search UK companies, officers, and disqualified directors**, then pull full company profiles, filing history, officers, charges, persons with significant control (PSC), and insolvency records straight into your LLM's context — no Companies House API key required. Try it by connecting any MCP client (Claude, Cursor, custom agents) to this Actor's Standby endpoint. ### Why use this Companies House MCP server? - **Due diligence and KYC** — pull a company's officers, PSCs, and charges before signing a contract or onboarding a supplier. - **Sales and lead research** — enrich a target account list with incorporation date, SIC code, registered address, and status. - **Investigative and compliance research** — cross-reference directors against the disqualified officers register, trace an individual's other directorships, or check for outstanding charges/insolvency. - **No API key needed** — unlike the official Companies House REST API, this Actor works directly against the public search website, so there's nothing to register for. - Runs on Apify, so you get scheduling, monitoring, and integration with 1,000+ other Actors on top of the raw data. ### How to use this Companies House scraper 1. Deploy/run this Actor on Apify in **Standby mode** (already configured — no input required to start it). 2. Connect your MCP client to the Actor's Standby URL (`https://rl1987--companies-house-mcp.apify.actor/mcp`) using the Streamable HTTP transport, with your Apify API token as a Bearer token. 3. Ask your LLM to search for a company, officer, or disqualified director — it will call the matching tool automatically. 4. Follow up by asking for that company's officers, filing history, charges, PSCs, or insolvency details — the LLM chains tool calls using the IDs returned from the search step, exactly like a person clicking through the website. #### Connect with Claude Code Add this Actor as an MCP server to Claude Code CLI: ```bash claude mcp add --transport http companies-house https://rl1987--companies-house-mcp.apify.actor/mcp \ --header "Authorization: Bearer $APIFY_API_TOKEN" ```` Replace `$APIFY_API_TOKEN` with your [Apify API token](https://console.apify.com/account/integrations). Verify it connected with `claude mcp list`. ### Tools The tools mirror the steps a person takes on the Companies House website: search first, then drill into a specific record. #### Search (mirrors the search tabs at `/search?q=`) | Tool | What it does | | --- | --- | | `search_all` | Search companies + officers + disqualified officers at once ("All" tab) | | `search_companies` | Search companies by name/number/previous name | | `search_officers` | Search officers by name (supports `location:"..."` filter, same as the site) | | `search_disqualified_officers` | Search the disqualified directors register | | `advanced_company_search` | Full advanced search: name include/exclude, address, incorporation/dissolved date ranges, SIC code, company status, company type, subtype | #### Company details (mirrors a company's profile tabs) | Tool | What it does | | --- | --- | | `get_company_profile` | Overview: status, type, registered address, incorporation date, SIC codes, previous names, accounts/confirmation statement dates | | `get_company_officers` | Current and resigned directors/secretaries | | `get_company_filing_history` | Filed documents with direct PDF links, optionally filtered by category | | `get_company_charges` | Registered charges/mortgages, status, persons entitled | | `get_company_persons_with_significant_control` | PSCs (beneficial owners) and nature of control, or the exemption reason if not available | | `get_company_insolvency` | Insolvency case dates and practitioners | | `get_company_more_info` | Links to order an official certificate or certified document copy | #### People | Tool | What it does | | --- | --- | | `get_officer_appointments` | Every company an officer holds/held an appointment at | | `get_disqualified_officer` | Full disqualification record: dates, case reference, reason, company | ### Output example `search_companies` output for a query like `tesco`: ```json { "query": "tesco", "companies": [ { "type": "company", "title": "TESCO PLC", "url": "https://find-and-update.company-information.service.gov.uk/company/00445790", "company_number": "00445790", "status_summary": "Incorporated on 27 November 1947", "address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA" } ], "total_matches": 356, "has_next_page": true } ``` `get_company_profile` for `00445790`: ```json { "company_number": "00445790", "company_name": "TESCO PLC", "company_status": "Active", "company_type": "Public limited Company", "incorporated_on": "27 November 1947", "sic_codes": ["47110 - Retail sale in non-specialised stores with food, beverages or tobacco predominating"], "registered_office_address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA" } ``` ### Pricing This Actor runs in Standby mode and is billed per tool call via Pay Per Event — see the Actor's Monetization tab for the current price per call. There's no charge for connecting or for failed calls. ### Tips - Use `search_companies`/`search_officers`/`search_disqualified_officers` before the `get_*` tools — they return the IDs (`company_number`, `officer_id`, `disqualification_id`) the detail tools need. - `get_company_persons_with_significant_control` returns `psc_available: false` with a `reason` for companies exempt from PSC disclosure (e.g. those listed on a regulated market) — this is normal, not an error. - `advanced_company_search` accepts multiple `status`/`company_type` values in one call, same as ticking multiple checkboxes on the website. ### FAQ and disclaimers This Actor scrapes the free, public Companies House website (`find-and-update.company-information.service.gov.uk`), not the official Companies House REST API. As stated by Companies House itself, **Companies House does not check the accuracy of the information filed** — treat all data as informational, not verified. This Actor only accesses publicly available pages and does not require sign-in. Found a bug or need a field this Actor doesn't extract yet? Open an issue on the Actor's Issues tab. # Actor input Schema ## Actor input object example ```json {} ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("rl1987/companies-house-mcp").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("rl1987/companies-house-mcp").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call rl1987/companies-house-mcp --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rl1987/companies-house-mcp", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Companies House MCP Server", "description": "MCP server exposing UK Companies House company/officer/disqualification search and full company details as tools.", "version": "0.1", "x-build-id": "LO4ESYtvShPwSNgt1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rl1987~companies-house-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rl1987-companies-house-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/rl1987~companies-house-mcp/runs": { "post": { "operationId": "runs-sync-rl1987-companies-house-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/rl1987~companies-house-mcp/run-sync": { "post": { "operationId": "run-sync-rl1987-companies-house-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": {} }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```