# geo_resolve Resolve a place or code to stable canonical geography IDs. | Field | Value | | --- | --- | | Category | Geography (`geo`) | | Exposure | public | | MCP tool | `geo_resolve` | | Documentation | https://www.agentdatasets.com/docs/tools/geo_resolve | ## Description Resolve a place or code to stable canonical geography IDs. The shared envelope echoes the query and optional filters in `data`. Each bounded relevance match carries `geography_id`, level, official code/name, country/state, match score/reason, bottom-up containment parents, official outgoing crosswalks, row `as_of`, source, and any required attribution. AU entities carry ABS ASGS CC BY 4.0 attribution; US entities identify Census/OMB provenance. `pagination` is null because this is a nearest-N relevance result; the limit is 1–50. Use this first when you have a place rather than an ID, then call `geo_get`, `geo_contains`, or `geo_crosswalk`. A conflicting level and country returns `bad_parameter`. Example: `geo_resolve(query="Sydney", country="AU", limit=10)`. ## Parameters Input schema advertised to MCP clients and mirrored by the REST query string. | Parameter | In | Type | Required | Default | Constraints | Description | | --- | --- | --- | --- | --- | --- | --- | | query | input | `string` | yes | — | — | Free-text place, alias, postal abbreviation, or official code, such as 'Sydney', 'NSW', 'Harris County, TX', '48201', or '12420'. | | level | input | `"nation" \| "state" \| "county" \| "cbsa" \| "zip3" \| "zcta" \| "au_state" \| "au_gccsa" \| "au_sa4" \| "au_sa3" \| "au_lga" \| null` | no | null | — | Optional canonical geography level filter. | | country | input | `"US" \| "AU" \| null` | no | null | — | Optional country filter: US or AU. | | limit | input | `integer` | no | 10 | min 1, max 50 | Ranked matches to return (1–50). | ## 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`.