search_jobs
Search open jobs across configured company job boards, newest first, and filter by career lane, company, location, remote status, keywords, or posting age to find relevant roles.
Instructions
Search open jobs across the configured companies' job boards, newest first.
All filters are optional and combine (a job must pass every filter given).
Returns `jobs`, `total_matches` (before `limit`), `errors` (companies that couldn't be
searched, or unknown company names), and `warnings` (individual postings skipped
because of bad data). To read a job's full description, pass its `company` and
`job_id` to get_job.
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": "search_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lane | No | Career lane, matched against job titles: 'deployment' (forward deployed, solutions, implementation, and customer engineering roles), 'pm' (product and technical program management), 'new_grad' (new grad, early career, and graduate programs). Senior, staff, principal, director, lead, and intern titles are never in any lane. Omit to search every title. | |
| limit | No | Max jobs to return, newest first. total_matches still counts every match. | |
| remote | No | true: only jobs the board marks as remote. false: only jobs it marks as onsite or hybrid. Uses the board's structured workplace field, not the location text. Many jobs don't say either way and are left out by both true and false, so omit this unless remote matters. | |
| keywords | No | Words to find in job titles; a job matches if ANY keyword appears as whole words, in order ("product manager" matches "Senior Product Manager" but not "Product Marketing Manager"). Ignores lane exclusions, so senior roles can match. | |
| companies | No | Company names to search, from list_companies (case doesn't matter). Omit to search all. | |
| locations | No | Places to find in the job's location text; a job matches if ANY entry appears. Boards write places differently, so pass synonyms together, e.g. ["new york", "nyc"] or ["san francisco", "sf", "bay area"]. Use `remote` for remote work, not "remote" here. | |
| posted_within_days | No | Only jobs first posted within this many days, e.g. 7 for the last week. |