Create a job monitor
monitor_createPurpose: Save a search as a monitor that keeps collecting matching job postings for the user; a title and one real location are required. When: Only when the user asks to be kept informed about a search, with datePosted narrowing the start to recent postings. Cost: About 160 tokens for the saved monitor.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"locations": [
"Austin, TX"
],
"titleText": "QA engineer",
"department": "software-it",
"experience": {
"exact": "Senior"
},
"includeFamily": false
},
"name": "monitor_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | No | Words that must appear in the posting's text. | |
| companies | No | Company names; a posting from any of them is kept, and leaving them out watches the whole market. | |
| locations | Yes | Real location names, each read as the closest known location; check monitor.locations in the result for what it watches. | |
| salaryMax | No | Highest yearly salary to keep, in US dollars after the same conversion. | |
| salaryMin | No | Lowest yearly salary to keep, in US dollars after each posting's published salary is converted. | |
| titleText | Yes | Words of the job title, matched to one of searchnapply's known roles (resolvedRole.display names it), which the monitor then watches. | |
| datePosted | No | How recently the posting was published; leave it out for any date. | |
| department | No | One department slug, to narrow a title that spans departments; call job_postings_search_fields for what each one holds. | |
| experience | No | Experience level to keep, given as exact, since a monitor keeps one level and no lowest level. | |
| includeFamily | No | Also return postings from the resolved role's wider family; false, the default, keeps the exact role only. | |
| locationTypes | No | Workplace types to keep. | |
| employmentType | No | Employment type to keep. | |
| salaryCurrency | No | A three-letter currency code that only labels the monitor. | |
| excludeKeywords | No | Words that must not appear in the title or the text, 1 to 10 words. | |
| includeNoSalary | No | Keep postings that publish no salary; true by default. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| monitor | Yes | The monitor as saved. | |
| titleNote | No | Present when no role matched: the title words are matched against posting titles. | |
| resolvedRole | No | The role the title words were read as; absent when no role matched. | |
| unrecognizedLocations | No | The location names that matched no known location and were left out. |