Claim or skip a job
freeapply_claim_jobClaim a job before applying to run duplicate and rule checks, start tracking, and get the job_id needed for later updates. Use before an application form or to mark reviewed jobs skipped.
Instructions
Claims a job before you work on it: duplicate check, the user's rules, starts tracking, returns the job_id every later call needs. Makes the job's first record (listing: freeapply_list_jobs; changing: freeapply_update_job). Use: before opening any application form; also to record a reviewed job you won't pursue (status skipped + status_note) so it isn't reviewed again. Not for a job already claimed. Behavior, first match wins: posting id already tracked: returns that job (existing true, nothing added); job site the user didn't choose, or signed out or paused: refused (refused says why, sites lists ready ones); same company and title as an applied job: refused as a repost; posted pay below the user's minimum: saved as skipped (rule pay_floor). Otherwise the job is added. A refused or existing claim changes nothing, so repeating the call is safe. Returns: {job_id, existing, status, rule, earlier}. earlier: up to 20 other jobs at the company [{id, title, company, status, same_title}]; if an applied one is clearly the same role under another title, mark this one skipped (freeapply_update_job). restart true (auto-run): the user saved new settings and wants them used now: don't work this job; the run finishes and starts again. Errors: a missing title or company.
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": {
"title": "<title>",
"company": "<company>"
},
"name": "freeapply_claim_job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Posting URL; tells the job site. The URL just read by freeapply_fetch_posting keeps its keywords. | |
| title | Yes | As posted. | |
| source | No | Where found: job site id (linkedin, indeed, company_sites, ...) or referral; tells the job site like url. | |
| status | No | found (default): to work on; skipped: a job you won't pursue. | |
| company | Yes | The employer as posted; not a staffing firm, when you can tell. | |
| pay_max | No | Highest posted pay, a number. Feeds the pay floor. | |
| pay_min | No | Lowest posted pay, a number: annual, or hourly if posted hourly. Feeds the pay floor. | |
| location | No | As posted. | |
| pay_text | No | Pay exactly as posted, e.g. "$90k-$110k". | |
| apply_url | No | Application form URL, if different. | |
| fit_notes | No | Why it fits or doesn't, one sentence. | |
| fit_score | No | 0-100, scored as the apply procedure says. | |
| work_mode | No | remote, hybrid or onsite, as posted. | |
| description | No | Short description or key requirements. | |
| external_id | No | The posting's id on its source site; pass it whenever shown: finds the posting again and catches reposts. | |
| status_note | No | For skipped: why, one plain sentence. |