companies-house-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| COMPANIES_HOUSE_API_KEY | Yes | Your Companies House Public Data API key. Register an application at https://developer.company-information.service.gov.uk/ and create a key for the "Public Data API". The key is read from the environment and nowhere else; if it is missing the server refuses to start. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| company_searchA | Search UK companies by name. Returns a list of matches, each with company_number, title, company_status, company_type, date_of_creation and address_snippet: enough to choose the right company without a follow-up call. Use the returned company_number with the other tools. On failure returns an error object with a code field. |
| company_profileA | Get the profile of one UK company by its number. Returns company_name, company_number, company_status, company_type, date_of_creation, date_of_cessation, jurisdiction, registered_office_address, sic_codes and accounts due dates. This is a fixed subset; a property not listed was not fetched, so do not read its absence as false. On failure returns an error object with a code field, including COMPANY_NOT_FOUND and INVALID_COMPANY_NUMBER. |
| company_officersA | List the officers of one UK company by its number. Returns active_count and resigned_count, then items each with name, officer_role, appointed_on, resigned_on, nationality, occupation, country_of_residence and date_of_birth (month and year only). Paged. On failure returns an error object with a code field. |
| company_filing_historyA | List the filing history of one UK company by its number. Returns items each with transaction_id, category, date, type, a resolved description, the original description_code, pages and paper_filed. Filter with the category parameter. Paged. On failure returns an error object with a code field. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool targets a distinct operation: name search, single-company profile, officer listing, and filing history. The search tool explicitly tells the agent to use the returned company_number with the other three, and the resource/action boundaries are unambiguous.
All four tools follow a consistent snake_case pattern with a shared 'company_' prefix and a clear resource noun (search, profile, officers, filing_history). No style mixing or vague verbs.
Four tools is a tight, well-scoped surface for a read-only Companies House lookup server. Each tool covers a core operation and there are no redundant or filler tools.
The surface covers the most common lookups (search, profile, officers, filings) but omits notable Companies House resources such as charges, persons with significant control, and insolvency data. Agents needing those will hit dead ends, though core workflows are supported.