ats_manage_candidates
Add, update, delete, move, and filter candidates in the ATS pipeline.
Instructions
Manage candidates in the ATS pipeline. Supports add, update, delete, move between stages, bulk move, and list/filter operations. Pass the current candidates record and an action to perform. Returns the updated candidates and a summary.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"candidates": "<candidates>",
"action": "<action>"
},
"name": "ats_manage_candidates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform. Types: - { type: "add", candidate: { firstName, lastName, email, phone?, jobId, currentStage?, tags?, source? } } - { type: "update", candidateId: string, fields: { partial candidate fields } } - { type: "delete", candidateId: string } - { type: "move", move: { candidateId, newStage } } - { type: "bulk_move", moves: [{ candidateId, newStage }, ...] } - { type: "list", jobId?: string, stage?: string } | |
| candidates | Yes | Current candidates record (id → candidate object). Pass {} for a fresh start. |