# geo_contains Walk containment and return descendants at one requested level. | Field | Value | | --- | --- | | Category | Geography (`geo`) | | Exposure | public | | MCP tool | `geo_contains` | | Documentation | https://www.agentdatasets.com/docs/tools/geo_contains | ## Description Walk containment and return descendants at one requested level. Children are ordered by stable `geography_id`; each carries level, official code/name, country/state, row `as_of`, source, and attribution. The default page is 50 and maximum is 200. Pass `next_cursor` back until `has_more` is false. An unknown ID returns `unknown_entity`; an incompatible country/level returns `bad_parameter`. Example: `geo_contains(geography_id="state_48", child_level="county", limit=50)`. ## Parameters Input schema advertised to MCP clients and mirrored by the REST query string. | Parameter | In | Type | Required | Default | Constraints | Description | | --- | --- | --- | --- | --- | --- | --- | | geography_id | input | `string` | yes | — | — | Exact stable geography_id returned by geo_resolve. | | child_level | input | `"nation" \| "state" \| "county" \| "cbsa" \| "zip3" \| "zcta" \| "au_state" \| "au_gccsa" \| "au_sa4" \| "au_sa3" \| "au_lga"` | yes | — | — | Descendant level to return, such as county for a US state or au_sa4 for an Australian GCCSA. | | limit | input | `integer` | no | 50 | min 1, max 200 | Descendants per page (1–200). | | cursor | input | `string \| null` | no | null | — | Opaque cursor from pagination.next_cursor. Keep geography_id and child_level constant while paging; omit for the first page. | ## Provenance - `abs_asgs` — Australian Bureau of Statistics, Australian Statistical Geography Standard (ASGS) Edition 4: 2026 SA3-and-higher hierarchy, with Edition 3 2025 Local Government Areas (Creative Commons Attribution 4.0 International (cc-by-4.0)). See https://www.agentdatasets.com/docs/attribution.md - `census_geo` — U.S. Census Bureau, State and county geography reference codes (2020 vintage) (U.S. Government work, public domain (us-gov-public-domain); standard Census non-endorsement caveat applies). See https://www.agentdatasets.com/docs/attribution.md - `census_rel2020` — U.S. Census Bureau, ZCTA-to-county relationship file (2020 vintage) (U.S. Government work, public domain (us-gov-public-domain); standard Census non-endorsement caveat applies). See https://www.agentdatasets.com/docs/attribution.md - `omb_delineation_2023` — Office of Management and Budget (delineation lists distributed via the U.S. Census Bureau), Core-based statistical area (CBSA) delineation lists (2023 vintage) (U.S. Government work, public domain (us-gov-public-domain); standard Census non-endorsement caveat applies). See https://www.agentdatasets.com/docs/attribution.md Dataset registry: `geo_au_asgs`, `geo_us_reference`.