search_jobs
Search active, unexpired catalogue jobs, excluding jobs hidden by this account. Returns total, page, pages and up to 24 jobs, newest first; zero matches returns jobs=[] and page=pages=1. Filters combine with AND. No AI, credit charge, save or application submission. Use get_job for full posting text and eligibility, get_market for aggregate counts. Counts may be cached; jobs can expire between calls. Required scope: jobs:read
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 |
|---|---|---|---|
| q | No | Optional keywords matched against job title, employer, skills and categories. Use concise terms such as PHP; this is keyword search, not semantic matching. Omit for all jobs. | |
| mode | No | Optional workplace arrangement. Remote does not mean worldwide eligibility; read each posting. | |
| page | No | One-based page, default 1. Up to 24 jobs per page, newest first. Out-of-range pages clamp to the last page. Check returned page/pages; stop when page equals pages. | |
| timing | No | Optional declared time of work. Unknown timing does not satisfy a specified filter. | |
| country | No | Optional ISO 3166-1 alpha-2 country, e.g. RO or DE. One country per call; omit for all countries. Does not represent citizenship or visa eligibility. | |
| schedule | No | Optional declared schedule pattern; independent of workplace arrangement. | |
| max_hours | No | Optional maximum declared weekly hours, inclusive, 1–80. Jobs with unknown weekly hours are excluded when supplied. | |
| engagement | No | Optional declared employment/engagement category. Combine with mode for remote part-time or contract searches. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | Yes | ||
| page | Yes | ||
| pages | Yes | ||
| total | Yes | Matching catalogue postings, possibly from a short-lived count cache. |