Documentation

Tools exposed by Companies House Watch and the limits that apply.

Connect

Server URL: https://chwatch.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.

Tools

search_companies

Searches the Companies House register by company name.

Find UK companies named "Lumenary".

get_company

Company profile: status, type, incorporation date, registered office, SIC codes, accounts and confirmation statement due dates and overdue flags.

Show the profile of company 00445790.

get_officers

Current and resigned officers (directors and secretaries) with roles and dates.

Who are the directors of 00445790?

get_psc

Persons with significant control and the nature of their control.

Who owns or controls 00445790?

get_filings

Filing history, newest first, with links to the filed documents.

Show the latest 10 filings for 00445790.

get_charges

Registered charges (mortgages and security) with status and dates.

Does 00445790 have outstanding charges?

add_watch

Adds a company to the watchlist and records its current state as the baseline.

Watch 00445790 for new filings and officer changes.

list_watches

Lists watched companies with what is watched and when each was last checked.

Which companies am I watching?

remove_watch

Removes a company from the watchlist.

Stop watching 00445790.

check_now

Checks one watched company immediately and reports and records any changes.

Check 00445790 now.

get_alerts

Recorded alerts, unseen first; marks the returned alerts as seen.

Any changes on my watched companies?

account_status

Shows the account email, plan, usage and limits.

Show my account status.

activate_license

Binds a licence key to the account.

Activate licence key XXXX-XXXX.

Plan limits

LimitFreePro
lookups502000
watched companies3150

Network behaviour

Outbound requests use the user agent TidyButtonBot/1.0 (+https://chwatch.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.