Skip to main content

ats-jobs-mcp

An MCP server for open job postings, read first-hand from the applicant-tracking system behind a company's careers page. Ask your assistant what Anthropic is hiring for and get the answer from Anthropic's own board, not from a job aggregator's index.

Built on the job board APIs that Greenhouse, Ashby and Lever publish so third parties can build job sites. No scraping, no API key, no account, no personal data.


Why this exists

Those APIs are open, documented, and useless unless you already know the company's board name: that Anthropic's is anthropic, Ramp's is ramp, Mistral's is mistral.ai.

None of the vendors publishes a directory of its customers, and none could, since no vendor knows about the others. Checked 2026-08-24: sitemap.xml on job-boards.greenhouse.io, boards.greenhouse.io, jobs.lever.co and apply.workable.com all 404 or redirect.

So this ships one: 7,479 company boards, every one confirmed against the vendor's own API, each carrying the date it was confirmed.

Three tools

find_company_board — which system is a company on?

Give it a company name. Get the system and the board name, plus how many roles were open when the board was last confirmed.

list_open_jobs — every open role at one company

Title, department, location, employment type, workplace type, posted date, a parsed salary range where the employer publishes one, and a verify_url pointing at the employer's own advert.

compare_companies — several companies, one schema

The thing no single vendor can do. Companies on Greenhouse and companies on Ashby come back with the same field names, so they can be compared directly. One company failing does not lose the others.

Salaries, parsed, and refused when unclear

Ashby prints pay as "$211.4K - $290.6K". Greenhouse prints it in cents, sometimes as several bands at once. Neither is filterable, so both are turned into numbers:

"salary_min": 211400.0, "salary_max": 290600.0,
"salary_currency": "USD", "salary_text": "$211.4K - $290.6K"

The parser refuses more often than it guesses, deliberately:

  • $50 - $80 / hour gives no salary. An hourly rate is a different quantity and reporting it as annual would be a confident lie.
  • 600 000 kr gives no salary. kr is Swedish, Norwegian and Danish.
  • 0.5% - 1.75% - Offers Equity gives no salary. Equity is not pay.
  • Bands in two currencies are never spanned into a range that exists nowhere.

salary_text always keeps what the employer actually wrote, so nothing is lost when the parser declines.

Every parsed figure is tested against the employer's own structured baseSalary block, the one published for Google to index — not against a number someone typed into a test.

No personal data

Recruiter names are never returned. Email addresses and phone numbers are removed from job descriptions, because descriptions genuinely carry them and a column of work addresses is a marketing list rather than a job feed.

Unlisted Ashby postings are dropped, because Ashby's documentation says plainly that they should not be shown publicly.

Coverage, stated honestly

System Boards in the directory
Greenhouse 4,168
Ashby 3,311

Lever is readable but has almost no boards in the directory yet, so name it directly (lever:spotify) or pass its careers URL. Workable has a confirmed endpoint but no adapter yet, so it is not listed at all: a directory entry for something nothing can read is a broken promise.

Install

pip install ats-jobs-mcp

Then add to your MCP client configuration:

{
  "mcpServers": {
    "ats-jobs": {
      "command": "ats-jobs-mcp"
    }
  }
}

Relation to the hosted version

The same parsing runs as an Apify Actor at apify.com/groundtruth/ats-job-listings, which adds scheduling and an incremental mode that returns only postings you have not been sent before. This server is free, runs on your machine, and takes no cut of anything.

tests/test_core_parity.py fails if the two copies of the parsing logic drift apart.

Licence

MIT. Job postings belong to the employers who published them.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ats_jobs_mcp-1.0.0.tar.gz (113.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ats_jobs_mcp-1.0.0-py3-none-any.whl (118.3 kB view details)

Uploaded Python 3

File details

Details for the file ats_jobs_mcp-1.0.0.tar.gz.

File metadata

  • Download URL: ats_jobs_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 113.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.10

File hashes

Hashes for ats_jobs_mcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 514638b78e489e2bf7651746533d79f57c821678d98a6f7b0023caee4f326261
MD5 5e353cf25a71a4d2833add5a05672f15
BLAKE2b-256 842d72a346ccf6780e788c9731a5c03f9e958d83b3333fd283caa00ce6d485da

See more details on using hashes here.

File details

Details for the file ats_jobs_mcp-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: ats_jobs_mcp-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 118.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.10

File hashes

Hashes for ats_jobs_mcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 97bfd506dd6db18b85f8bfd48695b34b45407e53ded9fd8f38b7c691c9190e19
MD5 2dc8d400099caca00037bed426d727c8
BLAKE2b-256 0af98c982e6657b9a67727781b9ab0952586ac5facef916a8cfbe9c3d0705ddd

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page