com.zip-codes/apiMCP Registry

Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics

v1.0.1

Validate & geocode a US address: demographics, districts & schools. Agents can buy credits via MPP.

Endpoint health

online

Last checked: 11/3/2026, 5:18:11 PM
Latency: 106 ms
Consecutive failures: 0

Endpoint reachable: pass
Protocol valid: pass
MCP handshake valid: pass

Machine-readable profile

mcp-server · schema v1 · callable

mcp-server:com.zip-codes%2Fapi

Profile JSON ↗

Connect this server

Generated config contains no credentials. Keep any required secrets in your client's local environment.

Client

{
  "mcpServers": {
    "com.zip-codes/api": {
      "url": "https://mcp.zip-codes.com/mcp"
    }
  }
}

Indexed tools

Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.

11 shown · authentication unknown

About this data
about_data
Where this server's data comes from: for each dataset the authority behind it, the edition served where the source publishes editions (TIGER/Line, ACS, ZCTA), how often a new release is taken, and a ready-made citation string. Costs nothing and needs no key.
Schema valid · SHA-256 cb3f0d986c8e…
View input schema
```
{
  "type": "object",
  "properties": {}
}
```
City name rules
city_name_rules
How USPS names a ZIP Code, and which of those names may be used on mail. Each ZIP Code has exactly one preferred city name plus alternates, and some alternates are NOT valid for addressing — for 08088 NJ, SHAMONG is valid while SHAMONG TOWNSHIP is not. Returns the rules, the counts and a worked example. Costs nothing and needs no key.
Schema valid · SHA-256 da47aa71ac43…
View input schema
```
{
  "type": "object",
  "properties": {}
}
```
County reference
county_reference
US counties and county equivalents — all 3,235 of them — with their Census and USPS names, which disagree for over a hundred, plus ANSI code, legal type, land and water area, and USPS delivery footprint. Filter by state to get every county in that state: without a filter only the first 25 are returned, and they are FIPS-ordered, so an unfiltered call answers with Alabama rather than with whatever was asked about. Costs nothing and needs no key.

Connections

streamable-http
https://mcp.zip-codes.com/mcp

Links

Website ↗Repository ↗Health JSON ↗

Indexed tools

Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.

11 shown · authentication unknown

About this data

about_data

Where this server's data comes from: for each dataset the authority behind it, the edition served where the source publishes editions (TIGER/Line, ACS, ZCTA), how often a new release is taken, and a ready-made citation string. Costs nothing and needs no key.

Schema valid · SHA-256 cb3f0d986c8e…

View input schema

{
  "type": "object",
  "properties": {}
}

City name rules

city_name_rules

How USPS names a ZIP Code, and which of those names may be used on mail. Each ZIP Code has exactly one preferred city name plus alternates, and some alternates are NOT valid for addressing — for 08088 NJ, SHAMONG is valid while SHAMONG TOWNSHIP is not. Returns the rules, the counts and a worked example. Costs nothing and needs no key.

Schema valid · SHA-256 da47aa71ac43…

View input schema

{
  "type": "object",
  "properties": {}
}

County reference

county_reference

US counties and county equivalents — all 3,235 of them — with their Census and USPS names, which disagree for over a hundred, plus ANSI code, legal type, land and water area, and USPS delivery footprint. Filter by state to get every county in that state: without a filter only the first 25 are returned, and they are FIPS-ordered, so an unfiltered call answers with Alabama rather than with whatever was asked about. Costs nothing and needs no key.

{ "type": "object", "properties": { "state": { "description": "Two-letter US state or territory code. Returns every area that includes that state — an area can span several, so it is matched against the area's whole state list. Omit to browse all states.", "type": "string", "enum": [ "AK", "AL", "AR", "AS", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "GU", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MP", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VI", "VT", "WA", "WI", "WV", "WY" ], "default": null }, "limit": { "description": "Cap the number of areas returned. Defaults to 25 when no state is given, or to all areas in the state when one is.", "type": [ "integer", "null" ], "default": null } } }

