@pipeworx/company-size

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/company-size’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 1

How many employees a US company has, answered as dated public evidence: one entry per source with its value, date, method and the name it matched, and never a single blended number.

Tools

• company_size(name, state?, ticker?) — returns evidence, five entries in a fixed order:

  source	kind	what the value is
  ppp	headcount	jobs_reported on the company’s PPP loan application, 2020-21
  form5500	headcount_proxy	participants in the sponsor’s largest benefit plan, most recent plan year
  sec_xbrl	headcount	the employee count tagged on the 10-K / 20-F cover page (dei:EntityNumberOfEmployees)
  h1b	hiring_signal	certified H-1B LCA filings in the latest DOL fiscal year
  warn	layoff_signal	workers affected across the company’s WARN layoff notices

  Each entry has a status: found, not_found, not_tagged (an SEC filer that does not tag employee count — most large filers state it only in untagged 10-K text), no_confident_match (the nearest listed company’s name is not an exact match; pass ticker if it is the right one), or error (with the reason). A failed source is always an entry, never missing; if every source fails the call errors.

  agreement gives a range only when two or more headcount-type sources (ppp, sec_xbrl, form5500) fall within 25% of each other. Hiring and layoff signals are never folded in. The range spans what the sources reported on their own dates; it is not an estimate of today.

Example: company_size({name: "Sumter Coatings", state: "SC"}) returns PPP jobs_reported 62 (loan approved 2020-05-01) and Form 5500 participants 62 (plan year 2022), so agreement.range is [62, 62].

Auth

Keyless. The gateway supplies data access to this pack automatically. The PPP source works only through the hosted gateway; a standalone build reports that source as an error (ppp_unavailable) and still answers from the other four.

Data sources

All reached through other Pipeworx packs (this pack is a compound), plus one direct SEC read:

• PPP — @pipeworx/sba-loans (ppp_loan_lookup), SBA PPP FOIA data as of 2024-09-30, business borrowers only. Exact normalized-name match.
• Form 5500 — @pipeworx/form5500 (DOL EFAST2). Sponsor name must equal the query or start with it (“Sumter Coatings, Inc. 401(k) Plans” matches “Sumter Coatings”).
• SEC — https://data.sec.gov/api/xbrl/companyconcept/CIK##########/dei/EntityNumberOfEmployees.json, CIK resolved from ticker or an exact listed name via https://www.sec.gov/files/company_tickers.json. Measured 2026-10-08: the CY2024 year-end XBRL frame holds only a few dozen filers (48 under unit employee: Delta, AT&T, CBRE, American Airlines…); Apple, Microsoft, Tesla, Salesforce and Caterpillar answer 404 (not_tagged).
• H-1B — @pipeworx/h1b (h1b_employer_sponsorship).
• WARN — @pipeworx/warn-notices (warn_company). Covers only the states listed in each response; absence is not evidence of no layoffs.

Gotchas

• A compound inherits no gateway injection. This pack declares its own data access in the gateway manifest and forwards it to each sub-call by hand (see the header comment in src/index.ts). Drop that and the h1b, warn and ppp entries turn into error.
• Names are matched strictly on purpose. A loose match would put Delta Air Lines’ 103,000 employees on “Delta Plumbing”. Each entry’s matched_name says what the source actually matched.
• Form 5500 participants can include retirees and former employees with balances, and an employee-assistance or welfare plan can count more people than the payroll. It brackets headcount; it is not headcount.

Tools

• company_size — How many employees does a US company have — answered as a list of dated public evidence, one entry per source, never a blended estimate. Sources: PPP loan applications (jobs_reported, 2020-21), Form 5