# osintverse-community/companies-house

Searches the UK Companies House register: companies, their status and office, officers and controlling owners

## Install and run

```sh
ot install osintverse-community/companies-house
ot run osintverse-community/companies-house
```

The first `ot run` installs the tool after asking once. New to `ot`? See https://otinstaller.com/docs/getting-started.

From an AI agent, through ot's MCP server (`ot mcp`):

```
run_tool {"tool":"osintverse-community/companies-house","inputs":{"company":"Tesco"}}
```

## Inputs

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `company` | company | no |  | Company name to search for (give a name or a number) |
| `number` | string | no |  | Company number, to read its profile, officers and people with significant control (give a name or a number) |
| `limit` | integer | no | `20` | Most companies a name search returns (up to 100) |

## Outputs

Finds: organization, person, location.

- `organization`: Companies, and corporate officers or owners
- `person`: Officers and people with significant control, as the public register lists them
- `location`: The registered office

## What a run does

- Does not contact the target.
- Collects personal data.
- Needs an account (it logs in, or uses an account or API key of yours).
- Does not notify the target.
- Usually takes about 3 seconds.
- Publisher's note: Returns officers and people with significant control, with the month and year of birth the public register shows.
- Connects to api.company-information.service.gov.uk.

An agent needs the person's consent before running this tool, because it collects personal data. See https://otinstaller.com/docs/agents#consent.

## API keys

- `COMPANIES_HOUSE_API_KEY` (required, free): A free REST API key from the Companies House developer hub (live environment) Get one at https://developer.company-information.service.gov.uk/

Store a key with `ot keys set NAME`; it stays in the OS keychain.

## Trust

- Latest version: 0.1.0
- Signed: yes
- Verified publisher: yes
- Health: unknown
- Installs in the last 30 days: 0
- License: MIT
- Runtime: Docker image, pinned by digest
- Repository: https://github.com/osintverse-community/companies-house

## Links

- Web page: https://otinstaller.com/osintverse-community/companies-house
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/companies-house
- README: https://github.com/osintverse-community/companies-house#readme
- Security details: https://otinstaller.com/osintverse-community/companies-house/security
- Report a problem: https://otinstaller.com/osintverse-community/companies-house/report