io.github.vinayvobbili/jobwatch

What it mainly works on, as our AI model read its tool descriptions: files and code on the machine it runs on; accounts and data in outside web services.

9 of 21 tools are described as changing something (creating, editing, deleting, sending or running).

• find_boardreads or searches

  “Find a company's job board by name or by a job/careers link.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world yes

  1 input, 1 required

  • companystringrequired“A company name ("Stripe"), or a link to one of its job postings or its careers page.”
• list_boardson 15 other serversreads or searches

  “The boards on the watchlist (entry, display name, careers: the board's own page, careers_link: the company's own careers site when the watchlist gives one) and where the watchlist file is.”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world no

  Takes no inputs.

• add_boardcreates or changes datadescribed as changing data

  “Add a company's board to the watchlist, so fetch_jobs checks it from now on.”

  Publisher declares: read-only no · destructive no · idempotent yes · open-world no

  3 inputs, 1 required

  • entrystringrequired“The board as source:board, the way find_board and list_boards give it (e.g.”
  • namestring“The company's name as it should show, when the board's own name isn't it (e.g.”
  • careersstring“The company's own careers site (https://...), for a board whose hosted job pages are offline (fetch_jobs warns about those): its jobs then link there.”
• remove_boarddeletesdescribed as changing data

  “Take a board off the watchlist, so fetch_jobs stops checking it.”

  Publisher declares: read-only no · destructive yes · idempotent yes · open-world no

  1 input, 1 required

  • entrystringrequired“The board as source:board, the way find_board and list_boards give it (e.g.”
• list_suggested_boardsreads or searches

  “Companies to watch: those whose jobs came in from job-alert emails (import_job_alerts), add_application or posts in HN's Who is hiring thread (fetch_jobs, when it's watched) while their board isn't o…”

  Publisher declares: read-only no · destructive no · idempotent yes · open-world yes

  3 inputs

  • limitinteger or null“The most companies to return, best first.”
  • look_up_boardsboolean“Look for the board of each listed company that hasn't been looked for yet, the way find_board does (once per company; what's found is kept).”
  • rescanboolean“First note the companies of the HN posts already kept (still open) that pass the filters: after the filters change, or for posts fetched before they were noted.”
• dismiss_suggested_boarddeletesdescribed as changing data

  “Stop suggesting a company in list_suggested_boards, when the person doesn't want to watch it.”

  Publisher declares: read-only no · destructive no · idempotent yes · open-world no

  1 input, 1 required

  • companystringrequired“The company as list_suggested_boards names it (any case; Inc, LLC and the like aside), or its board.”
• fetch_jobson 1 other serverdescribed as changing data

  “Check every board in the watchlist and record new roles.”

  Publisher declares: read-only no · destructive no · idempotent yes · open-world yes

  Takes no inputs.

• get_digeston 11 other serversreads or searches

  “New jobs that pass the watchlist's filters, best first (fit score when scored, then keyword relevance), with people the user knows at each company.”

  Publisher declares: read-only no · destructive no · idempotent no · open-world yes

  4 inputs

  • score_topinteger“How many of the most relevant unscored jobs to fit-score against the resume with shortlist-ai first.”
  • include_seenboolean“Also include jobs already shown in an earlier digest, not just new ones.”
  • limitinteger or null“The most jobs to return, best first.”
  • mark_shownboolean“Mark the returned jobs as shown, so the next digest leaves them out.”
• get_jobon 138 other serversreads or searches

  “Everything about one job, by key or posting id: the full posting text, pay, tracking (status, note, next step, follow-up), its fit score against the resume (score, must-haves met, gaps, and requireme…”

  Publisher declares: read-only yes · destructive no · idempotent yes · open-world no

  1 input, 1 required

  • keystringrequired“The job: its key as other tools return it (source:board:posting id, e.g.”
• mark_jobcreates or changes datadescribed as changing data

  “Record a job's status: new, shown, queued (to apply to next), applied, screening, interviewing, offer, rejected, withdrawn or skipped (omit status to keep it and only update the rest).”

  Publisher declares: read-only no · destructive yes · idempotent yes · open-world yes

  9 inputs, 1 required

  • keystringrequired“The job: its key as other tools return it (source:board:posting id, e.g.”
  • statusstring or null“The new status; omit to keep it and only update the rest.”
  • notestring or null“Replaces the whole note.”
  • add_notestring or null“A line to add to the note, dated today, keeping what's there ("recruiter replied: onsite only").”
  • next_stepstring or null“What happens next ("recruiter screen Tuesday").”
  • follow_upstring or null“A day: YYYY-MM-DD, or +N for N days from today.”
  • applied_onstring or null“The day applied (YYYY-MM-DD), if not today.”
  • urlstring or null“The link of a job added by hand: its posting, or the company's careers site once the posting is gone.”
  • textstring or null“The posting's text, pasted (found later, or a copy once the posting is gone), so it can be scored and prepped.”
• add_applicationon 1 other servercreates or changes datadescribed as changing data

  “Add a job jobwatch didn't find (a referral, a recruiter, LinkedIn...), so everything is in one place: an application (only after the person has applied themselves), or status queued for one they're c…”

  Publisher declares: read-only no · destructive no · idempotent no · open-world yes

  9 inputs

  • companystring“The company; may be left out when url is a job link it can read.”
  • titlestring“The job title; may be left out when url is a job link it can read.”
  • urlstring“A link to the job: Greenhouse, Lever, Ashby, Workable, Workday, Rippling, Google Careers, amazon.jobs, Oracle Recruiting Cloud, SmartRecruiters, Avature or Lin…”
  • statusstring“applied (the default; only once the person has applied themselves), queued for one they're considering, or a later stage such as interviewing.”
  • applied_onstring“The day applied (YYYY-MM-DD), if not today.”
  • notestring or null“A note: who referred them, how they found it...”
  • next_stepstring or null“What happens next ("hiring manager call Friday").”
  • follow_upstring or null“A day: YYYY-MM-DD, or +N for N days from today.”
  • textstring“The posting's text, pasted, when the link can't be read, so it can be scored and prepped.”
• import_job_alertsreads or searchesdescribed as changing data

  “Track the jobs in job-alert emails (LinkedIn, Built In, Indeed; other senders with a generic reader).”

  Publisher declares: read-only no · destructive no · idempotent yes · open-world yes

  3 inputs, 1 required

  • emailsarrayrequired“The alert emails, one string each: the raw message (RFC822, as a mail connector's raw format gives it; best, since it names the sender) or just its HTML or pla…”
  • follow_linksboolean“Look for each job that passes the filters on the company's own board, and read links robots.txt allows.”
  • dry_runboolean“Say what would be tracked, and record nothing.”

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. Read 2026-10-23.

The registry verifies a package once, when it is published, and does not re-check it. A difference below is about the listing, not a judgement of the publisher.