US Census geography hierarchy

us_get_geography_list

TW-specificMIT

**關鍵字 / Keywords**: 美國人口普查地理層級州郡區州碼郡碼 tract block group FIPS GEOID geography level state county census tract block group hierarchy

Scope: US Census Bureau · api.census.gov geography hierarchy.

List the geography levels valid for one dataset — state, county,
county subdivision, place, tract, block group, ZCTA, congressional
district, etc. Also tells you which parent levels a child requires
(e.g. tract requires state+county in the `in_geo` param).

Endpoint:
    https://api.census.gov/data/{year}/{dataset}/geography.json

Args:
    year: vintage year (e.g. 2022, "2020").
    dataset: dataset path — "acs/acs5", "dec/pl", ...

Returns dict with `geographies` — each entry has `name`
(e.g. "state"), `geo_level` (FIPS-style 3-digit like "040"),
`reference_date`, `requires` (parent-geo list), `wildcard`. No API
key required. License: US Public Domain.

Input schema

{
  "properties": {
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ],
      "title": "Year"
    },
    "dataset": {
      "title": "Dataset",
      "type": "string"
    }
  },
  "required": [
    "year",
    "dataset"
  ],
  "title": "us_get_geography_listArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see us_get_geography_list. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 us_get_geography_list 處理 "…"。

# It will call:
us_get_geography_list(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs