Skip to main content
Glama
Zip-Codes Location Intelligence

Zip-Codes Location Intelligence

Official

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

Location intelligence for US addresses and ZIP Codes, through the Model Context Protocol. Zip-Codes.com can validate a US street address and return its ZIP+4, census tract demographics, income, housing and school district in one call. It answers from current USPS data, updated monthly, and Census boundaries, so an agent looks addresses and ZIP Codes up instead of guessing them. Request the enrichments you need. The survey estimates describe the census tract and carry margins of error.

ZIP boundaries follow USPS carrier routes and are refreshed quarterly. Coverage includes PO Box and single-organization ZIP Codes that Census ZIP-area files leave out. Boundary enrichments show which counties and districts a ZIP overlaps, with shares measured by area. The USPS county assignment is available alongside the mapped counties.

For history, request Census TIGER/Line boundaries from 2010–2026. American Community Survey profiles use consistent field names across the 2011–2024 releases, for ZIP Code areas and census tracts alike. A ZIP's survey estimates come from the Census ZCTA with the same code.

MPP-capable: an optional buy_credits tool lets an agent with an MPP wallet (such as Stripe Link) buy a prepaid API key or add credits to one; the wallet's owner approves each payment.

Connect

Server URL: https://mcp.zip-codes.com/mcp (Streamable HTTP).

Claude Code

claude mcp add --transport http zip-codes https://mcp.zip-codes.com/mcp
claude mcp add --transport http zip-codes https://mcp.zip-codes.com/mcp --header "X-Api-Key: YOUR_KEY"

Cursor (~/.cursor/mcp.json) and other mcpServers clients

{
  "mcpServers": {
    "zip-codes": {
      "url": "https://mcp.zip-codes.com/mcp",
      "headers": {
        "X-Api-Key": "YOUR_KEY"
      }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "zip-codes": {
      "type": "http",
      "url": "https://mcp.zip-codes.com/mcp",
      "headers": {
        "X-Api-Key": "YOUR_KEY"
      }
    }
  }
}

Clients that only take a bearer token can send Authorization: Bearer YOUR_KEY instead.

Claude / Claude Desktop custom connector

Add https://mcp.zip-codes.com/mcp as a custom connector. It runs in demo mode unless the connector form has a Request headers section (a beta for a limited set of organizations): there, add x-api-key with your key.

Related MCP server: mcp-geocodio

Tools (12)

Tool

Title

What it does

about_data

About this 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.

buy_credits

Buy credits

Buy a credit pack with a wallet that pays MPP (Machine Payments Protocol) challenges, such as Stripe Link.

city_name_rules

City name rules

How USPS names a ZIP Code, and which of those names may be used on mail.

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.

distance

Distance between two places

Distance between two places, in miles and kilometres, plus the compass bearing from the first to the second.

metro_area_reference

Metro area reference

US metropolitan and micropolitan statistical areas (CBSAs) — all 935.

quick_zip

Quick ZIP / ZIP+4 / reverse geocode

The fast, small answer for a postal code.

radius_search

Radius search

Find every US ZIP Code and Canadian postal area within a radius of a centre point, with the distance to each.

suggest_places

Place search (type-ahead)

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.

validate_address

Validate a US address

Validate and standardise a US street address and return its ZIP+4.

zip_facts

ZIP Code 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.

zip_lookup

ZIP Code lookup

The full record for a postal code — the main location-intelligence tool.

Pricing

No key needed to start. A free key gives 2,500 credits a day; plans and credit packs: https://www.zip-codes.com/api/pricing

Support

Email jharris@zip-codes.com. Issues are turned off on this repository; email reaches the people who run the server.

Privacy policy: https://www.zip-codes.com/privacy-policy.asp

License

Proprietary. All rights reserved; see LICENSE. Use of the server, API and data is governed by the Terms of Service: https://www.zip-codes.com/api/tos

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables location intelligence for US ZIP codes, allowing users to search, profile, and compare ZIP codes across various domains like crime, income, schools, and more.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables geocoding and reverse geocoding of addresses, including batch processing up to 10,000 addresses and optional data fields such as congressional district, census/FIPS, timezone, and demographics.
      246 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables US address verification, bulk verification, and autocompletion, returning USPS-standardized components and deliverability codes.
      84 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables US address verification and standardization, validating deliverability and returning USPS-standardized data, plus property enrichment with 350+ tax assessor and deed attributes for a given address.
      282 npm
      MIT