English Français العربية

Postaldatapi MCP

Community Developer tools

Global postal code lookup, validation and city search, with timezone, administrative region and elevation metadata.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PostalDataPI MCP Server
  2. Tools
  3. Setup
  4. Usage
  5. Supported Countries
  6. Rich Metadata
  7. Links

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

ToolDescription
lookup_postal_codeGet city, state/region, and abbreviation for a postal code (US ZIP, UK postcode, German PLZ, etc.)
validate_postal_codeCheck if a postal code exists in a country
search_by_cityFind all postal codes for a city
get_postal_code_metadataFull 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
pip install postaldatapi-mcp
3. Configure with Claude Code
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):

{
  "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:

{
  "postalCode": "06000",
  "country": "MX",
  "placeName": "Centro",
  "latitude": 19.4364,
  "longitude": -99.1553,
  "timezone": "America/Mexico_City",
  "adminLevel1": "Ciudad de México",
  "adminLevel2": "Cuauhtémoc",
  "elevation": 2239
}

Frequently asked questions

What is Postaldatapi MCP?

Global postal code lookup, validation and city search, with timezone, administrative region and elevation metadata.

How do I install Postaldatapi MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Postaldatapi MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Postaldatapi MCP?

It is published by PostalDataPI. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.