Check a people search
get_people_searchRead a people search without starting anything. With operationId: the progress or results of a search find_people started; poll it after a short wait until status is completed or failed, and never start a new request to check progress. When it completed, show the targeting from plan.targetingSummary, then every candidate neutrally in retrieval order with name, current title, company, LinkedIn URL and match reason; never rank, shortlist or silently drop anyone, record the customer's add and skip choices with review_people, and mention any companyResolution outcome of matched_several or unmatched in one line. With playId: a saved Play's complete targeting, so you can tell the customer in plain words what it looks for and they can say what to change (revise or rerun it with find_people). Read-only: spends no Energy, saves nothing and contacts no one. Returns the operation's status, plan, batch and candidates, or the Play's plan and whether the balance can run it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_people_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| playId | No | A saved Play's ID from get_workspace or an earlier find_people result; reads its targeting. | |
| operationId | No | The operationId a find_people call returned; reads that search's progress or results. | |
| workspaceId | No | A teammate's workspace you may manage: an active workspace ID from list_team_workspaces. Omit for your own workspace. Supply on every call for a teammate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list | No | Founder list: which list was read. | |
| next | No | The suggested next call, or null. | |
| plan | No | The saved Play's plan. | |
| play | No | The Play this call saved or read. | |
| batch | No | The review batch of found people. | |
| found | No | Founder list run: how many people were found. | |
| energy | No | When the balance falls short: Energy required, remaining and the step that gets more. | |
| filter | No | Founder list: the filters applied. | |
| status | No | The operation's status: queued, running, completed or failed (or a start status for a list or account list). | |
| message | No | A line to relay to the customer. | |
| options | No | Founder list: the filter values to offer. | |
| playUrl | No | The Play's page, where found people are reviewed. | |
| accounts | No | Account list: the groups and companies. | |
| matching | No | Founder list: how many founders match. | |
| nextStep | No | What to tell the customer next. | |
| reviewIn | No | Where and when found people appear for review. | |
| searched | No | Whether this call searched for people. | |
| companies | No | Account list or template Play: the companies involved. | |
| contacted | No | Always false: finding people never contacts anyone. | |
| reviewUrl | No | The attached sequence's page. | |
| candidates | No | Found people in retrieval order; show every one, never ranked or dropped. | |
| enrollment | No | Founder list run: who was added to the sequence. | |
| readyToRun | No | false when the balance cannot pay for a run; message and energy say why. | |
| operationId | No | The saved search operation; poll it with get_people_search. | |
| wouldCreate | No | Template Play preview: what confirmed=true would create. | |
| companyResolution | No | How each named company resolved: matched, matched_several or unmatched. | |
| groupsWaitingForEnergy | No | Account list: groups not started because Energy ran short. |