Get candidate
One candidate record with contact fields, location, skills and work history.
MCP tool jobdiva_read → get_candidate
read
Returns the name, contact fields, location, skills and work history shown on the record. Notes are not included; list_candidate_notes reads them. A record you cannot open in JobDiva answers APP_PERMISSION_DENIED.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id integer required | integer | Candidate ID from search_candidates or find_candidate. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jobdiva_read",
"arguments": {
"operation": "get_candidate",
"arguments": {
"candidate_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidate_id": 5821904,
"name": "Priya Raman",
"email": "priya.raman@example.com",
"phone": "+1 312 555 0147",
"location": "Chicago, IL",
"skills": [
"SQL",
"dbt",
"Looker"
],
"experience": [
{
"title": "Data Analyst",
"company": "Brightpath Retail",
"from": "2020-03",
"to": null
}
]
},
"isError": false
}