Search the job board
searchJobsSearch the wider job market, after searchCleraRoles. When searchCleraRoles finds nothing that fits, run this straight away and show the results; don't ask first. applyToJob applies to any of these for the candidate, so never send them off to the employer's site.
Keep query to keywords — a title, a stack, a company — not a sentence. Filters are exact values: arrangement is remote, hybrid or on-site; experienceLevel is 0-2, 2-5, 5-10 or 10+; employmentTypes are FULL_TIME, PART_TIME, CONTRACTOR, TEMPORARY or INTERN.
jobFacts filters on what each posting's text says: visa sponsorship, OPT/CPT, TN, citizenship or clearance, years required, languages, relocation, travel, on-call, people management, AI product, commission-only pay. Set the ones that follow from what the candidate told you (needsVisaSponsorship for someone who needs a visa, spokenLanguages from their languages); postings that don't say stay in. For a candidate who needs a visa use jobFacts.needsVisaSponsorship, not visaSponsorship: visaSponsorship keeps only the few listings flagged as sponsoring.
Salary is missing on most listings. minSalary keeps those unknown-salary roles in by default; pass excludeUnknownSalary to drop them, and expect a much smaller result set.
Listings the candidate passed on with passJob are left out. Use readJobListing for the full description of one result, saveJob to bookmark one, passJob to hide one, and applyToJob when they want to apply.
Clera privately records this tool's inputs and results for usage tracking and support.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "searchJobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | ||
| query | No | Keywords: a job title, a stack, a company name. Not a sentence. | |
| cursor | No | Pass nextCursor from a previous call to get the next page. | |
| perPage | No | ||
| jobFacts | No | Filters on facts read from each posting's text. | |
| location | No | Cities as the listing writes them, e.g. Berlin, London. | |
| countries | No | Countries as the listing writes them. | |
| minSalary | No | Annual figure in the listing's own currency. | |
| arrangement | No | ||
| employmentTypes | No | ||
| experienceLevel | No | ||
| visaSponsorship | No | ||
| postedWithinDays | No | ||
| excludeUnknownSalary | No | Drop listings with no salary on file. Most listings have none, so this cuts results hard. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | Yes | ||
| found | Yes | ||
| hasMore | Yes | ||
| nextCursor | Yes |