Find matching candidates
Candidates that match a job by its description and location, like Find Matching Candidates.
MCP tool bullhorn_read → find_matching_candidates
read
Runs the app's Find Matching Candidates search for one job. When the description has more than 250 words, Bullhorn takes up to 10 keywords from it and uses the job zip code with a radius of 20 miles. Pass keywords or radius_miles to change that. Returns one page of candidates, best matches first as Bullhorn orders them.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id integer required | integer | Job ID from get_job or the job record URL. |
| keywords string[] | string[] | Replaces the keywords taken from the job description. |
| radius_miles integer | integer | Search radius around the job zip code. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bullhorn_read",
"arguments": {
"operation": "find_matching_candidates",
"arguments": {
"job_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"total": 31,
"candidates": [
{
"candidate_id": 4821907,
"name": "Priya Raman",
"occupation": "Data Analyst",
"company": "Brightpath Retail",
"status": "Active",
"submission_count": 4
}
],
"next_cursor": "2"
},
"isError": false
}