List the hiring pipeline
listPipelineList the company's hiring pipeline, the same board the Pipeline page of the dashboard renders: every candidate grouped by stage, with a count per stage.
Stages in order: review (awaiting the company's review), intro_requested (intro in progress), introduced (awaiting first interview), interviewing, offer, hired. Each candidate includes opportunityId, talentId, talentName, roleId, roleName, and for interviewing candidates interviewStage (e.g. "Technical screen (2 of 3)") and nextInterviewAt. When nextInterviewIsDayOnly is true only the day is agreed: nextInterviewAt is that day at 00:00 UTC, so name the day and never a time.
roleCounts gives the board total per role, largest first. It is the only candidate count per role; the job tool's list command carries none.
Use it for any question about how many candidates are in the pipeline, how many a role has, who is interviewing, or which stage someone is at. To decline someone already in the pipeline, pass their opportunityId, talentName and roleName to passCandidate; a review row with a null opportunityId is declined from listRecommendedCandidates instead. Counts cover the whole stage, candidates are capped by candidatesPerStage.
Clera privately records this tool's inputs and results for usage tracking and support.
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": "listPipeline"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orgId | No | Organization to act as. Only needed when you belong to more than one organization. | |
| roleId | No | Optional role ID to filter to a specific role, resolved with the job tool's list command. Omit for all roles. | |
| candidatesPerStage | No | How many candidates to list per stage (max 50). Counts always cover the whole stage. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stages | Yes | ||
| roleCounts | Yes | ||
| totalCount | Yes |