lookup_postal_codeLABSCO SUMMARY
The metadata call is the one that earns the integration.
Any geocoder maps a postcode to a city. Getting the timezone, the administrative hierarchy and the elevation back in the same response removes a second lookup — and a model inferring a timezone from a city name is a bug waiting for the right city.
What it is
A postal-code service over MCP. It resolves a code to a city and region, checks whether a code exists in a country, finds every code for a city, and returns the full metadata record for one code.
What you get
- lookup_postal_code returns city, state or region and abbreviation for a US ZIP, a UK postcode, a German PLZ and the rest
- validate_postal_code checks whether a code exists in a given country
- search_by_city finds all postal codes for a city
- get_postal_code_metadata returns up to 18 fields per code — latitude and longitude, timezone, administrative hierarchy, elevation, place name and country
- Coverage spans 240+ countries and territories
Requirements
Python 3.10 or newer. pip install postaldatapi-mcp and run the postaldatapi-mcp command over stdio with POSTALDATAPI_KEY in the environment. Registration at postaldatapi.com gives 1,000 free queries with no card.
Setup effort
One command plus a key — pip install postaldatapi-mcp, then supply credentials
USE CASES
01
Answering which city a postal code belongs to
One code in, city and region out, across US, UK, German, Japanese and other formats.
02
Validating an address field before submitting it
Check the code actually exists in that country instead of pattern-matching it.
03
Getting a timezone from a postcode
The timezone comes back with coordinates and the admin hierarchy in the same response.
04
Listing every code in a city
All postal codes for a named city, for coverage checks or address pickers.
4 tools
Listed in project docs. Your client may show a different list.
validate_postal_codesearch_by_cityget_postal_code_metadataBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- postaldatapi-mcp on PATH
- POSTALDATAPI_KEY in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install postaldatapi-mcpMCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport stdio postaldatapi -- \
env POSTALDATAPI_KEY=<YOUR_POSTALDATAPI_KEY> postaldatapi-mcpClaude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"postaldatapi": {
"command": "postaldatapi-mcp",
"env": {
"POSTALDATAPI_KEY": "<YOUR_POSTALDATAPI_KEY>"
}
}
}
}
