@pipeworx/naics

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

Connect to just the @pipeworx/naics pack

https://gateway.pipeworx.io/naics/mcp — only @pipeworx/naics’s own tools, nothing else in the catalog.

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: 5

NAICS industry code reference: code to title and description with the full parent/child hierarchy, keyword search, 2017 to 2022 edition crosswalks, SIC to NAICS crosswalks, and company to NAICS (SAM.gov registrations plus the SEC’s SIC).

NAICS is a filter or field inside about a dozen Pipeworx packs (samgov, usaspending, sba-loans, bls, osha, epa-echo and others), so a caller can filter contracts by 541511. This pack answers what 541511 means and finds the code for an industry phrase.

Tools

  • naics_lookup(code, edition?, include_description?) — official title, description, level (sector to national industry), the parent chain and child codes for a 2 to 6 digit code. Editions 2022 (default) and 2017. An unknown code is an error that names the nearest codes and, when the code exists in the other edition, says so.
  • naics_search(query, edition?, level?, limit?) — plain words to codes (“software publishers” returns 513210 in 2022, 511210 in 2017; “dental offices” returns 621210). Every word must appear in a title or description; the title match ranks first.
  • naics_crosswalk(code, from_edition?, to_edition?) — 2017 to 2022 and 2022 to 2017. Says whether the industry was unchanged, split, merged or renumbered; codes of five digits or fewer map through their six-digit descendants.
  • naics_sic_crosswalk(sic? | naics?) — 4-digit SIC (still the code on SEC filings) to candidate NAICS 2022 codes, or a NAICS 2022 code back to its SIC candidates. Candidate lists, not one-to-one.
  • naics_company(name? | uei? | ticker? | cik?) — the NAICS codes a company declared in its SAM.gov registration (primary and others, with titles) and the SEC’s SIC for it with derived NAICS candidates.

For market size by NAICS and geography see census-business (establishments, employment, payroll) and qcew (BLS county employment and wages by industry): different publishers and datasets, both keyed on the codes this pack resolves.

Auth

Keyless.

Data sources

  • U.S. Census Bureau, North American Industry Classification System (NAICS): the 2022 and 2017 editions, the edition concordances, and the SIC concordance. U.S. federal data, public domain.
  • SAM.gov, Entity Registration (U.S. General Services Administration), for naics_company. Published monthly, so a registration can be up to about a month old; the response carries the snapshot date.
  • U.S. Securities and Exchange Commission, public company records, for naics_company (SIC code and description).

The NAICS tables are baked (about 2,100 codes per edition) and served from KV; they change once per five-year edition. baked_at in each response is the bake time.

Things worth knowing

  • NAICS sector codes 31-33, 44-45 and 48-49 are ranges. naics_lookup accepts 31, 32 or 33 and resolves them to 31-33.
  • The SIC to NAICS result is derived by chaining the Census concordances (1987 SIC to 2002 NAICS directly, then 2002 > 2007 > 2012 > 2017 > 2022). direct_2002_naics shows the first, official hop. Treat the 2022 list as candidates.
  • The SEC assigns SIC, not NAICS. The NAICS shown beside an SEC company is a candidate list; the SAM.gov codes are the company’s own declaration.
  • Refresh: re-bake once per NAICS edition (next: 2027): python3 scripts/bake-index.py > src/naics-index-data.ts (needs openpyxl and xlrd). Owner is named in scripts/baked-index-freshness.json.

Budget: baked tables are one ~2 MB KV object written at deploy; reads are one KV get per isolate cold start. Under $1 one-time, about $0 per month.

Tools

  • naics_lookup — Look up a NAICS industry code (2 to 6 digits) and get its official title, the official description (what establishments in it do, with cross-references and exclusions), its level (sector, subsector, i
  • naics_search — Find NAICS industry codes from plain words, e.g. “software publishers”, “dental offices”, “electric vehicle charging”, “craft breweries”. Ranks codes by title match first and description match second,
  • naics_crosswalk — Map a NAICS code between the 2017 and 2022 editions. Returns the code(s) it became (or came from), with titles and whether the industry was unchanged, split or merged. Codes of 5 digits or fewer are m
  • naics_sic_crosswalk — Map between the 4-digit SIC (Standard Industrial Classification, still printed on SEC filings) and NAICS. Pass sic to get candidate NAICS 2022 codes with titles, or naics (6 digits or fewer, 2022
  • naics_company — Find the NAICS (and SIC) industry codes a company is registered under. Reads SAM.gov entity registrations (primary and other NAICS codes the contractor itself declared, with titles; snapshot date repo

Tools

  • naics_company — Find the NAICS (and SIC) industry codes a company is registered under. Reads SAM.gov entity registrations (primary and other NAICS codes the contractor itself declared, with titles; snapshot date repo
  • naics_crosswalk — Map a NAICS code between the 2017 and 2022 editions. Returns the code(s) it became (or came from), with titles and whether the industry was unchanged, split or merged. Codes of 5 digits or fewer are m
  • naics_lookup — Look up a NAICS industry code (2 to 6 digits) and get its official title, the official description (what establishments in it do, with cross-references and exclusions), its level (sector, subsector, i
  • naics_search — Find NAICS industry codes from plain words, e.g. software publishers , dental offices , electric vehicle charging , craft breweries . Ranks codes by title match first and description match second, and
  • naics_sic_crosswalk — Map between the 4-digit SIC (Standard Industrial Classification, still printed on SEC filings) and NAICS. Pass `sic` to get candidate NAICS 2022 codes with titles, or `naics` (6 digits or fewer, 2022

Regenerated from source · build November 21, 2026