ukvet-mcp

MCP server for UK Companies House data. Gives Claude Desktop, Cursor and any other MCP client reliable, citable access to official company records: status, directors, controllers, charges, insolvency and filing history.

Part of ukvet (an AI due-diligence agent with an evaluation benchmark). This package is the data layer and works on its own.

Why another Companies House server?

It focuses on correctness, not just endpoint coverage:

• Every result is citable: {found, data, source, notes}, where source.url is the public Companies House page and retrieved_at says how fresh it is.
• "No data" is not an error. A company with no charges returns found: false, and a 404 on a sub-endpoint is checked against the company profile so "no insolvency record" is never reported for a company that doesn't exist.
• Computed facts, not LLM arithmetic: company age, status counts, outstanding-charge counts.
• Data minimisation: no dates of birth, home addresses, nationality or occupation (UK GDPR).
• Safe by construction: sliding-window rate limiter (never exceeds the 600/5 min limit), retries with backoff, hard pagination caps, short-lived cache, API key never logged.

Install

You need a free Companies House API key: create an application at https://developer.company-information.service.gov.uk/ and add a REST key for the live environment.

CH_API_KEY=your-key uvx ukvet-mcp --check     # verifies the key, prints OK

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop:

{
  "mcpServers": {
    "ukvet": {
      "command": "uvx",
      "args": ["ukvet-mcp"],
      "env": { "CH_API_KEY": "your-key" }
    }
  }
}

Try: "Is Tesco PLC active, who are its directors, and does it have any outstanding charges?"

Claude setup guide: ukvet\development\setup\claude-desktop-ukvet-setup.md

Cursor and other clients

Same command and environment variable: uvx ukvet-mcp, transport stdio.

Tools

Configuration

Limits (read these)

• Data can be up to 24 hours old (cache); source.retrieved_at shows the real timestamp.
• Results are capped (UKVET_MAX_ITEMS); truncation is always reported in notes.
• The same real person can appear under several officer IDs, so director track records can be incomplete. Treat them as a lower bound.
• PSC found: false does not prove a company has no owner (it may be exempt or have filed a statement, which this server does not cover).
• Only Companies House API data: no Gazette, FCA register or filed-accounts contents.

Attribution and disclaimer

Contains public sector information licensed under the Open Government Licence v3.0 (Companies House). Not affiliated with or endorsed by Companies House. Informational only; not legal, financial or credit advice.

MIT licence.