MCP tool · Companies

get_company_people

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

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 to get the reference this tool needs.

Parameters

referenceuuid·bodyrequired
The company's reference UUID.
currentOnlyboolean·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

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.

Who's on the leadership team 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.

  • Not found.No organisation has that reference.

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