
Census (ACS by ZIP)
Brings U.S. Census Bureau American Community Survey data into your agent via eight read-only tools. You get income breakdowns (median household, per-capita, percent over $200k), demographics (population, median age), housing stats (home values, rent, owner-occupancy rates), and education attainment for any ZIP code. The compare_zips tool ranks multiple locations by a chosen metric, while find_zips does reverse lookup from city name to ZIPs. Data is bulk-downloaded once from the Census API into a local SQLite store, then served offline. Reach for this when your agent needs to contextualize locations with economic or demographic data without hitting external APIs on every query.
- tools
- 8
- auth
- Required
- transport
- STDIO
- env var
- 1
- last updated
- Aug 20, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
lookup_zipConfirm a ZIP maps to a Census ZCTA; returns name, total population, and the ACS vintage.
Confirm a ZIP maps to a Census ZCTA; returns name, total population, and the ACS vintage.
No parameter schema in public metadata yet.
get_incomeMedian household income, per-capita income, total households, and the % of households earning $200k+.
Median household income, per-capita income, total households, and the % of households earning $200k+.
No parameter schema in public metadata yet.
get_demographicsTotal population and median age.
Total population and median age.
No parameter schema in public metadata yet.
get_housingMedian home value, median gross rent, occupied units, and % owner-occupied.
Median home value, median gross rent, occupied units, and % owner-occupied.
No parameter schema in public metadata yet.
get_educationOf adults 25+, the % with a bachelor's degree or higher and the % with a graduate/professional degree.
Of adults 25+, the % with a bachelor's degree or higher and the % with a graduate/professional degree.
No parameter schema in public metadata yet.
compare_zipsRank several ZIPs by one metric (income, age, home value, attainment, …), highest first.
Rank several ZIPs by one metric (income, age, home value, attainment, …), highest first.
No parameter schema in public metadata yet.
get_acs_variableEscape hatch: the raw value of any stored ACS variable, by code or friendly name.
Escape hatch: the raw value of any stored ACS variable, by code or friendly name.
No parameter schema in public metadata yet.
find_zipsReverse lookup: the ZIPs that fall within a city/town/CDP, ranked by how much of each ZIP's land lies in the place.
Reverse lookup: the ZIPs that fall within a city/town/CDP, ranked by how much of each ZIP's land lies in the place.
No parameter schema in public metadata yet.
Sponsors
Configuration
CENSUS_API_KEY*Free Census API key (get one at https://api.census.gov/data/key_signup.html). Required for the one-time bulk download of the ACS dataset.
Readme
census-mcp
U.S. Census data by ZIP code, inside your agent. An MCP
server that lets an LLM look up income, demographics, housing, and education for any ZIP —
built on Anthropic's official mcp Python SDK.
All tools are read-only. Data is the U.S. Census Bureau's American Community Survey (ACS) 5-year release — bulk-downloaded once into a local store, then served offline. A free Census API key is required for the one-time download.
Status: published (v0.1.2) —
uvx mcpwright-census(PyPI) and listed in the official MCP Registry asio.github.mcpwright/census-mcp. All 8 tools below are live and unit-tested, verified end-to-end against the live ACS 5-year release (vintage 2024 at the time of writing — the server auto-detects the latest). Part of the mcpwright suite.
Tools
Details
- Repository
- github.com/mcpwright/census-mcp
- Category
- Data & Analytics
- Package
mcpwright-census- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active