# search_people

Find people by name, optionally narrowed to one organisation or a profile type.

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

Group: People. Read only.

## When to use

Use it to turn a person's name into a reference before calling get_person, or to list the people linked to a company whose name you already know. Matching is a substring match on the full name, so a surname alone often works best.

## Parameters

- `query` (string, body, required) Name or partial name to search for.
- `limit` (integer, body) Max results to return (default 20, max 100) Range 1 to 100. Default `20`.
- `organisationReference` (uuid, body) Filter people who work or have worked at this organisation UUID.
- `profileType` (string, body) Filter by profile type. Values: `business_owner`, `investment_advisor`, `broker`.

## Example

Prompt: "Find Elena Marchetti at Halberd Industrial Group."

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_people",
    "arguments": {
      "query": "Marchetti",
      "organisationReference": "3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
      "limit": 5
    }
  }
}
```

Result (invented records):

```json
[
  {
    "reference": "a1b2c3d4-e5f6-4a7b-9c8d-e9f0a1b2c341",
    "name": "Elena Marchetti",
    "first_name": "Elena",
    "last_name": "Marchetti",
    "linkedin_url": null,
    "confidence_score": 0.92,
    "current_role": {
      "title": "Chief Financial Officer",
      "organisation": "Halberd Industrial Group",
      "start_date": "2026-09-01"
    }
  }
]
```

## Errors

- `Invalid arguments for tool search_people: …`: An argument fails the schema, such as a `limit` above 100.

## Built on

- GET /v1/profiles (https://chikaraintel.com/docs/api/reference/profiles/list-profiles.md)