{"id":"com.zip-codes/api","slug":"com-zip-codes-api","title":"Zip Codes","description":"Validate & geocode a US address: 14 years of demographics, districts & schools. Agents buy via MPP.","version":"1.1.0","publisher":{"kind":"domain","id":"zip-codes.com","label":"zip-codes.com","url":"https://zip-codes.com"},"website":"https://www.zip-codes.com/api/mcp","repository":"https://github.com/ZIP-Codes-API/zip-codes-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.zip-codes.com/mcp","headers":[{"description":"Optional API key; without it the server runs in demo mode","isSecret":true,"name":"X-Api-Key"}]}],"packages":[],"published":"2026-11-11","updated":"2026-11-11","status":"online","auth":"","latency_ms":998,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"suggest_places","title":"Place search (type-ahead)","description":"Search for a place by partial name, misspelled name, or partial code — the resolver that turns what a person typed into something the other tools can look up. Fuzzy matching is built in: \"beverley hills\" finds Beverly Hills, \"san fransisco\" finds San Francisco, and a partial code like \"902\" finds the ZIP Codes starting with it. Matches US ZIP Codes, cities, USPS city names, counties, metropolitan ","read_only":true},{"name":"zip_lookup","title":"ZIP Code lookup","description":"The full record for a postal code — the main location-intelligence tool. Takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair, and returns the city, state or province, county, whether it spans more than one county, area codes, elevation, metro area and postal details (metro.msa and metro.pmsa are legacy 1999 definitions; the current metro area, the ","read_only":true},{"name":"zip_facts","title":"ZIP Code facts","description":"Statistics about US ZIP Codes and Canadian postal codes: how many exist, how they break down by type, delivery point and carrier route totals, per-state tables, and ranked lists such as the ZIP Codes with the most carrier routes. Every figure is generated from a stored query against the source data, with the date it was measured. Costs nothing and needs no key.","read_only":true},{"name":"quick_zip","title":"Quick ZIP / ZIP+4 / reverse geocode","description":"The fast, small answer for a postal code. Takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair, and returns the code's city, state or province, county, and whether it spans more than one county. Given a ZIP+4 it also returns the street ranges making up that delivery segment; given coordinates it reverse-geocodes to the code containing the point. zip","read_only":true},{"name":"city_name_rules","title":"City name rules","description":"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.","read_only":true},{"name":"buy_credits","title":"Buy credits","description":"Buy a credit pack with a wallet that pays MPP (Machine Payments Protocol) challenges, such as Stripe Link. The credits go on the account or prepaid card of the API key you send. Without a key, the purchase makes a prepaid card: a new API key holding the credits, in the result's api_key; pass it as api_key on later calls, and keep it (it is shown again only while the card is unused, for 24 hours). ","read_only":false},{"name":"radius_search","title":"Radius search","description":"Find every US ZIP Code and Canadian postal area within a radius of a centre point, with the distance to each. The centre takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair; a ZIP+4 searches from its parent ZIP, and coordinates are used as the point itself, so the centre comes back with no code. Centroid mode measures centre to centre and reaches 5","read_only":true},{"name":"about_data","title":"About this data","description":"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.","read_only":true},{"name":"distance","title":"Distance between two places","description":"Distance between two places, in miles and kilometres, plus the compass bearing from the first to the second. Each end takes a US ZIP Code, a US ZIP+4, a Canadian FSA, a Canadian postal code, or a latitude,longitude pair, and the two ends can be different kinds — a US ZIP to a Canadian postal code works, and so does a code to a coordinate. Time zone for both ends is included. This is a straight-lin","read_only":true},{"name":"validate_address","title":"Validate a US address","description":"Validate and standardise a US street address and return its ZIP+4. US ONLY — unlike the postal-code tools, this does not cover Canada. Send the address on one line in mailing order: number and street, then any unit (APT 4, STE 900, #9), then city, state and ZIP. It tolerates ordinary slips (a misspelling, a missing ZIP, state or directional), but it is not a puzzle to solve: a unit placed after th","read_only":true},{"name":"county_reference","title":"County reference","description":"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 ","read_only":true},{"name":"metro_area_reference","title":"Metro area reference","description":"US metropolitan and micropolitan statistical areas (CBSAs) — all 935. Of those only 393 are metropolitan; the rest are micropolitan and are NOT metro areas, so do not treat a CBSA count as a metro count. Each carries its divisions, parent combined area, land area and delivery footprint, plus the CMS Medicare labor market area, which is a DIFFERENT geography that shares the same code space. Filter ","read_only":true}],"server_info":{"name":"zip-codes","version":"1.0.0"},"category":"travel","tags":["agents","developer","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":174800,"score":100,"indexable":true,"first_seen":"2026-10-20","stars":0,"badges":["official"],"sponsor":null,"page":"https://agentsindex.org/agents/com-zip-codes-api/"}