@pipeworx/irs-exempt-orgs

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/irs-exempt-orgs’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: 2

US tax-exempt organisations from the IRS Exempt Organizations Business Master File: ruling date (when the IRS determined exemption), foundation type, subsection, NTEE category and latest assets, income and revenue, for about 1.9 million organisations. Look one up by EIN, or find them by ruling date, foundation type, state and size.

Tools

• irs_exempt_org_get(ein) — the full record for one EIN, with every code returned raw and decoded (subsection, foundation type, deductibility, exemption status, asset and income bands, NTEE major group).
• irs_exempt_org_search(ruling_from?, ruling_to?, private_foundation?, foundation_code?, state?, subsection?, ntee?, min_assets?, sort?, limit?) — finds organisations, ranked by latest assets (or income, revenue, ruling date). Answers “private foundations determined in 2025 or later, largest first”.

irs_exempt_org_search({private_foundation: true, ruling_from: "2025-01", limit: 10})
  -> organizations sorted by assets_usd, each with ruling_date, foundation {code, meaning}, ntee
irs_exempt_org_get({ein: "010548657"})
  -> Kuehner Brothers Foundation Inc, ruling_date 2003-03, foundation 04 private non-operating

Auth

Keyless.

Data sources

• IRS, Exempt Organizations Business Master File Extract. US federal data, public domain. Every answer carries data_as_of (the date the IRS last published the extract; the file has no date of its own) and answered_from (always stored_copy).

The extract is about 340 MB, too big to read per call, so a stored copy answers every call and a scheduled loader refreshes it (the IRS republishes monthly). There is no live fallback: before the first load, or if the copy cannot be read, both tools return found: false, reason: "stored_copy_unavailable" rather than an empty result.

Caveats worth passing on:

• Search must be bounded. Give a ruling-date window, or private_foundation: true, or a small state. A search that would scan more than 150,000 organisations returns reason: "too_broad" and says how to narrow it. Searching by organisation name is not built; the lookup is by EIN.
• A null amount is not zero. An organisation that has not filed a return carries no asset or income figure; the file leaves it blank and so does the answer. Amounts are as last reported, which may be several years old (latest_return_tax_period on the full record).
• Ruling date is the IRS determination, not the founding date. An organisation can be decades older than its ruling.
• Codes not in the pack’s tables decode to null with the raw code kept; nothing is guessed.
• Organisation records only. The file’s “in care of” line, which is usually a person’s name, and its secondary sort name are not loaded or returned.
• Fields are positional in the stored shards (see the header of src/index.ts and scripts/lib/irs-eo-parse.mjs); the test suite builds shards with the loader’s own module and reads them through the pack.

Tools

• irs_exempt_org_get — Look up one US tax-exempt organisation by EIN in the IRS Exempt Organizations Business Master File: name, address, ruling date (when the IRS granted exemption), subsection (501(c)(3) etc.), foundation
• irs_exempt_org_search — Find US tax-exempt organisations in the IRS Exempt Organizations Business Master File by ruling date (when the IRS determined exemption), foundation type, state, subsection, NTEE category and minimum