@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_lookupaccepts31,32or33and resolves them to31-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_naicsshows 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 inscripts/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
sicto get candidate NAICS 2022 codes with titles, ornaics(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 reponaics_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 mnaics_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, inaics_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, andnaics_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