irs_exempt_org_get

Pack: irs-exempt-orgs · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/irs_exempt_org_get for the schema, then POST the same URL with its arguments for the data.

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 type (private operating, private non-operating, public charity, supporting organization), deductibility, NTEE category, filing requirement, and the latest reported assets, income and revenue in US dollars. Every code is returned raw with its plain meaning. Each answer carries data_as_of and answered_from. Use irs_exempt_org_search to find organisations by ruling date, foundation type or assets. Keyless.

Parameters

NameTypeRequiredDescription
einstringyes9-digit Employer Identification Number, with or without the dash, e.g. “010548657” or “01-0548657”.

Example call

Arguments

{
  "ein": "010548657"
}

curl

curl -X POST https://gateway.pipeworx.io/irs-exempt-orgs/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"irs_exempt_org_get","arguments":{"ein":"010548657"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('irs_exempt_org_get', {
  "ein": "010548657"
});

More examples

{
  "ein": "01-0561836"
}

Response shape

FieldTypeDescription
foundboolean
reasonstring
messagestring
hintstring
answered_fromstring
data_as_ofstring
sourcestring
einstring
amounts_notestring
organizationobject
Full JSON Schema
{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "reason": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "hint": {
      "type": "string"
    },
    "answered_from": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "ein": {
      "type": "string"
    },
    "amounts_note": {
      "type": "string"
    },
    "organization": {
      "type": "object",
      "properties": {
        "ein": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "address": {
          "type": "object",
          "properties": {
            "street": {
              "type": [
                "string",
                "null"
              ]
            },
            "city": {
              "type": [
                "string",
                "null"
              ]
            },
            "state": {
              "type": [
                "string",
                "null"
              ]
            },
            "zip": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "ruling_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "ruling_date_raw": {
          "type": [
            "string",
            "null"
          ]
        },
        "subsection": {
          "type": "object",
          "properties": {
            "code": {
              "type": [
                "string",
                "null"
              ]
            },
            "meaning": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "foundation": {
          "type": "object",
          "properties": {
            "code": {
              "type": [
                "string",
                "null"
              ]
            },
            "meaning": {
              "type": [
                "string",
                "null"
              ]
            },
            "private_foundation": {
              "type": "boolean"
            }
          }
        },
        "deductibility": {
          "type": "object",
          "properties": {
            "code": {
              "type": [
                "string",
                "null"
              ]
            },
            "meaning": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "exemption_status": {
          "type": "object",
          "properties": {
            "code": {
              "type": [
                "string",
                "null"
              ]
            },
            "meaning": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "organization_type": {
          "type": "object",
          "properties": {
            "code": {
              "type": [
                "string",
                "null"
              ]
            },
            "meaning": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "affiliation": {
          "type": "object",
          "properties": {
            "code": {
              "type": [
                "string",
                "null"
              ]
            },
            "meaning": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "group_exemption_number": {
          "type": [
            "string",
            "null"
          ]
        },
        "classification_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "activity_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "ntee": {
          "type": "object",
          "properties": {
            "code": {
              "type": [
                "string",
                "null"
              ]
            },
            "major_group": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "pf_filing_required": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "filing_requirement_code": {
          "type": [
            "string",
            "null"
          ]
        },
        "latest_return_tax_period": {
          "type": [
            "string",
            "null"
          ]
        },
        "accounting_period_end_month": {
          "type": [
            "string",
            "null"
          ]
        },
        "assets": {
          "type": "object",
          "properties": {
            "amount_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "band_code": {
              "type": [
                "string",
                "null"
              ]
            },
            "band": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "income": {
          "type": "object",
          "properties": {
            "amount_usd": {
              "type": [
                "number",
                "null"
              ]
            },
            "band_code": {
              "type": [
                "string",
                "null"
              ]
            },
            "band": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "revenue_amount_usd": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the irs-exempt-orgs pack
{
  "mcpServers": {
    "irs-exempt-orgs": {
      "url": "https://gateway.pipeworx.io/irs-exempt-orgs/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 14, 2026