ats-jobs-mcp

An MCP server that answers "what is this company hiring for, right now" by reading the company's own applicant-tracking system board API at call time — Greenhouse, Lever, Ashby, Recruitee, Rippling or Personio. Not an index that was crawled last night.

No HTML scraping, no headless browser, no proxies. Every request goes to an endpoint the vendor publishes for exactly this purpose.

Install

Requires uv and a free Apify token. Runs are billed to your Apify account — see Pricing.

{
  "mcpServers": {
    "ats-jobs": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/moonie0201/ats-jobs-mcp", "ats-jobs-mcp"],
      "env": { "APIFY_TOKEN": "apify_api_..." }
    }
  }
}

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

Tools

Filters are applied before billing, so a narrow query is cheap rather than a big response you post-filter. max_jobs is a hard spend cap.

Pricing

search_jobs starts a run of the paid Apify Actor acotr_moonie/ats-jobs-scraper at $0.002 per delivered job row, billed by Apify to the account behind your own APIFY_TOKEN. This server is a thin client: it never proxies your calls, never sees your token or your results, and no run is ever paid for on your behalf. The default max_jobs=50 caps a single call at about $0.10.

resolve_company and list_supported_ats cost nothing and start no run.

What it will not do

• Salary is parsed, never inferred. Each salary carries a source field saying whether the number came from a structured provider field or a regex over prose.

• No contact fields are emitted, and contact details in ad bodies are redacted by default.

• Where a value cannot be determined the field is null. Nothing is guessed.

• resolve_company searches a partial directory — 1,804 rows, 1,444 of them verified live at last probe. A name that does not resolve is not proof the company has no board; pass the career-site URL instead.

How it works

resolve_company reads the CC-BY ats-directory over jsDelivr and caches it under ~/.cache/ats-jobs-mcp/ for 24 hours. search_jobs calls the Apify Actor's run-sync-get-dataset-items endpoint with your token.

Links

• Actor source, MIT: https://github.com/moonie0201/ats-jobs

• Company directory, CC-BY: https://github.com/moonie0201/ats-directory

• Privacy policy: https://github.com/moonie0201/ats-jobs/blob/main/PRIVACY.md

• Takedown policy: https://github.com/moonie0201/ats-jobs/blob/main/TAKEDOWN.md

Development

uv venv && uv pip install -e ".[dev]"
python -m pytest tests -q       # offline: builds the server, lists tools
python -m ats_jobs_mcp --list-tools

Disclosure

I built this, and the Actor behind search_jobs is paid. The adapter code and the company directory are open and free to use without it.

MIT licensed.