Skip to main content
Glama
ats-jobs-mcp

ats-jobs-mcp

by VovikP

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.


Related MCP server: io.github.groundtruthtools/ats-jobs-mcp

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to pull live job listings from major ATS platforms (Greenhouse, Lever, Ashby, Workable), Hacker News hiring threads, and detect hiring signals on company career pages.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables querying open job postings directly from company applicant-tracking systems (Greenhouse, Ashby, Lever), finding a company's job board, listing and comparing roles, and accessing salary data, all without scraping or API keys.
      3
      60 PyPI
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables querying job boards for a company's open roles, pulling from Greenhouse, Workday, and an opt-in LinkedIn source and normalizing the results into one shape. It discovers boards, searches one or many companies at once, and returns full postings with title-based AI/ML and junior filtering.
      7
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables users to look up a company's open job postings from public Greenhouse, Lever, and Ashby boards, returning them in one normalized shape with filtering by keyword, location, remote status, and posting date. It also identifies which of those three ATSs hosts a given company's board and how many roles are open there.
      MIT