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.
- Inputs: query, limit (optional)
- Limits: Counts one lookup. At most 25 results.
get_company
Company profile: status, type, incorporation date, registered office, SIC codes, accounts and confirmation statement due dates and overdue flags.
- Inputs: company_number
- Limits: Counts one lookup.
get_officers
Current and resigned officers (directors and secretaries) with roles and dates.
- Inputs: company_number, include_resigned (optional)
- Limits: Counts one lookup. Up to 100 officers.
get_psc
Persons with significant control and the nature of their control.
- Inputs: company_number, include_ceased (optional)
- Limits: Counts one lookup. Up to 100 entries.
get_filings
Filing history, newest first, with links to the filed documents.
- Inputs: company_number, limit (optional), category (optional)
- Limits: Counts one lookup. At most 100 filings.
get_charges
Registered charges (mortgages and security) with status and dates.
- Inputs: company_number
- Limits: Counts one lookup.
add_watch
Adds a company to the watchlist and records its current state as the baseline.
- Inputs: company_number, watch (optional: filings, officers, psc, status, charges; default all)
- Limits: Counts one lookup. Watched-company limit by plan.
list_watches
Lists watched companies with what is watched and when each was last checked.
- Inputs: none
- Limits: No quota.
remove_watch
Removes a company from the watchlist.
- Inputs: company_number
- Limits: No quota.
check_now
Checks one watched company immediately and reports and records any changes.
- Inputs: company_number
- Limits: Counts one lookup.
get_alerts
Recorded alerts, unseen first; marks the returned alerts as seen.
- Inputs: limit (optional), include_seen (optional)
- Limits: No quota.
account_status
Shows the account email, plan, usage and limits.
- Inputs: none
- Limits: none
activate_license
Binds a licence key to the account.
- Inputs: license_key (string)
- Limits: Key must belong to this product.
Plan limits
| Limit | Free | Pro |
|---|---|---|
| lookups | 50 | 2000 |
| watched companies | 3 | 150 |
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.