Skip to content
BEAD

US ZIP Code Lookup

Look up US ZIP codes by code or by city/state. Starter dataset — covers state capitals and major metros.

Reference & LookupGeo & Location
Loading dataset…
ZIPCityStateCountyLat, Lon
</>Use this tool programmaticallycurl · JavaScript · MCP

Same tool, callable from any HTTP client or from Claude (via MCP). Anonymous: 100 req/day per IP. Sign up for 1,000 req/day.

curl
curl https://api.b-e-a-d.com/tools/zip-code-lookup/run \
  -H "Content-Type: application/json" \
  -d '{
  "action": "lookup",
  "zip": "10001"
}'
JavaScript (fetch)
const res = await fetch("https://api.b-e-a-d.com/tools/zip-code-lookup/run", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "action": "lookup",
  "zip": "10001"
}),
});
const data = await res.json();
console.log(data.result);
MCP (Claude Desktop / Claude Code)
# In Claude Desktop / Claude Code, add to your MCP config:
{
  "mcpServers": {
    "bead": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.b-e-a-d.com"]
    }
  }
}

# Then ask Claude to call:
mcp__bead__bead_zip_code_lookup

Full reference: developer docs · OpenAPI spec

About this dataset

Covers all ~42,000 US ZIP codes — city, state, county, and latitude/longitude. Backed by the GeoNames postal-code release, the canonical free open-data source. Updated periodically. The full dataset loads only when you visit this page, so other pages on BEAD stay light.

A single ZIP can serve multiple cities; the lookup action returns the first hit, while search returns all matches. For authoritative mail routing, the official USPS lookup is the source of truth.

Geographical data provided by GeoNames under the Creative Commons Attribution 4.0 International License.

You might also like