Save search
save_searchSaves a job search to this account, with optional daily or weekly email alerts sent to the account’s verified email address. Saving filters equivalent to an existing saved search updates its name and alert settings instead of adding a duplicate. Accounts can keep up to 100 saved searches. Does not use the job allowance.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "save_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Keywords matched against job title, company and stack, e.g. "platform engineer". | |
| name | Yes | Name for the saved search, e.g. "Senior Rust, remote Europe". | |
| role | No | One or more engineering specialties. Implies category engineering. | |
| stack | No | One or more technologies. Matches jobs mentioning any selected technology. | |
| region | No | One or more regions the candidate can work from. | |
| remote | No | One or more arrangements: remote, remote_region, hybrid or onsite. | |
| company | No | Company slug from a previous result's companySlug. | |
| category | No | Kind of role. | |
| salaryMin | No | Minimum pay. Only matches jobs that publish salary. Defaults to USD per year. | |
| seniority | No | ||
| employment | No | One or more employment types. eor: hired through an employer of record. | |
| emailAlerts | No | Email new matching jobs to the account’s verified email. Defaults to false. | |
| postedWithin | No | Only jobs posted in the last N days. | |
| salaryPeriod | No | ||
| alertFrequency | No | How often alert emails are sent. Defaults to daily. | |
| salaryCurrency | No | ISO currency code for salaryMin, e.g. USD, EUR, GBP. | |
| visaSponsorship | No | Only jobs whose posting says the employer sponsors visas. Most postings don't say either way. |