MCP tool · People
search_people
Find people by name, optionally narrowed to one organisation or a profile type.
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
querystring·bodyrequired- Name or partial name to search for.
limitinteger·body- Max results to return (default 20, max 100) Range 1 to 100.Default
20 organisationReferenceuuid·body- Filter people who work or have worked at this organisation UUID.
profileTypestring·body- Filter by profile type.
business_ownerinvestment_advisorbroker
Example
Ask your assistant something like this, and it makes the call below. The result is shown as the JSON the tool returns, which reaches the assistant as a text content item.
Find Elena Marchetti at Halberd Industrial Group.Example records are invented.
Errors
These come back as a tool result with isError: true, so the assistant can read the reason and try again.
Invalid arguments for tool search_people: …An argument fails the schema, such as alimitabove 100.
Built on
The tool calls this endpoint with your own token. Use the API directly to get the same data into your own systems.
Related
- ConceptPeopleA profile is one person: who they are, where they've worked, and what they hold.
- ConceptReferencesEvery person, organisation and event has a UUID reference. Filters take references, never names.
- MCP tool · Peopleget_personOne person in full: work history, emails, ownership stakes and statements.
- MCP tool · Companiesget_company_peopleThe people who work, or have worked, at an organisation.