io.github.groundtruthtools/ats-jobs-mcp
OfficialThis MCP server is the free local job-data edition that finds company ATS boards and reads or compares open jobs from Greenhouse, Ashby, Lever, and Workable.
Find which applicant-tracking system and board name a company uses, given a company name or board name.
List every open job at one company, including title, department, location, employment/workplace type, posted date, parsed salary where unambiguous, and a verify URL to the employer’s advert.
Optionally include full job descriptions, with emails and phone numbers removed.
Compare open jobs across up to 20 companies in one shared schema, with per-company limits and failures isolated so other results survive.
Target boards by board name, careers URL, or
system:name(for examplelever:spotify).Avoid guessed salaries: hourly rates, ambiguous currencies, equity, and mixed-currency bands return no salary figure while preserving the employer’s original salary text.
Allows searching and retrieving live open job postings from employer career pages hosted on Greenhouse, including title, department, location, employment and workplace type, posted date, parsed salary ranges, and a verification link to the employer's own job advert.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.groundtruthtools/ats-jobs-mcp Compare software engineer openings and salaries at Anthropic and OpenAI"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ats-jobs-mcp: Company Facts
An MCP server for company data read from the official or original source. Newly formed US businesses straight from state registers, with their website found only on proof. A company's register entry, tech stack, DNS and email provider, SEC financials and open jobs, each with a link to where it came from.
The full server runs remotely at https://companyfacts.dev/mcp with 20 tools and nothing to install. This PyPI package is the small local edition: the three job tools, run on your own machine.
Use it with no install
Point any MCP client that speaks Streamable HTTP at the URL:
{
"mcpServers": {
"company-facts": {
"url": "https://companyfacts.dev/mcp"
}
}
}No account and no key: 10 free calls a day. Past that, pay per call with x402 (USDC on Base) or use a prepaid key (see https://companyfacts.dev/pricing). A call that finds nothing is not charged.
The same tools answer plain HTTP, for agents that do not speak MCP:
GET https://companyfacts.dev/openapi.jsonfor a tool-calling agentGET https://companyfacts.dev/llms.txtfor a model reading the service in proseGET https://companyfacts.dev/v1/new-businesses?states=CO&mode=new
Related MCP server: ats-jobs-mcp
Company tools (remote)
Tool | What it returns |
| Newly formed businesses from the official Secretary of State registers of New York, Colorado, Oregon, Connecticut and Pennsylvania, in one record format. Feed by formation date, search by name, or look up by state entity number (KYB checks). Each record carries the company's website when one was found with proof, else says none was found. |
| Search every company we track: filter by state, city, name, formation date, technology on its site (Shopify, WordPress, ...), whether it publishes a phone, role inbox or contact page, and hiring. A search with no match is not charged. |
| One company from its domain: registrar, DNS and email provider, website tech stack, hiring from its own job board, plus its official register entry or SEC figures when you give name and country or a ticker. |
| One country's official company register by name (UK, Norway, France, Finland, Czechia, Slovakia, Ireland, Australia, or GLEIF worldwide), in one shape. |
| US public company financials from SEC EDGAR XBRL. |
| An EU VAT number checked against the European Commission's VIES service. |
| Registration (RDAP), DNS records, email provider, SPF and DMARC for a domain. |
| The technologies behind a web page, each with its evidence. |
| Awarded US federal contracts from USAspending. |
Websites are attached to new businesses only on proof: the site's own pages must show the exact legal name and the same city, state or ZIP as the register. Records never carry officers, directors, individual registered agents, emails, phones or street addresses.
Job tools
Tool | What it returns |
| Which applicant-tracking system a company's careers page runs on, and its board name. |
| Every open job at one company, read from its own Greenhouse, Ashby, Lever or Workable board. |
| Open jobs across up to 20 companies in one schema. |
| Jobs newly posted, taken down, reopened or edited, day by day, from a daily record of every board. |
| One company's hiring at a glance: roles by department and place, remote share, salary ranges, recent openings and closings. |
The vendors publish open job board APIs, and all of them are useless unless you already know the company's board name. None publishes a directory of its customers, so this carries one: 8,532 boards on the remote server, each confirmed against the vendor's own API.
Other tools (remote)
read_page (a web page or PDF as markdown), extract_page (named fields from a
page as JSON, paid only), check_email (syntax, mail servers, disposable and
role flags), search_papers (OpenAlex), search_hacker_news, app_store_lookup.
Every tool is read-only and declares a title and readOnlyHint.
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. 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 / hourgives no salary. An hourly rate is a different quantity and reporting it as annual would be a confident lie.600 000 krgives no salary.kris Swedish, Norwegian and Danish.0.5% - 1.75% - Offers Equitygives 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.
No personal data
Recruiter names are never returned. Email addresses and phone numbers are removed from job descriptions. Unlisted Ashby postings are dropped, because Ashby's documentation says they should not be shown publicly.
Or install the local job edition
pip install ats-jobs-mcp{
"mcpServers": {
"ats-jobs": {
"command": "ats-jobs-mcp"
}
}
}The local edition has find_company_board, list_open_jobs and
compare_companies over a bundled directory of 7,479 Greenhouse and Ashby
boards (Lever by name, for example lever:spotify). It is free, runs on your
machine, and takes no cut of anything.
Python and LangChain
pip install groundtruth-company: a Python client for the company tools.pip install langchain-groundtruth: the same tools as LangChain tools.
Relation to the Apify Actors
The same job parsing runs as an Apify Actor at
apify.com/groundtruth/ats-job-listings.
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. Register records belong to the states that publish them.
Available Tools
3 toolscompare_companiesAInspect
Open jobs across several companies at once, in one schema.
This is the thing no single applicant-tracking system can do: each vendor only knows about its own customers. Companies on different systems come back with the same field names, so they can be compared directly.
One company failing does not lose the others; each failure is reported beside the results that did work.
Inputs: companies (required), per_company.
find_company_boardAInspect
Find which applicant-tracking system a company's careers page runs on.
Greenhouse, Ashby, Lever and Workable all publish open job board APIs, and all of them are unusable unless you already know the company's board name. None of them publishes a directory of its customers, and none could, since no vendor knows about the others.
Use this first when you have a company name rather than a careers URL.
Inputs: company (required), limit.
list_open_jobsAInspect
Every open job at one company, read from its own careers system.
Returns 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.
Salaries are refused rather than guessed: an hourly rate, an ambiguous currency, or bands in two currencies all yield no figure, and salary_text keeps whatever the employer actually wrote.
Inputs: company (required), limit, include_description.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct role: one discovers the ATS board, one lists jobs for a single company, and one compares jobs across companies. There is no meaningful overlap or ambiguity between them.
All tool names follow the same verb_noun snake_case pattern: compare_companies, find_company_board, and list_open_jobs. The naming is consistent and predictable.
Three tools is well-scoped for this server's purpose. Each tool occupies a necessary step in the workflow, and none feel redundant or missing.
The tool set covers the full intended workflow: discover the ATS system, list open jobs at a company, and compare jobs across companies. There are no obvious dead ends or missing operations for this read-only domain.
Maintenance
Related MCP Connectors
Open jobs from Greenhouse, Lever, Ashby and 4 more ATSs in one schema, with new-job monitoring.
Open jobs from any company's Greenhouse, Lever, Ashby, Workday and other ATS boards, with signals.
1Open jobs from any company's careers site by name or domain, plus a search across 2.5M+ roles
Search open jobs, track new and closed roles, and get salaries on Greenhouse, Ashby, Lever, Workday.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables real-time job search across thousands of companies' open roles from Greenhouse, Lever, Ashby, and SmartRecruiters, with full-text filtering and company-specific queries, no API key required.2MIT
- AlicenseAqualityCmaintenanceEnables asking what companies are hiring right now by querying live job postings from their applicant-tracking system board APIs (Greenhouse, Lever, Ashby, Recruitee, Rippling, Personio), with filters, parsed location, remote flag, and structured salary.3MIT
- AlicenseAqualityCmaintenanceEnables 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.7MIT
- AlicenseNot gradedqualityFmaintenanceEnables 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.46 npmMIT