# get_company_people

The people who work, or have worked, at an organisation.

Canonical: https://chikaraintel.com/docs/mcp/tools/get_company_people

Group: Companies. Read only.

## When to use

Use it to build a shortlist or an org chart from one company. Results are grouped into current executives, current professionals and alumni. Pass `currentOnly: true` to drop alumni.

Call `search_companies` first.

## Parameters

- `reference` (uuid, body, required) The company's reference UUID.
- `currentOnly` (boolean, body) If true, only return current employees (excludes alumni) Default `false`.

Executives are picked out by job title. A title the matcher doesn't recognise lands under `current_professionals`.

## Example

Prompt: "Who's on the leadership team at Halberd Industrial Group?"

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_company_people",
    "arguments": {
      "reference": "3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
      "currentOnly": true
    }
  }
}
```

Result (invented records):

```json
{
  "current_executives": [
    {
      "reference": "a1b2c3d4-e5f6-4a7b-9c8d-e9f0a1b2c341",
      "name": "Elena Marchetti",
      "role": {
        "title": "Chief Financial Officer",
        "organisation": "Halberd Industrial Group",
        "start_date": "2026-09-01",
        "end_date": null
      }
    },
    {
      "reference": "d4e5f6a7-b8c9-4d0e-9f2a-b3c4d5e6f771",
      "name": "Daniel Reyes",
      "role": {
        "title": "Chair",
        "organisation": "Halberd Industrial Group",
        "start_date": "2021-05-12",
        "end_date": null
      }
    }
  ],
  "current_professionals": []
}
```

## Errors

- `Not found.`: No organisation has that reference.

## Built on

- GET /v1/organisations/{organisationReference}/people (https://chikaraintel.com/docs/api/reference/organisations/list-organisation-people.md)
