Skip to main content
Glama
EdwardRadford

companies-house-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
COMPANIES_HOUSE_API_KEYNoAPI key from the Companies House developer hub. Required for actual API calls, but the server can start without it.
COMPANIES_HOUSE_TIMEOUTNoTimeout in seconds for each request. Defaults to 10.10
COMPANIES_HOUSE_BASE_URLNoBase URL for the Companies House API. Defaults to the live API.

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_companiesA

Find companies on the UK register by name, returning their company numbers.

Covers live and dissolved companies alike, ranked by relevance; check status before assuming a hit is trading. Use the returned company_number with every other tool. It searches company names only, so it cannot find a company from a director's name.

get_company_profileA

Get a company's register entry: name, status, type, incorporation date, registered office, business activities (SIC codes), previous names, and filing deadlines.

Read warnings first: it lists overdue accounts or confirmation statements, insolvency history, proposals to strike off, and a disputed or undeliverable registered office. has_charges says whether list_charges will find anything. One upstream request.

list_officersA

List a company's directors, secretaries and LLP members, with appointment dates, occupation, nationality and month and year of birth.

active_count and resigned_count cover the whole company even when one page does not. Addresses are deliberately left out.

list_filingsA

List what a company has filed at Companies House, newest first: accounts, confirmation statements, officer changes, charges, resolutions and so on, each with its form code and a readable description.

Use category rather than paging through everything. Document contents are not returned, only whether a copy exists.

list_chargesA

List charges (secured lending, such as mortgages and debentures) registered against a company: who holds them, when created, whether satisfied, and whether a floating charge covers everything the company owns.

A company with no charges returns an empty list, not an error.

get_registered_office_historyA

Get a company's current registered office and every recorded change to it, newest first, with old and new addresses where the register has them.

Frequent moves, or a move shortly before insolvency, are worth pointing out. Two upstream requests.

list_persons_with_significant_controlA

List who owns or controls a company (its persons with significant control): the people and companies holding over 25% of shares or votes, or the right to appoint the board, and how.

A corporate owner comes with its registration number; if it is a UK company, pass that to get_company_profile to follow the chain upwards. An empty list can mean the company filed a statement that it has no PSC, which this tool does not read.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.3/5.0

Scored across 7 tools

Disambiguation5/5

Each tool addresses a distinct Companies House resource: companies, profiles, filings, officers, charges, registered office history, and PSC. There is no meaningful overlap or ambiguity between them.

Naming Consistency5/5

Tool names follow a clear verb_noun pattern: list_* for collections and get_* for singular resources, with search_companies as the only search exception, which is still a common and predictable convention. Naming is uniform in style and case.

Tool Count5/5

Seven tools is well-scoped for the Companies House domain, covering the major public register endpoints without unnecessary bloat or fragmentation. Each tool corresponds to a meaningful API operation and earns its place.

Completeness4/5

The core Companies House surface is covered: search, company profile, filings, officers, charges, registered office history, and PSC. Minor gaps remain, such as not providing filing document contents or PSC statement details, but these do not significantly impair typical workflows.

Maintenance

ActivityMaintained
ResponsivenessNo issues