ats-jobs-mcp

Greenhouse, Lever, Ashby, Workable, Teamtailor Jobs API

One API for six applicant tracking systems: Greenhouse, Lever, Ashby, Workable, Teamtailor and SmartRecruiters.

Give it a company website. It finds the job board itself, returns every open role, and on every run after that returns only what changed — roles opened, roles closed, titles moved, salaries changed — plus derived hiring signals.

{ "domains": ["stripe.com", "spotify.com", "pleo.io"] }

No board tokens. No ATS knowledge required. No browser.

---

Two ways to run it

	Hosted on Apify	Self-hosted MCP server
Setup	none	npx ats-jobs-mcp
State between runs	managed	local file
Scheduling, retries, storage	included	your own
Price	$1 per 1,000 jobs	free
Link	apify.com/feedworks/ats-jobs-api	this repo, mcp/

The logic is the same code in both. Pick whichever fits.

---

What you get

Event	Meaning
job_indexed	Baseline: an open role captured on the first run
job_posted	A new opening appeared
job_closed	An opening disappeared
job_changed	Title, location, department or employment type changed
salary_changed	Compensation changed
hiring_accelerating	This month's postings are 2× or more the recent average
first_role_in_function	First ever hire in sales, AI/ML, security, data — a new budget line opened
hiring_freeze	Postings dropped to zero after steady hiring

Every record carries provenance: source URL, HTTP status, fetch time, job count, truncation flag and a confidence value — so an agent can verify before it acts, instead of trusting a claim.

---

MCP server

npx ats-jobs-mcp

Four tools, usable by any MCP client — Claude Desktop, Cursor, VS Code, your own agent:

Tool	Question it answers
find_job_board	Which ATS does this company use, and what is its board token?
list_jobs	What roles are open right now?
detect_changes	What changed since the last time I looked?
hiring_summary	What is this company hiring for — which functions, which locations?

Claude Desktop config:

{
  "mcpServers": {
    "ats-jobs": { "command": "npx", "args": ["-y", "ats-jobs-mcp"] }
  }
}

State lives in ~/.ats-jobs-mcp/state.json. Override with ATS_MCP_STATE.

---

Why it stays cheap to run continuously

Every source is polled with If-None-Match. When nothing changed, the ATS answers 304 with no body.

Measured on the hosted Actor at 512 MB:

Path	Compute
Nothing changed (304)	0.000344 CU per run
Baseline, 143 jobs	0.001386 CU

That is why watching hundreds of companies every few hours costs cents rather than dollars — and why this project will never open a headless browser to read a job board.

---

What it deliberately does not do

• No personal data. Recruiter names, emails and phone numbers are stripped at parse time and never stored.
• No headless browser, no proxies. Only public ATS endpoints that answer with JSON.
• No false layoffs. If a source response may be truncated by paging, job_closed events are suppressed — a paging artefact must never look like a company shutting down hiring.

---

Supported sources

greenhouse · lever · ashby · workable · teamtailor · smartrecruiters

Detection order: a link on the company careers page → the board token guessed from the domain → Workable short links resolved through their redirect.

Companies that cannot be resolved return a source_unresolved record explaining why, instead of failing silently.

Recruitee and Personio are not listed because they are not verified working. Personio currently answers 429 to non-browser clients; Recruitee endpoints did not resolve in testing. This project does not claim coverage it cannot deliver.

---

Repo layout

src/          Apify Actor: adapters, diff engine, derived signals
mcp/          MCP server — the same engine, self-hosted
tools/        discovery utilities (domain → ATS)
.actor/       Apify manifests and schemas

MIT licensed. Contributions welcome, especially new ATS adapters — the interface is one url() and one parse() function per system, see src/adapters/index.js.