Return the authenticated freehire user (verifies the API key). Call this to confirm auth before other tools.

List the market's filter vocabulary: every facet's live values with a vacancy count each, plus the skills list and numeric ranges. Call this FIRST to discover real values for search and market_fit — do not invent facet values.

Search open jobs by keyword with optional facet filters. Returns matching jobs (title, company, location, public_slug) and the total match count. Use the returned slug with job, apply, save, etc.

Score a skill list against the live open-vacancy market for a filtered role: headline coverage (% of vacancies listing ≥1 skill), must-have skills held, and the missing skills that unlock the most vacancies. Here skills is the MEASURED set, not a filter — use facet params to define the role. One skill probes that skill's demand.

Fetch a single job's full content by slug (title, company, location, posting URL, description).

Fetch a company and its open jobs by company slug.

Mark a job as applied for the authenticated user. Idempotent.

Bookmark a job for later. Idempotent.

Remove a job's bookmark. A no-op if it was not saved.

Set a job's application stage. The server validates the value; valid stages are applied/screening/responded/interview/offer/accepted/rejected/withdrawn.

Attach a free-text note to a tracked job (overwrites the existing note).

List the caller's tracked jobs (viewed/saved/applied) with their stage and note. Filter narrows the set.

Submit a vacancy for moderation. The server stores it as pending and returns it. URL (the dedup key), title, and company are required.

List the caller's own vacancy submissions with their moderation status.

Moderator: create a hand-curated job. URL is the dedup key — re-adding the same URL updates the posting. description is stored and rendered as HTML. Requires the moderator role (403 otherwise).

Moderator: partially update a manual job by slug. Only the provided fields change; the URL identity is not editable. Requires the moderator role (403 otherwise).

Moderator: list the pending submission review queue. Requires the moderator role (403 otherwise).

Moderator: approve a pending submission, minting a live job. Requires the moderator role (403 otherwise).

Moderator: reject a pending submission with an optional reason. Requires the moderator role (403 otherwise).