Search candidates
Candidates matching a name, email, phone or resume keyword.
MCP tool jobadder_read → search_candidates
read
Searches the candidates your JobAdder user can see and returns a page of matches with the candidate_id, name, email, phone and current location of each. Pass next_cursor back as cursor for the next page. The agent uses the candidate_id in get_candidate, add_candidate_note and create_task. A query with no match returns an empty list.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Name, email, phone or resume keyword. |
| limit integer | integer | Maximum candidates to return. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jobadder_read",
"arguments": {
"operation": "search_candidates",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidates": [
{
"candidate_id": "cand_20931",
"name": "Priya Nair",
"email": "priya.nair@example.com",
"phone": "+61 400 000 111",
"location": "Sydney"
}
],
"next_cursor": null
},
"isError": false
}