Look up a ZIP
lookup_zipRead-only
Check if a US ZIP code has IRS SOI data, then retrieve its return and individual counts, state, and tax year.
Instructions
Confirm a ZIP has SOI data and return its return and individual counts.
`zip_code`: a 5-digit US ZIP. A good first call to validate a ZIP before
asking for more detail. Returns the state, number of returns, number of
individuals, and the SOI tax year. ZIPs with <100 returns are excluded.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"zip_code": "<zip_code>"
},
"name": "lookup_zip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip_code | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | 2-letter USPS state code | |
| returns | No | Total number of tax returns filed from this ZIP | |
| zipcode | Yes | 5-digit ZIP code | |
| tax_year | Yes | SOI tax year of the data | |
| individuals | No | Total number of individuals (filers plus dependents) |