Get candidate
One candidate with contact details, tags, custom fields, jobs with stages and latest notes.
MCP tool recruiterflow_read → get_candidate
read
Returns one profile: name, title, company, location, tags, custom fields, owner, the jobs they are on with the current stage and status in each, and the latest notes. Private notes show only if your user may see them. Use list_activities for the full history.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate id from list_candidates or list_job_candidates. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "recruiterflow_read",
"arguments": {
"operation": "get_candidate",
"arguments": {
"candidate_id": "candidate_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidate_id": "772318",
"name": "Dana Whitfield",
"title": "Product Designer",
"company": "Brightline",
"location": "London",
"email": "dana.whitfield@example.com",
"tags": [
"design-lead"
],
"custom_fields": {
"notice_period": "4 weeks"
},
"jobs": [
{
"job_id": "48307",
"title": "Product Designer",
"stage": "Phone Screen",
"status": "active"
}
],
"notes": [
{
"note_id": "90412",
"body": "Intro call booked for Thursday.",
"private": false,
"created_at": "2026-10-20T09:12:00Z"
}
]
},
"isError": false
}