About PostalDataPI/postaldatapi-mcp
PostalDataPI/postaldatapi-mcp is an MCP server in the Maps category: 10ms responses at $0.000028/query with 1,000 free queries on signup.
Install
git clone https://github.com/PostalDataPI/postaldatapi-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
get_postal_code_metadataFull metadata: coordinates, admin hierarchy, timezone, elevation, and more
Parameters not published.
lookup_postal_codeGet city, state/region, and abbreviation for a postal code (US ZIP, UK postcode, German PLZ, etc.)
Parameters not published.
search_by_cityFind all postal codes for a city
Parameters not published.
validate_postal_codeCheck if a postal code exists in a country
Parameters not published.
Ask AI
Ask AI about PostalDataPI/postaldatapi-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
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
}
Links
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.