Skip to main content
Glama
README.md
# uk-due-diligence-mcp

Maintained by BOUCH — private hosting, custom tools and setup: paul@bouch.dev · [bouch.dev/products/uk-due-diligence-mcp](https://bouch.dev/products/uk-due-diligence-mcp)

<!-- mcp-name: io.github.paulieb89/uk-due-diligence-mcp -->

**Official-source UK due-diligence data for AI agents.**

Search Companies House, Charity Commission, The Gazette and HMLR price-paid data, plus screen names against the UK (FCDO), OFAC, EU and UN sanctions lists. Exposes atomic MCP tools for company ownership, officers, cross-company appointment history, secured charges, insolvency notices and related registry evidence — the consuming agent decides how to investigate, not the server.

Every data source is a legally-mandated register with a free official API. Zero paywalls.

[![PyPI](https://img.shields.io/pypi/v/uk-due-diligence-mcp)](https://pypi.org/project/uk-due-diligence-mcp/)
[![SafeSkill](https://safeskill.dev/api/badge/paulieb89-uk-due-diligence-mcp)](https://safeskill.dev/scan/paulieb89-uk-due-diligence-mcp)
[![Glama](https://img.shields.io/badge/Glama-listed-orange?style=flat-square)](https://glama.ai/mcp/connectors/io.github.paulieb89/uk-due-diligence-mcp)
[![smithery badge](https://smithery.ai/badge/bouch/uk-due-diligence)](https://smithery.ai/servers/bouch/uk-due-diligence)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=uk-due-diligence&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fuk-due-diligence-mcp.fly.dev%2Fmcp%22%7D)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=uk-due-diligence&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fuk-due-diligence-mcp.fly.dev%2Fmcp%22%7D&quality=insiders)
[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-000000?style=flat-square&logoColor=white)](https://cursor.com/en/install-mcp?name=uk-due-diligence&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vdWstZHVlLWRpbGlnZW5jZS1tY3AuZmx5LmRldi9tY3AifQ==)

---

## Data sources

| Register | API | Auth | Coverage |
|----------|-----|------|----------|
| Companies House | `api.company-information.service.gov.uk` | API key (free) | UK-wide |
| Charity Commission | `api.charitycommission.gov.uk` | API key (free) | England & Wales |
| HMLR Land Registry | `landregistry.data.gov.uk` (SPARQL) | None | England & Wales |
| The Gazette | `thegazette.co.uk` (Linked Data) | None (read) | UK-wide |
| UK (FCDO) / OFAC / EU / UN sanctions | consolidated list files | None | International |

---

## Connect

Hosted endpoint — no install, no API key:

```text
https://uk-due-diligence-mcp.fly.dev/mcp
```

### Claude (web, desktop and mobile)

1. Open **Customize → Connectors** ([claude.ai/customize/connectors](https://claude.ai/customize/connectors)).
2. Click **Add custom connector**.
3. Name it `uk-due-diligence`, paste the URL above and click **Add**. No sign-in is needed.

That's it — no config file to edit and no restart. Add the connector on web or desktop, and it's then available on your account, including the mobile apps. Turn it on or off per chat from the **+** menu → **Connectors**. On Team and Enterprise plans an Owner adds it once under **Organization settings → Connectors**; Free plans can add one custom connector.

### Claude Code

If you've added the connector above, Claude Code lists it under `/mcp` — but only when Claude Code is signed in with your claude.ai subscription login, not an API key. Otherwise, add it directly:

```bash
claude mcp add --transport http --scope user uk-due-diligence https://uk-due-diligence-mcp.fly.dev/mcp
```

### Other clients

VS Code and Cursor: use the install badges at the top of this page. For clients configured with `mcpServers` JSON:

```json
{
  "mcpServers": {
    "uk-due-diligence": {
      "type": "http",
      "url": "https://uk-due-diligence-mcp.fly.dev/mcp"
    }
  }
}
```

### Run it locally (stdio)

Local stdio mode isn't supported yet ([#51](https://github.com/paulieb89/uk-due-diligence-mcp/issues/51)); use the hosted endpoint.

---

## Tools

The authoritative, generated list of tools and resources is [docs/tool-reference.md](docs/tool-reference.md); the tables below are a guide.

**Companies House**

| Tool | Description |
|------|-------------|
| `company_search` | Search by name/keyword, filter by status/type |
| `company_profile` | Status, filing compliance, registered address, `has_charges` summary |
| `company_officers` | Directors/secretaries; each carries an `officer_id` |
| `company_psc` | Beneficial owners, PSC chain, overseas-corporate-PSC flag |
| `officer_appointments` | Full appointment history for a person by `officer_id` — including dissolved or insolvent companies not named anywhere else |
| `company_charges` | Complete secured-charge history: status, dates, secured parties, what each charge covers |
| `company_filing_history` | One page of a company's filing chronology (form types, dates); narrow with `category` |
| `company_filing_document` | Resolve a filing's `document_metadata` link to its source document, returned as a `company-document://` resource link |
| `disqualified_search` | Search disqualified directors by name |
| `disqualified_profile` | Full disqualification record: period, Act, associated companies |

**Charity Commission**

| Tool | Description |
|------|-------------|
| `charity_search` | Search by name, filter by registration status |
| `charity_profile` | Full record: trustees, income/expenditure, governing document |

**HMLR Land Registry**

| Tool | Description |
|------|-------------|
| `land_title_search` | Price Paid Index sale transactions by postcode — not title ownership (see [Limitations](#limitations)) |

**The Gazette**

| Tool | Description |
|------|-------------|
| `gazette_insolvency` | Corporate insolvency notices across the Gazette's notice-code taxonomy (codes 2401-2465) |
| `gazette_notice` | Full legal wording of a specific notice |

**Sanctions**

| Tool | Description |
|------|-------------|
| `sanctions_screen` | Screen a name against the UK (FCDO), OFAC, EU and UN consolidated lists |

The UK list is the FCDO UK Sanctions List XML and is reported under the label `OFSI (UK)`. The parser refuses an incomplete export: a file below a minimum designation count, a sharp drop against the previous load in the same process, a duplicate `UniqueID`, or a missing `DateGenerated` fails the UK list, which is then reported in `lists_unavailable` with `is_partial` true. The floor and drop threshold are constants in `sanctions.py`.

**Cross-register**

| Tool | Description |
|------|-------------|
| `search` | Fan-out search across all registers — returns IDs (for ChatGPT deep research) |
| `fetch` | Fetch a structured record by ID returned from `search` |

---

## Examples

```
Resolve "TAS Engineering" to a company number and check whether it has any outstanding charges.
```
→ `company_search` to find the company number, then `company_charges` for the full secured-debt picture (not just the `has_charges` summary).

```
Has Gareth Davies (director of company 06333469) been connected to any other companies, including ones that no longer exist?
```
→ `company_officers` to get his `officer_id`, then `officer_appointments` to surface every company he's held an appointment at, current or historic.

```
Is "MEL Precision Limited" in the middle of insolvency proceedings, and what does that actually mean legally?
```
→ `gazette_insolvency` to find the notices, then `gazette_notice` to read the full legal wording before drawing conclusions from the notice label alone.

```
Screen "Acme Trading Ltd" and its officers against sanctions lists.
```
→ `company_officers` for the officer names, then `sanctions_screen` against the company name and each officer.

---

## Limitations

Things worth knowing before trusting output:

- **`land_title_search` returns Price Paid transactions, not ownership.** It does not return current proprietor/title data — HMLR's Price Paid Index only records historic sale transactions.
- **Sanctions screening is exact/alias matching, not compliance clearance.** A company/entity legal name matches reliably; person names with transliteration variants may not. An empty result is not a guarantee of clearance, and a hit on a common name may need disambiguation.
- **`has_charges: null` means the check could not be confidently completed** — a charges-endpoint outage, or a charge with an unrecognized status. Treat it as unresolved, not as "no charges."
- **`officer_appointments` returns historical relationships.** Companies House doesn't auto-resign a director when a company enters insolvency — check `company_status` on each appointment, not just `resigned_on`.
- **Official-source data can be incomplete or delayed.** These are the same registers a human would check, with the same latency and gaps.

---

## Configuration

| Variable | Required for | Where to get it |
|----------|--------------|------------------|
| `CH_API_KEY` | All Companies House tools | [developer.company-information.service.gov.uk](https://developer.company-information.service.gov.uk) — free |
| `CHARITY_API_KEY` | Charity Commission tools | [api-portal.charitycommission.gov.uk](https://api-portal.charitycommission.gov.uk) — free |

HMLR, The Gazette, and the sanctions lists require no credentials.

---

## Licence

MIT

<!-- mcp-name: io.github.paulieb89/uk-due-diligence-mcp -->

TDQS

A4.2/5.0

Scored across 18 tools

Disambiguation4/5

Each register-specific tool has a clearly distinct resource+aspect (officers, PSC, charges, filing history, disqualifications, sanctions, land titles), so per-register selection is unambiguous. The main overlap comes from the generic meta-tools `fetch` and `search`, which duplicate company_profile/charity_profile/disqualified_profile/gazette_notice and the three *_search tools respectively; descriptions explain the routing and either choice returns valid data, so the ambiguity is low-harm rather than confusing.

Naming Consistency4/5

The dominant pattern is consistent entity-first naming (company_*, charity_*, disqualified_*, gazette_*, land_title_search, sanctions_screen, officer_appointments). The only deviations are the two bare-verb convenience tools `fetch` and `search`, plus singular `officer_appointments` where other tools use register plurals—minor and still readable.

Tool Count4/5

18 tools is at the upper end but justified: it spans four registers (Companies House, Charity Commission, disqualified directors, Gazette), sanctions lists, and Land Registry, each with a search+detail pair. Nearly every tool earns its place; only `fetch` is arguably redundant with the four profile tools it shadows.

Completeness4/5

Coverage is broad and lifecycle-complete for the read-only DD task: search→profile→officers/PSC/charges→filings→documents is fully chainable, with sanctions, insolvency, charity and property layers on top. Gaps remain: no accounts/financial-figures tool (filing history gives only raw filing facts), no person-name → directorships search without first having a company (officer_appointments needs an officer_id), and no Scottish/NI registers—but these are workaroundable or explicitly out of scope.

Maintenance

ActivityMaintained
ResponsivenessLimited data