Shortlist candidates
Shortlist candidates to an open job.
MCP tool vincere_write → shortlist_candidates
write Confirm
Moves the candidates to the Shortlisted stage of one open job, like Shortlist in the Candidates table. It sends nothing to the candidates or the client. A closed job, a job with no headcount left or a passed Sourcing closed date is refused, and the candidates are returned in skipped with the reason. Vincere allows 300 selected records at once. Moving a candidate back needs Remove Application in Vincere. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id string required | string | Job id from list_jobs. The job must be open. |
| candidate_ids array required | array | Candidate ids from list_candidates, up to 300. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "vincere_write",
"arguments": {
"operation": "shortlist_candidates",
"arguments": {
"job_id": "1042",
"candidate_ids": [
"88214",
"88230"
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"job_id": "1042",
"shortlisted": [
{
"candidate_id": "88214",
"name": "Priya Nair",
"stage": "shortlisted"
},
{
"candidate_id": "88230",
"name": "Tomas Wu",
"stage": "shortlisted"
}
],
"skipped": []
},
"isError": false
}