census-mcp-server

Tools · 7

• census_compare_geographies

  Compare one or more variables across multiple geographies at the same level — all counties in a state, all states nationally, or a named set of specific geographies. Results are sorted and ranked. Covers queries like "rank states by poverty rate", "compare median income across WA counties", or "which census tracts in King County have the highest renter rate." Omit within to compare all geographies nationally at the level. Suppressed values are decoded to human-readable labels rather than passed through as raw negative sentinels.

• census_get_variable

  Fetch full metadata for one or more Census variable codes — label, concept group, predicate type, universe, and margin-of-error sibling references. Use to confirm a variable code before building a query, or to look up what a known code means. Returns estimate\_code and moe\_code sibling references where applicable so you can request both without a separate search.

• census_list_datasets

  Browse available Census Bureau datasets with their supported vintage years. Use as the starting point when the right dataset is unknown — ACS5, ACS1, population estimates, and decennial census serve different use cases. Pass the dataset\_id value to the dataset parameter in other census tools.

• census_list_geographies

  List the geography levels available for a given Census dataset and year, along with the parent geographies each level requires. Use before querying to confirm that the target geography level exists — ACS1 omits many sub-state levels, and not all datasets support tracts or block groups. The geography\_level values returned here are the valid inputs to the geography\_level parameter in census\_query\_data and census\_compare\_geographies.

• census_query_data

  Query a Census dataset for one or more variables at a specific geography. Accepts FIPS codes for the target geography — use census\_resolve\_geography to convert place names to FIPS when needed. Labeled estimates and margin-of-error values are returned together. Suppression codes (geography too small, data not collected) are decoded into human-readable reasons rather than passed through as raw negative numbers. Pass geography\_fips as "\*" to return all geographies at the level within the parent.

• census_resolve_geography

  Resolve a place name or street address to Census FIPS identifiers (state, county, tract codes). Converts names like "King County, WA" or "Seattle, WA" to the FIPS codes required by census\_query\_data and census\_compare\_geographies. Use before querying when you have a place name rather than raw FIPS codes — state\_fips maps to parent\_fips and fips\_summary maps to geography\_fips in downstream tools.

• census_search_variables

  Search Census variables by keyword across variable labels and concept groups. Returns variable codes with human-readable labels — use this to go from a concept like "median household income" to the variable code B19013\_001E needed for data queries. Returns both estimate (E suffix) and margin-of-error (M suffix) codes so you can request both. When total\_matches exceeds the limit, narrow the query to see more specific results.