PostalDataPI MCP Server

MCP (Model Context Protocol) server for PostalDataPI — lets AI agents look up, validate, and search postal codes across 240+ countries and territories with rich metadata: timezone, administrative regions, elevation, and coordinates.

Tools

Tool	Description
`lookup_postal_code`	Get city, state/region, and abbreviation for a postal code (US ZIP, UK postcode, German PLZ, etc.)
`validate_postal_code`	Check if a postal code exists in a country
`search_by_city`	Find all postal codes for a city
`get_postal_code_metadata`	Full metadata: coordinates, admin hierarchy, timezone, elevation, and more

Setup

1. Get an API Key

2. Install

Terminal

pip install postaldatapi-mcp

3. Configure with Claude Code

Terminal

claude mcp add --transport stdio postaldatapi -- \

  env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp

4. Configure with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

config.json

{

  "mcpServers": {

    "postaldatapi": {

      "command": "postaldatapi-mcp",

      "env": {

        "POSTALDATAPI_KEY": "your_api_key_here"

      }

    }

  }

}

Usage

Once configured, ask Claude naturally:

"What city is ZIP code 90210?"
"Look up UK postcode SW1A"
"Is 10115 a valid German postal code?"
"What are the postal codes for Beverly Hills, CA?"
"Get the coordinates for postal code 100-0001 in Japan"

Claude will automatically use the PostalDataPI tools to answer.

Supported Countries

240+ countries and territories including US, UK, Canada, Germany, France, Japan, Australia, Brazil, India, and many more. See the full list at postaldatapi.com/countries.

Rich Metadata

Beyond basic lookups, the get_postal_code_metadata tool returns up to 18 fields per postal code including:

Coordinates (latitude, longitude)
Timezone (e.g., America/Mexico_City, Europe/Berlin)
Administrative hierarchy (state/province, county, municipality)
Elevation (meters above sea level)
Place name and country information

Example response for Mexico City 06000: