census-geocoding-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_benchmarksB | List all available benchmarks for the Census Geocoder. A benchmark references a version of the MAF/TIGER locator database (e.g. Public_AR_Current, Public_AR_Census2020). |
| list_vintagesA | List all available vintages for a given benchmark. Vintages reference the Census geography version used for geoLookup (e.g. Current_Current, Census2020_Current). Required when using Find Geographies endpoints. |
| geocode_oneline_addressA | Geocode a single address provided as one line (e.g. '101 Marietta St, Atlanta, GA, 30303'). Returns matched address, interpolated coordinates, Tigerline ID, and address range components. Missing fields (city, state, ZIP) can be omitted or represented with commas. |
| geocode_parsed_addressA | Geocode a single US (stateside) address with fields parsed into separate components. Returns matched address, interpolated coordinates, Tigerline ID, and address range components. At minimum, street and zip OR street, city, and state must be provided. Does NOT support Puerto Rico addresses with Urbanization/Municipio. |
| geocode_pr_addressA | Geocode a single Puerto Rico address with support for Urbanization and Municipio fields. To submit a PR address without Urbanization, provide at minimum street + zip OR street + city + state. To submit with Urbanization, provide at minimum street + urb + municipio. State is always PR. |
| find_geographies_onelineB | Geocode a one-line address AND return associated Census geographies (States, Counties, Census Tracts, Census Blocks, Congressional Districts, County Subdivisions, Incorporated Places, State Legislative Districts, Urban Areas, Combined Statistical Areas, etc.). Requires a benchmark and vintage. |
| find_geographies_parsedA | Geocode a parsed US (stateside) address AND return associated Census geographies. At minimum, street and zip OR street, city, and state must be provided. Does NOT support Puerto Rico Urbanization/Municipio. |
| find_geographies_prB | Geocode a Puerto Rico address AND return associated Census geographies including Urbanization and Municipio information. To submit without Urbanization, provide at minimum street + zip OR street + city + state. To submit with Urbanization, provide at minimum street + urb + municipio. |
| find_geographies_coordinatesA | Look up Census geographies for a given longitude/latitude coordinate pair. Returns States, Counties, Census Tracts, Census Blocks, Congressional Districts, County Subdivisions, Incorporated Places, State Legislative Districts, Urban Areas, Combined Statistical Areas, and more. |
| batch_geocode_locationsA | Batch geocode up to 10,000 addresses (locations only, no Census geographies). Provide addresses either as a raw CSV string or as a structured array. CSV format: UniqueID,Street,City,State,ZIP (all fields except UniqueID and Street are optional but must retain delimiter). Returns a CSV with: Record ID, Input Address, Match Indicator, Match Type, Output Address, Coordinates, Tigerline ID, Tigerline Side. |
| batch_geocode_geographiesA | Batch geocode up to 10,000 addresses AND return associated Census geographies (State, County, Tract, Block Codes). Provide addresses as raw CSV or structured array. CSV format: UniqueID,Street,City,State,ZIP. Returns a CSV with: Record ID, Input Address, Match Indicator, Match Type, Output Address, Coordinates, Tigerline ID, Tigerline Side, State Code, County Code, Tract Code, Block Code. |
| batch_geolookup_coordinatesB | Batch look up Census geographies for up to 10,000 coordinate pairs (longitude/latitude). Provide coordinates as raw CSV or structured array. CSV format: UniqueID,Longitude(X),Latitude(Y). Returns State, County, Tract, and Block codes for each coordinate. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Tools follow a clear two-axis matrix: geocode (coordinates) vs find_geographies (geographies), crossed with input format (oneline/parsed/pr/coordinates) and batch variants. The oneline/parsed/pr trios return the same content for different address formats, so a careless agent could misselect, but descriptions clearly delineate input requirements and PR-specific handling.
Names are predominantly consistent snake_case verb_noun (geocode_oneline_address, find_geographies_pr, batch_geocode_locations). Minor inconsistencies exist (e.g. 'oneline' token placement and the batch_ prefix convention), but the pattern remains predictable and readable.
12 tools is well-scoped for a geocoding API. Each tool earns its place: catalog lookups, three address-format variants, a coordinate lookup, and three batch operations mirror the underlying Census endpoints without redundancy.
The surface covers the full lifecycle: benchmark/vintage discovery, single and batch geocoding, coordinate reverse geolookup, geography lookups, and all address formats including PR Urbanization/Municipio. No obvious dead ends for geocoding workflows.