{ "type": "object", "properties": { "code": { "description": "Centre point: a US ZIP Code, ZIP+4, Canadian FSA or postal code, or a latitude,longitude pair.", "type": "string" }, "max": { "description": "Radius in miles, as a number or a string. Up to 500 in centroid mode or 250 in spatial mode; exceeding the cap is an error rather than being reduced. May also be 'auto' to pick a radius from local population density, or 'auto-commute' to use commuting patterns where available.", "type": "string" }, "min": { "description": "Minimum radius in miles, to exclude the middle and search a ring. Must be less than max. Defaults to 0.", "type": [ "number", "null" ], "default": null }, "mode": { "description": "How to measure. centroid measures centre to centre and is the default when omitted; spatial intersects actual boundaries and adds how much of each area lies inside, at a lower maximum radius.", "type": "string", "enum": [ "centroid", "spatial" ], "default": null }, "limit": { "description": "Maximum number of matches to return, up to 100, which is also the default. A larger value is reduced to 100 and the result says so in notices. When the list is cut, summary.total_available is the number of matches in the radius (summary.total_count is the number returned) and a RESULTS_CAPPED notice says so; to see matches beyond the first 100, narrow the radius or raise `min` to step outwards in bands.", "type": [ "integer", "null" ], "default": null }, "include": { "description": "Enrichments, spelled as the REST API's /v2/radius include flags; each multiplies the credit cost. timezone lands on each match. acs_PROFILE (current release) and acs_PROFILE_YYYY return aggregate statistics across the whole result set, with the same field paths every year. Census and district enrichments are not available here; use zip_lookup. Accepted: timezone, acs_demographic, acs_social, acs_economic, acs_housing; acs_demographic_YYYY, acs_social_YYYY, acs_economic_YYYY, acs_housing_YYYY for YYYY 2011-2024. A bare flag is its newest year.", "default": null, "type": [ "array", "null" ], "items": { "type": "string", "pattern": "^(timezone|acs_demographic|acs_social|acs_economic|acs_housing|(acs_demographic|acs_social|acs_economic|acs_housing)_(201[1-9]|202[0-4]))$" } }, "acs_years": { "description": "Alias, kept for clients that learned it before include took year flags: ACS release years for the bare acs_ profiles in include (acs_social with acs_years [2015] is acs_social_2015). Prefer the year flags in include. At most 16 profile-years per call. 2011 to 2024 (2024 is the current release).", "type": [ "array", "null" ], "items": { "type": "integer", "minimum": 2011, "maximum": 2024 }, "default": null } }, "required": [ "code", "max" ] }

{ "type": "object", "properties": { "q": { "description": "What the user typed. At least one character, at most 200.", "type": "string" }, "limit": { "description": "How many results to return. Defaults to 10; free-tier and demo callers are capped at 15, paid keys reach 500. With a key the credit cost follows the requested limit (up to 15: 1 credit; 50: 2; 150: 3; 500: 5), whether or not anything matches; demo calls are not charged.", "type": [ "integer", "null" ], "default": null }, "types": { "description": "Restrict to these kinds of place. Omit to search all of them.", "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "zip", "place", "county", "cbsa", "fsa", "state", "school_district", "ca_postal", "uspscity" ] }, "default": null }, "state": { "description": "Restrict to one US state or Canadian province, as a two-letter abbreviation such as CA, NY or ON.", "default": null, "type": [ "string", "null" ] }, "country": { "description": "Restrict to one country. Omit to search both.", "type": "string", "enum": [ "US", "CA" ], "default": null }, "near": { "description": "Bias results towards somewhere. Accepts 'latitude,longitude', a 5-digit ZIP Code, a 3-character Canadian FSA, or a two-letter state or province abbreviation.", "default": null, "type": [ "string", "null" ] } }, "required": [ "q" ] }

{ "type": "object", "properties": { "address": { "description": "The address on one line. A city and state, or a ZIP Code, helps but neither is required — '1600 Pennsylvania Ave NW, Washington DC' and '1600 Pennsylvania Ave NW 20500' both resolve. Between 9 and 300 characters once spacing is normalised.", "type": "string" }, "include": { "description": "Data to append to the match, spelled exactly as the REST API's /v2/address include flags, each costing one extra credit. 'coordinates' adds the latitude and longitude. 'census' adds the county, county subdivision, place, tract, block group and CBSA the address falls in; 'cd' adds its congressional district; 'state_leg' adds its upper and lower state legislative districts; 'school_district' adds its school district; 'timezone' adds the time zone at the matched point. census_YYYY, cd_YYYY and state_leg_YYYY add those boundaries as of a TIGER/Line year (the bare flag is the newest year, answered under `current`; other years under their own key). The 'acs_tract_*' values add an American Community Survey 5-year profile for the address's census tract: four profiles (demographic, social, economic, housing), unsuffixed for the current release or acs_tract_PROFILE_YYYY for an earlier one, in one schema, so a tract can be compared across years. Accepted: coordinates, census, cd, state_leg, school_district, timezone, acs_tract_demographic, acs_tract_social, acs_tract_economic, acs_tract_housing; census_YYYY, cd_YYYY, state_leg_YYYY for YYYY 2010-2025; acs_tract_demographic_YYYY, acs_tract_social_YYYY, acs_tract_economic_YYYY, acs_tract_housing_YYYY for YYYY 2022-2024. A bare flag is its newest year.", "default": null, "type": [ "array", "null" ], "items": { "type": "string", "pattern": "^(coordinates|census|cd|state_leg|school_district|timezone|acs_tract_demographic|acs_tract_social|acs_tract_economic|acs_tract_housing|(census|cd|state_leg)_(201\\d|202[0-5])|(acs_tract_demographic|acs_tract_social|acs_tract_economic|acs_tract_housing)_202[2-4])$" } } }, "required": [ "address" ] }

{ "type": "object", "properties": { "code": { "description": "A US ZIP Code, ZIP+4, Canadian FSA, or Canadian postal code. For example 90210, 90210-1234, M5V, or M5V 2T6.", "type": "string" }, "include": { "description": "Enrichments, spelled as the REST API's /v2/zip include flags. Each multiplies the credit cost: base times (1 + number of enrichments). census, cd (congressional district) and state_leg are US Census Bureau data; census_YYYY, cd_YYYY, state_leg_YYYY add boundaries as of a TIGER/Line year (the bare flag answers under `current`, other years under their own key). statcan is Canada only: Statistics Canada geography for a Canadian FSA or postal code, federal electoral districts included, under `statcan` (statcan_YYYY for a census year; census or cd on a Canadian code is answered as statcan). acs_PROFILE is the current American Community Survey release, acs_PROFILE_YYYY an earlier one; every ACS year has the SAME FIELD PATHS, so values compare across years directly. Accepted: timezone, census, cd, state_leg, school_district, demographics, medicare, statcan, acs_demographic, acs_social, acs_economic, acs_housing; statcan_YYYY for YYYY 2011, 2016, 2021; census_YYYY, cd_YYYY, state_leg_YYYY for YYYY 2010-2025; acs_demographic_YYYY, acs_social_YYYY, acs_economic_YYYY, acs_housing_YYYY for YYYY 2011-2024. A bare flag is its newest year.", "default": null, "type": [ "array", "null" ], "items": { "type": "string", "pattern": "^(timezone|census|cd|state_leg|school_district|demographics|medicare|statcan|acs_demographic|acs_social|acs_economic|acs_housing|statcan_(201[16]|2021)|(census|cd|state_leg)_(201\\d|202[0-5])|(acs_demographic|acs_social|acs_economic|acs_housing)_(201[1-9]|202[0-4]))$" } }, "acs_years": { "description": "Alias, kept for clients that learned it before include took year flags: ACS release years for the bare acs_ profiles in include (acs_social with acs_years [2015, 2024] is acs_social_2015 plus acs_social). Prefer the year flags in include. Every year has the SAME FIELD PATHS, and the answer comes back keyed by year. At most 16 profile-years per call. 2011 to 2024 (2024 is the current release).", "type": [ "array", "null" ], "items": { "type": "integer", "minimum": 2011, "maximum": 2024 }, "default": null } }, "required": [ "code" ] }

Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics

Endpoint health

Machine-readable profile

Connect this server

Indexed tools

About this data

City name rules

County reference

Connections

Links

Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics

Endpoint health

Machine-readable profile

Connect this server

Indexed tools

About this data

City name rules

County reference

Connections

Links

Distance between two places

Metro area reference

Quick ZIP / ZIP+4 / reverse geocode

Radius search

Place search (type-ahead)

Validate a US address

ZIP Code facts

ZIP Code lookup