Census Acs
census_acsMedian home value and median rent for a US ZIP CODE, city, town, county or state, from the American Community Survey, the keyless way to answer "what do homes cost in 33158" or "median home price in Miami-Dade County" at a grain below metro level. Pass the geography the way a person says it: a 5-digit ZIP ("33158"), a place with its state ("Palmetto Bay, FL"), a county ("Miami-Dade County, FL"), or a state ("Florida"); FIPS codes and raw Census "for" syntax also work. Median home value is B25077_001E and median gross rent is B25064_001E (B25003 is tenure counts, not rent); the same call also serves ownership rates, vacancy and any other ACS variable code. Values are 5-year survey estimates, so they describe a period rather than this month's asking prices.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"geography": "33158",
"variables": "NAME,B25077_001E,B25064_001E"
},
"name": "census_acs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Survey year (default 2022). ACS 5-year estimates available from 2009 onward. | |
| _apiKey | Yes | Census API key | |
| geography | Yes | Geographic level and filter using Census "for" syntax (e.g., "state:06" for California, "county:*" for all counties, "state:*" for all states, "county:037&in=state:06" for LA County). | |
| variables | Yes | Comma-separated variable codes to retrieve (e.g., "NAME,B25001_001E,B25077_001E"). Always include NAME for place names. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Survey year queried | |
| results | Yes | Array of objects with Census data | |
| geography | Yes | Geographic filter used | |
| variables | Yes | Variable codes requested |