io.github.aicayzer/companies-house
MCP server and CLI for the UK Companies House API. Search, filings, officers, due diligence.
Ask AI about io.github.aicayzer/companies-house
Powered by Claude Β· Grounded in docs
I know everything about io.github.aicayzer/companies-house. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Companies House CLI & MCP
An unofficial CLI and MCP server for the UK Companies House API. Look up any UK company, check its officers, trace ownership, dig into filings, run a due diligence scan β from your terminal, your scripts, or directly inside Claude, Cursor, or any other AI tool that speaks MCP.
Everything runs on a free API key. No backend, no subscriptions, no middleman.
Documentation: companies-house.uk
Install
CLI β installs the ch binary:
npm install -g companies-house-cli
ch config set-key your-key-here
MCP server β for Claude, Cursor, Zed, and others:
npx -y companies-house-mcp
Both packages use the same free API key from developer.company-information.service.gov.uk.
What it can do
Search and lookup
search_companies/ch searchβ find companies by name, with filters for status, type, SIC code, and locationsearch_officers/ch search-officersβ find officers across all companies by nameget_company_profile/ch profileβ full company profile: status, addresses, SIC codes, key dates
Officers and ownership
get_officers/ch officersβ current and resigned directors, secretaries, and other officersget_appointmentsβ every company a given officer has ever been appointed toget_ownership/ch ownershipβ persons with significant control (PSCs), corporate ownership chains
Filings and financials
get_filings/ch filingsβ full filing history with document links, filterable by categoryget_filing_documentβ retrieve an individual filing documentget_charges/ch chargesβ charges and mortgages registered against the companyget_insolvency/ch insolvencyβ insolvency proceedings, liquidations, administrations
Due diligence
company_report/ch reportβ everything in one call: profile, officers, ownership, charges, filings, insolvencydue_diligence_check/ch checkβ automated red-flag scan with HIGH / MEDIUM / LOW severity ratingsofficer_network/ch networkβ map a director's connections across every company they're linked to
Extended
get_company_registersβ statutory registers (members, directors, secretaries, charges)get_exemptionsβ disclosure exemptionsget_uk_establishmentsβ UK establishments of overseas companiesget_officer_disqualificationsβ disqualification orders made against an officer
CLI quick reference
ch search "Anthropic"
ch profile 14604577
ch officers 14604577 --all
ch ownership 14604577
ch filings 14604577 --category accounts
ch charges 14604577
ch report 14604577
ch check 14604577
ch network "John Smith"
ch report 14604577 --json | jq '.profile.company_status'
ch report 14604577 --md > report.md
Full reference, flags, and output modes at companies-house.uk/cli.
MCP setup
Add to your client config with your API key and run npx -y companies-house-mcp. Detailed setup for Claude Desktop, Claude Code, Cursor, and Zed at companies-house.uk/mcp.
Development
git clone https://github.com/aicayzer/companies-house-mcp.git
cd companies-house-mcp
pnpm install && pnpm build && pnpm test:unit
See CONTRIBUTING.md for the full guide. Docs at companies-house.uk.
Disclaimer
Not affiliated with or endorsed by Companies House or the UK Government. Uses the publicly available Companies House API.
Licence
MIT
