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-mcp3. Configure with Claude Code
claude mcp add --transport stdio postaldatapi -- \
env POSTALDATAPI_KEY=your_api_key_here postaldatapi-mcp4. Configure with Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
