UK Due Diligence
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
UK due diligence — Companies House, Charity Commission, Land Registry, Gazette, HMRC VAT
| Author | io.github.paulieb89 |
|---|---|
| Access | mixed |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 239 ms |
| Last measured | 2026-10-24 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"UK Due Diligence": {
"url": "https://uk-due-diligence-mcp.fly.dev/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (18)
company_searchread-onlySearch the Companies House register by company name or keyword. Returns a paginated list of matching companies with name, number, status, SIC codes, incorporation date, and registered address. Use company_profile for the full record once you have the company number. Re-call with start_index=start_index+items_per_page to fetch the next page.
Parameters:
query(required) — string — Company name or keyword to search forstart_index— integer — Pagination offset. Default 0.company_type— Filter by company type (e.g. 'ltd', 'llp'). Omit to search all.company_status— Filter by company status (e.g. 'active', 'dissolved'). Omit to search all.items_per_page— integer — Number of results to return (max 100). Default 20.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
company_profileread-onlyFetch the full Companies House profile for a company number. Returns status, registered address, SIC codes, filing compliance (overdue accounts and confirmation statement flags), and whether the company has outstanding charges. Use company_search first to find the company number.
Parameters:
company_number(required) — string — Companies House company number (8 digits, e.g. '03782379'). Returned by company_search.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
company_officersread-onlyFetch officers for a Companies House company number. Returns directors, secretaries, and other officers with appointment dates, nationality, and country of residence. Resigned officers are excluded by default; set include_resigned=true for historical DD. Pagination is handled internally.
Parameters:
company_number(required) — string — Companies House company number (8 digits, e.g. '03782379'). Returned by company_search.start_index— Ignored — pagination is handled internally. Only accepted to avoid call failures.items_per_page— Ignored — pagination is handled internally. Only accepted to avoid call failures.include_resigned— boolean — Include resigned/historic officers. Default false for backwards-compatible current-officer queries.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
company_pscread-onlyFetch Persons with Significant Control (beneficial ownership) for a company. Returns PSC entries with natures of control, nationality, and country of residence. Flags overseas corporate PSC entries as a beneficial ownership risk signal. Returns an explanatory note for widely-held PLCs with no registrable PSC.
Parameters:
company_number(required) — string — Companies House company number (8 digits, e.g. '03782379'). Returned by company_search.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
officer_appointmentsread-onlyFetch a person's full company appointment history by officer ID. Returns every appointment — current and historic — with each company's number, name, status, role, and appointment/resignation dates. Use company_officers first to find an officer_id, then this tool to discover other companies that person has been a director or secretary of, including dissolved or insolvent ones not mentioned anywhere else. Always returns full history; there is no current-only filter, since historical discovery is the point.
Parameters:
officer_id(required) — string — Companies House officer ID. Returned as officer_id on entries from company_officers.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
company_chargesread-onlyFetch the complete Companies House charge history for a company. Returns every registered charge (secured debt) — current and historic — with status, dates, secured parties, and what each charge covers (fixed/floating/negative-pledge flags and any free-text particulars). Satisfaction is represented as satisfied_on plus a charge-satisfaction filing entry, not a separate 'release' record. company_profile.has_charges is a True/False/unknown summary derived from this same data; use this tool when the specific charges matter, not just whether any exist.
Parameters:
company_number(required) — string — Companies House company number (8 digits, e.g. '03782379'). Returned by company_search.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
company_filing_historyread-onlyFetch one page of a company's Companies House filing chronology. Returns the raw source facts for each filing — transaction ID, form type/category, dates, and the description_values CH uses to render its own text — as delivered upstream, not interpreted into DD conclusions. links.document_metadata on each filing is the identifier a future document-retrieval tool would need; no document content is fetched here. Unlike company_officers/company_psc/company_charges, this does NOT auto-fetch every page — a long-lived company's filing history is unbounded in practice (a decades-old PLC can carry thousands of filings). total_count/returned/has_more are always reported truthfully for whatever page and category filter was requested; nothing is silently truncated. Narrow with category= for a specific slice (e.g. category='mortgage' for charge-related filings, category='insolvency' for administration/liquidation filings) — a note is included when an unfiltered history is large. A company_number that doesn't resolve to any company returns a structured not_found error, distinct from a genuine zero-filing result — Companies House's filing-history endpoint alone cannot tell these apart, so existence is confirmed separately when the result would otherwise be empty.
Parameters:
company_number(required) — string — Companies House company number (8 digits, e.g. '03782379'). Returned by company_search.category— Filter by CH filing category — comma-separated for multiple, e.g. 'mortgage' or 'mortgage,officers'. Omit for all categories. Common values: accounts, confirmation-statement, officers, address, capital, mortgage, persons-with-significant-control, incorporation, insolvency, resolution, annual-return, change-of-name, change-of-constitution, gazette, miscellaneous.start_index— integer — Pagination offset. Default 0. Re-call with start_index=start_index+returned while has_more is true.items_per_page— integer — Results per page (Companies House caps at 100 regardless of a higher value). Default 100.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
company_filing_documentread-onlyResolve a filing's document_metadata link to its authoritative source document. Returns a resource_link (never embedded bytes, never base64) pointing at a company-document:// MCP resource — fetch it via resources/read to get the actual PDF. This tool only reads metadata (category, pages, available content types, byte size); it never downloads the document itself. Use company_filing_history first to find a filing's document_metadata URL. Requires a resource-capable MCP client to retrieve the actual bytes — a tool-only client can see this result's metadata (company, category, page count, size) but cannot obtain the file through this tool call alone.
Parameters:
document_metadata_url(required) — string — The document_metadata URL from a filing's links.document_metadata (returned by company_filing_history) — pass it through verbatim, not a document_id. Must be an exact https://document-api.company-information.service.gov.uk/document/{id} URL.mime_type— Which content representation to select, e.g. 'application/pdf'. Omit when the document has only one representation (the near-universal case) — it is auto-selected. Required if the document has more than one; omitting it in that case returns a validation error listing the choices.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
charity_searchread-onlySearch the Charity Commission register of England and Wales by name or keyword. Returns matching charities with registration number, status, and registration date. Use charity_profile for full details once you have the charity number. The upstream `searchCharityName` endpoint returns the full list in one shot — pagination is applied client-side via offset/limit. A query that matches nothing is a successful empty result (`charities: []`), not an error — the upstream endpoint signals "no matches" with an HTTP 404, which is translated back into an empty result here rather than surfaced as a not-found failure.
Parameters:
query(required) — string — Charity name or keyword to search forlimit— integer — Max items to return in this page. Default 20; raise to 100 for bulk views.offset— integer — Number of items to skip before this page. Default 0.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
charity_profileread-onlyFetch the full Charity Commission profile for a charity number. Returns trustees, latest income/expenditure, insolvency flags, governing document type, classifications, and countries of operation. Use charity_search first to find the charity number.
Parameters:
charity_number(required) — string — Charity Commission registration number (e.g. '1234567'). Returned by charity_search.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
disqualified_searchread-onlyCheck whether a named individual is banned from acting as a UK company director. Use this tool when asked to check disqualified, banned, or barred directors. Query must be an individual's name (e.g. "Richard Howson") — NOT a company name, which always returns zero results. Returns names, dates of birth, disqualification period snippets, and officer IDs that can be used with disqualified_profile for full details.
Parameters:
name— Alias for query — the person's name.query— Person's name to search for, e.g. query='Richard Howson'. NOT a company name.start_index— integer — Pagination offset (0-based). Default 0.items_per_page— integer — Results per page (max 100). Default 20.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
disqualified_profileread-onlyFetch the full disqualification record for a director by officer ID. Returns all disqualification orders: reason, Act/section cited, disqualification period, and associated company names. Use disqualified_search first to find the officer ID.
Parameters:
officer_id(required) — string — Companies House officer ID. Returned by disqualified_search.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
land_title_searchread-onlySearch HM Land Registry Price Paid Index by postcode or address. Returns up to 10 recent sale transactions for the postcode: price, date, address, property type, and tenure (Freehold/Leasehold). Covers England and Wales only. Postcode gives the most reliable results — a full address is also accepted and the postcode is extracted automatically.
Parameters:
address_or_postcode(required) — string — UK property address or postcode. Postcode is most reliable: e.g. 'NG1 1AB'. Full address also accepted.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
gazette_noticeread-onlyFetch the full legal wording of a Gazette notice by numeric notice ID. Returns the complete JSON-LD linked-data record for the notice: parties, legal basis, court, and full text. Use gazette_insolvency first to find notice_numeric_id values.
Parameters:
notice_id(required) — string — Numeric Gazette notice ID. Returned as notice_numeric_id by gazette_insolvency.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
gazette_insolvencyread-onlySearch The Gazette's insolvency notice index by entity name. Searches The Gazette's corporate-insolvency notice index using the authoritative Gazette notice-code taxonomy. Results are sorted by an internal DD severity score; the notice label itself remains a source fact. Each result includes a notice_numeric_id. Read the full legal wording via the notice://{notice_numeric_id} resource. The Gazette is the official UK public record. A notice here means the event has been formally published and is legally effective.
Parameters:
name— Company or individual name to search for in Gazette insolvency noticesquery— Alias for name.end_date— Filter notices up to this date (YYYY-MM-DD)start_date— Filter notices from this date (YYYY-MM-DD)entity_name— Deprecated alias for name.max_notices— integer — Cap on notices returned, applied after severity/date sort. Default 20. The Gazette insolvency feed returns up to 100 results per search — raise to 100 to see the full set.notice_type— Filter by Gazette notice code (e.g. '2450' petition to wind up a company, '2452' winding-up order, '2410' appointment of administrators). Omit to search all.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
sanctions_screenread-onlyScreen a name against the UK (OFSI), US (OFAC), EU and UN consolidated sanctions lists. Returns every list entry whose primary name or alias matches, with the regime, source reference and listing date. Use it to check whether a counterparty — or its officers / persons with significant control — appears on a sanctions list. MATCHING is deterministic: normalised exact + alias match (case-, accent- and punctuation-insensitive). A company/entity legal name matches reliably; PERSON names with transliteration variants may not (e.g. 'Mohammed' vs 'Muhamad'). An empty result is therefore NOT a guarantee of clearance, and a hit on a common name may be a false positive to disambiguate. This is a screening aid, not a compliance determination. `lists_screened` reports which of OFSI/OFAC/EU/UN were actually loaded; `lists_unavailable` names those that were not, and `is_partial` is true whenever it is non-empty. When `is_partial` is true an empty `hits` is UNRESOLVED, not clearance. If no list could be loaded at all the call raises a retryable error rather than returning an empty screen. `as_at` is when the lists were last refreshed on this server.
Parameters:
name(required) — string — Person or company/entity name to screen against the consolidated sanctions lists.entity_type— Optional filter: 'person' or 'entity'. Omit to screen both.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
searchread-onlySearch across all UK due diligence registers simultaneously. Searches Companies House, Charity Commission, disqualified directors, and Gazette insolvency notices in parallel. Returns a list of result IDs — use fetch with each ID to retrieve the full record. `registers_searched` names the registers that actually answered and `registers_unavailable` those that failed; `is_partial` is true whenever the latter is non-empty. An empty `ids` with `is_partial` true means UNRESOLVED, not "nothing on record". If no register answers at all the call raises rather than returning an empty result.
Parameters:
query(required) — string — Company name, charity name, director name, or keyword to search for across all UK due diligence registers
Hints: read-only yes · destructive no · idempotent yes · open-world yes
fetchread-onlyFetch the full record for an ID returned by search. Routes by prefix to the appropriate register: - company:{number} → Companies House full profile - charity:{number} → Charity Commission full profile - disqualification:{officer_id} → Disqualified director full record - notice:{notice_id} → Gazette notice full legal text
Parameters:
id(required) — string — Prefixed record ID returned by search. Format: company:{number}, charity:{number}, disqualification:{officer_id}, or notice:{notice_id}
Hints: read-only yes · destructive no · idempotent yes · open-world yes
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.