Get income by ZIP
get_incomeRead-only
Retrieve median household income, per-capita income, household count, and percentage earning $200k+ for any U.S. ZIP code using ACS 5-year estimates.
Instructions
Income measures for a ZIP: median household, per-capita, and % $200k+.
`zip_code`: a 5-digit US ZIP. Returns median household income, per-capita
income, the number of households, and the percent of households earning
$200k+ — all ACS 5-year estimates in USD. Note: ACS top-codes median
household income at $250,001, so the wealthiest ZIPs (e.g. Atherton 94027)
report exactly that — read it as "$250k or more," not an exact figure.
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": "get_income"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip_code | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Census name for the area | |
| zcta | Yes | 5-digit ZIP Code Tabulation Area | |
| vintage | Yes | ACS 5-year data vintage (end year) | |
| total_households | No | Total number of households | |
| per_capita_income | No | Per-capita income | |
| median_household_income | No | Median household income | |
| households_200k_plus_pct | No | Percent of households with income $200k+ (0-100) |