Odel
UK Due Diligence

UK Due Diligence

@paulieb89Developer Tools2PythonMITUpdated 1mo ago

UK due diligence — Companies House, Charity Commission, Land Registry, Gazette, HMRC VAT

Server endpointStreamable HTTP

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

uk-due-diligence-mcp

Tools across five UK public registers. Zero paywalls. All official APIs.

Give an agent a company name and it pulls corporate status, filing compliance, director networks, beneficial ownership chains, disqualification checks, insolvency notices, VAT validation, and property transactions.

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

PyPI SafeSkill Glama smithery badge Install in VS Code Install in VS Code Insiders Install in Cursor


Data Sources

RegisterAPIAuth
Companies Houseapi.company-information.service.gov.ukAPI key (free)
Charity Commissionapi.charitycommission.gov.ukAPI key (free)
HMLR Land Registrylandregistry.data.gov.uk (SPARQL + REST)None
The Gazettethegazette.co.uk/all-notices (Linked Data)None
HMRC VATapi.service.hmrc.gov.ukNone

Tools

ToolRegisterDescription
company_searchCompanies HouseSearch by name/keyword with status/type filters
company_profileCompanies HouseFull profile: status, filing compliance, charges
company_officersCompanies HouseDirectors with high-appointment-count risk flag
company_pscCompanies HouseBeneficial owners, PSC chain, offshore flags
disqualified_searchCompanies HouseSearch disqualified directors by name
disqualified_profileCompanies HouseFull disqualification record, period, Act, companies
charity_searchCharity CommissionSearch by name, filter by registration status
charity_profileCharity CommissionFull record: trustees, finances, governing doc
land_title_searchHMLRProperty ownership via SPARQL PPI query
gazette_insolvencyThe GazetteCorporate insolvency notices (codes 2441-2460)
gazette_noticeThe GazetteFull legal wording of a specific insolvency notice
vat_validateHMRC VATTrading name + address as registered for VAT
searchAll registersFan-out search across all registers — returns IDs for ChatGPT deep research
fetchAll registersFetch a structured record by ID returned from search

Prompts

Three workflow prompts orchestrate multi-step investigations. Available via get_prompt on tool-only clients (ChatGPT) and natively on protocol-aware clients (Claude, Inspector).

PromptDescription
due_diligenceFull DD check — company, officers, PSC, gazette, disqualification
charity_due_diligenceCharity profile + insolvency check
director_checkDisqualification status check for an individual

Connect

Hosted (no install)

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

Local (uvx)

export CH_API_KEY=your_key
export CHARITY_API_KEY=your_key
{
  "mcpServers": {
    "uk-due-diligence": {
      "type": "stdio",
      "command": "uvx",
      "args": ["uk-due-diligence-mcp"]
    }
  }
}

API Keys

KeyWhere to get it
CH_API_KEYdeveloper.company-information.service.gov.uk — free
CHARITY_API_KEYapi-portal.charitycommission.gov.uk — free

HMLR, Gazette, and HMRC VAT require no API key.


Demo

Run due diligence on Carillion PLC

The agent calls company_search to resolve the company number, then company_profile, company_officers, company_psc, and gazette_insolvency — reasoning across all five registries to surface risk signals.


Project Structure

uk-due-diligence-mcp/
├── server.py           # FastMCP init, tool registration, transport config
├── companies_house.py  # company_search, company_profile, company_officers, company_psc
├── disqualified.py     # disqualified_search, disqualified_profile
├── charity.py          # charity_search, charity_profile
├── land_registry.py    # land_title_search (SPARQL + REST)
├── gazette.py          # gazette_insolvency (JSON-LD, notice codes 2441-2460)
├── hmrc_vat.py         # vat_validate
├── http_client.py      # Shared httpx clients, retry backoff, error formatting
├── inputs.py           # Pydantic v2 input models
├── fly.toml
├── Dockerfile
├── pyproject.toml
└── .env.example

Technical Notes

The Gazette API

REST+RDF linked-data pattern. Corporate insolvency notice codes span 2441-2460. The read API is unauthenticated; auth is write-only (for placing notices).

HMLR Land Registry

Free endpoint at api.landregistry.data.gov.uk. Returns RDF/Turtle by default — the SPARQL endpoint is used for Price Paid Index queries. Covers England and Wales only.

High-Appointment-Count Signal

Directors with 10+ other active appointments are flagged. A director on 40+ companies is a common pattern in nominee director operations and phoenix company structures.


Licence

MIT