Postal codes and the places they belong to
Find a town's postal code (ZIP, postcode, PIN code, PLZ, CEP) and the state, province, county, district or local government area it is in, or the places a postal code covers. 1.84 million postal codes in 124 countries, and every place with 1,000+ people worldwide. Free, no key.
Examples: Geelong, AU · Springfield, Illinois · Kolar, IN · DE 10115 · GB SW1A 1AA · JP 100-0001
Use it from your AI agent (MCP)
Remote MCP server, Streamable HTTP: https://place-lookup.mnpi.workers.dev/mcp. Tools: find_place(name, country?, admin?) and lookup_postal_code(country, postal_code).
claude mcp add --transport http place-lookup https://place-lookup.mnpi.workers.dev/mcp
Cursor, VS Code, Windsurf and other clients:
{ "mcpServers": { "place-lookup": { "url": "https://place-lookup.mnpi.workers.dev/mcp" } } }
REST API
curl "https://place-lookup.mnpi.workers.dev/v1/place?name=Geelong&country=AU" curl "https://place-lookup.mnpi.workers.dev/v1/place?name=Springfield&admin=Illinois" curl https://place-lookup.mnpi.workers.dev/v1/postcode/IN/560001
OpenAPI: /openapi.json · llms.txt · Bulk Parquet: Hugging Face dataset
Data
From GeoNames postal code and gazetteer exports (CC BY 4.0), rebuilt monthly. admin1 is the state, province or region; admin2 the county, district or local government area; admin3 the municipality where the postal file has one. Some countries publish only part of the code (UK outward codes such as SW1A, Canadian FSAs such as K1A); those lookups return the area. Coverage and accuracy vary by country: for delivery or legal use, check the national postal operator.