Skip to main content
Glama
io.github.groundtruthtools/ats-jobs-mcp

io.github.groundtruthtools/ats-jobs-mcp

Official

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.json for a tool-calling agent

  • GET https://companyfacts.dev/llms.txt for a model reading the service in prose

  • GET https://companyfacts.dev/v1/new-businesses?states=CO&mode=new

Related MCP server: ats-jobs-mcp

Company tools (remote)

Tool

What it returns

new_businesses

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.

company_search

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.

company_lookup

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.

search_company_registry

One country's official company register by name (UK, Norway, France, Finland, Czechia, Slovakia, Ireland, Australia, or GLEIF worldwide), in one shape.

sec_financials

US public company financials from SEC EDGAR XBRL.

validate_vat

An EU VAT number checked against the European Commission's VIES service.

domain_lookup

Registration (RDAP), DNS records, email provider, SPF and DMARC for a domain.

detect_tech_stack

The technologies behind a web page, each with its evidence.

federal_contracts

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

find_company_board

Which applicant-tracking system a company's careers page runs on, and its board name.

list_open_jobs

Every open job at one company, read from its own Greenhouse, Ashby, Lever or Workable board.

compare_companies

Open jobs across up to 20 companies in one schema.

job_changes

Jobs newly posted, taken down, reopened or edited, day by day, from a daily record of every board.

hiring_summary

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 / 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.

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 tools
compare_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

    A4.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      3
      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.
      46 npm
      MIT