Search candidates
Candidates from a Talent Search by skills, titles and distance from a location.
MCP tool jobdiva_read → search_candidates
read
Runs the search the way Talent Search does: skills and titles combined with a location and a distance in miles. Returns one page of candidates with location and a short summary, best matches first. Pass page for the next one. Use candidate_id in get_candidate and add_candidates_to_hotlist. Candidates you cannot open in JobDiva are not returned.
Parameters
| Name | Type | Description |
|---|---|---|
| skills string[] | string[] | Skills the resume must show, for example SQL and dbt. |
| titles string[] | string[] | Job titles to look for. |
| location string | string | City or address to measure distance from. |
| within_miles integer | integer | Distance from the location in miles. |
| limit integer | integer | Candidates per page. |
| page integer | integer | Page number, starting at 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jobdiva_read",
"arguments": {
"operation": "search_candidates",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"total": 31,
"candidates": [
{
"candidate_id": 5821904,
"name": "Priya Raman",
"title": "Data Analyst",
"location": "Chicago, IL",
"skills": [
"SQL",
"dbt",
"Looker"
]
},
{
"candidate_id": 5830117,
"name": "Marcus Lee",
"title": "BI Lead",
"location": "Naperville, IL",
"skills": [
"SQL",
"Power BI"
]
},
{
"candidate_id": 5834402,
"name": "Elena Petrova",
"title": "Analytics Engineer",
"location": "Evanston, IL",
"skills": [
"SQL",
"dbt",
"Snowflake"
]
}
],
"page": 1
},
"isError": false
}