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

> Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics is a freemium MCP server for maps and travel. Validate US addresses and get ZIP+4, census-tract demographics, districts and schools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://www.zip-codes.com/api/mcp
- **Repository:** https://github.com/zip-codes-api/zip-codes-mcp
- **MCP Registry name:** com.zip-codes/api
- **Categories:** maps and travel, analytics and data
- **Listing updated:** 2026-11-14

## About

A messy one-line street address goes in; a standard address with ZIP+4 comes out, plus whatever you ask about the area around it. The server says an address that does not exist never gets an invented ZIP+4: it returns no match, or a low-confidence match without one. Area data covers the census tract's American Community Survey estimates with margins of error, county, place, metro area, congressional and state legislative districts, school district and time zone.

Other tools handle quick ZIP and ZIP+4 lookups, reverse geocoding, radius search over US and Canadian areas, distance with compass bearing, fuzzy place search and reference lists such as all 935 metro areas. The site's example validates the Empire State Building address with census, school district, income and housing fields for 5 credits. Statistics describe the tract, never the person at the address.

It works with no key in demo mode, which returns real values but withholds some deeper fields. A free key adds 2,500 credits a day, at the same credit rates as the REST API. Agents with an MPP wallet can use buy_credits to purchase a key or credits, with the wallet owner approving each payment.

## Features

- **Address validation:** Standardizes messy addresses and returns ZIP+4 or no match.
- **Tract demographics:** ACS income, rent and housing estimates with margins of error.
- **Districts and schools:** Congressional, state legislative and school districts.
- **Radius and distance:** Find ZIPs or postal areas within a radius; distance and bearing.
- **Demo mode:** Works with no key, with some fields withheld.
- **Agent purchasing:** buy_credits lets an MPP wallet buy credits with owner approval.

## Good for

- Validate an address before shipping
- Profile the neighborhood around a site
- Plan territories by ZIP radius
- Find the school district for an address

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http api https://mcp.zip-codes.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.zip-codes.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "api": {
      "type": "http",
      "url": "https://mcp.zip-codes.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "api": {
      "serverUrl": "https://mcp.zip-codes.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "api": {
      "type": "http",
      "url": "https://mcp.zip-codes.com/mcp"
    }
  }
}
```

## Tools

- `suggest_places`: 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 
- `zip_lookup`: 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 
- `zip_facts`: 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.
- `quick_zip`: 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
- `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.
- `buy_credits`: 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). 
- `radius_search`: 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
- `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.
- `distance`: 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
- `validate_address`: 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
- `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 
- `metro_area_reference`: 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 

## FAQ

### Do I need a key?

No. Demo mode needs no key but withholds some deeper fields; a free key gives complete answers.

### How many free credits are included?

A free key includes 2,500 credits a day.

### Does it invent ZIP+4 codes?

No. Non-existent addresses return no match or a low-confidence match with no ZIP+4.

### Whose data do the statistics describe?

The census tract, never the person at the address.

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

Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics has a free plan, with paid plans for more usage or features.

### How do I add Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics to Claude Code?

Run this command in your terminal: claude mcp add --transport http api https://mcp.zip-codes.com/mcp

### What are the best alternatives to Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics?

The closest alternatives to Zip-Codes.com Location Intelligence: Spatial Analysis, Districts & 14+ Years of Demographics are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/zip-codes-com-location-intelligence-spatial-analysis-distric
