Find candidate
Quick search for a candidate by name, email, phone or address.
MCP tool jobdiva_read → find_candidate
read
Matches first name, last name, email, alternate email, work, home and cell phone, fax and address. Returns every record that matches, so a common name gives several rows; compare location and title before you use one. Use it to check whether a person already exists before create_candidate.
Parameters
| Name | Type | Description |
|---|---|---|
| value string required | string | Name, email, phone or address to look for. |
| limit integer | integer | Maximum number of records returned. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jobdiva_read",
"arguments": {
"operation": "find_candidate",
"arguments": {
"value": "value"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidates": [
{
"candidate_id": 5821904,
"name": "Priya Raman",
"title": "Data Analyst",
"location": "Chicago, IL",
"email": "priya.raman@example.com"
}
]
},
"isError": false
}