mcpwright avatar

Census (ACS by ZIP)

mcpwright/census-mcp

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 tools

Public 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 as io.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


View the full README on GitHub

Details

Repository
github.com/mcpwright/census-mcp
Category
Data & Analytics
Package
mcpwright-census
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from mcpwright

Related Data & Analytics MCP servers

View all
1food-near-me avatarFood Near Mefood-near-me/platformAI-native restaurant discovery: verified/menu-indexed/discovered tiers + signed allergy-safety data.0stars
2megamind-0x avatarSkillAuditmegamind-0x/skillauditSecurity scanner for AI agent skills and MCP servers. Detects credential theft, data exfiltration, prompt injection, obfuscated code, and 80+ threat patterns. F0stars
3mercuryx402 avatarMercury X402 Mcpmercuryx402/mercury-x402-mcpAgent-payable web data over x402: 18 keyless services an agent pays per call.0stars
4microqueryhq avatarMicroquery Mcpmicroqueryhq/microquery-mcpSQL over real-world data — FDA, SEC, blockchain, genomics, CVEs, and more. No config.0stars
5mikejj-creation avatarStocksensemikejj-creation/stocksenseFinancial data for AI agents: SEC filings, price history, insider trades, and more.0stars
6mirabello-consultancy avatarMirabello Immigration Intelligencemirabello-consultancy/mcp-serverCitizenship, residency & tax-residency data for 190+ countries, with origin-aware route planning0stars