PostalDataPI/postaldatapi-mcp

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
Sign up at postaldatapi.com/register — 1,000 free queries, no credit card required.
2. Install
3. Configure with Claude Code
4. Configure with Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
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: