# Postal codes and places

> Postal codes and places is a free MCP server for maps and travel. Look up postal codes and the states, counties or districts they belong to, for AI agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://place-lookup.at01.io
- **MCP Registry name:** dev.workers.mnpi.place-lookup/place-lookup
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-19

## About

The MCP server and REST API resolve a town name into its postal code and administrative area, or take a postal code and return the places it covers. The README-style documentation describes coverage of 1.84 million postal codes across 124 countries, including every place with more than 1,000 people.

Lookups accept a town name with an optional country or state filter, such as a town in a named US state, or a postal code with its country prefix. Some countries only publish partial codes, such as UK outward codes or Canadian forward sofa areas, and lookups for those return the wider area rather than a full address. Data comes from GeoNames exports under CC BY 4.0 and is rebuilt monthly, according to the site.

It suits developers and agents that need location fields for forms, shipping, or address normalisation. The site itself warns that accuracy varies by country and that delivery or legal use should be checked against the national postal operator.

## Features

- **Town to postal code:** Finds the postal code for a named town, optionally narrowed by country or state.
- **Postal code to places:** Returns the places a given postal code covers within its country.
- **Administrative area fields:** Reports the state, county, district and municipality where the data provides them.
- **Remote MCP endpoint:** Exposes lookup tools over Streamable HTTP for MCP-compatible AI clients.
- **REST JSON API:** Offers keyless JSON endpoints with an OpenAPI description and a bulk Parquet download.

## Good for

- Filling in a missing postal code for a town name in a form or CRM record
- Normalising state or county fields for addresses collected from users
- Letting an AI assistant answer which postcode or ZIP belongs to a given place
- Checking which places fall under a postal code before a delivery or mailing list run

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http place-lookup https://place-lookup.at01.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://place-lookup.at01.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "place-lookup": {
      "url": "https://place-lookup.at01.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "place-lookup": {
      "type": "http",
      "url": "https://place-lookup.at01.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "place-lookup": {
      "serverUrl": "https://place-lookup.at01.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://place-lookup.at01.io/mcp
```

Enter a Name (for example "Postal codes and places"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "place-lookup": {
      "type": "http",
      "url": "https://place-lookup.at01.io/mcp"
    }
  }
}
```

## Tools

All 2 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `lookup_postal_code` (says read-only): Which places does a postal code / ZIP code / postcode / PIN code / PLZ / CEP cover, and which state, province, county or district are they in? Returns every place name for the code with its first-, second- and third-level administrative units and coordinates. 124 countries (GeoNames). Accepts common input forms (e.g. "SW1A 1AA" maps to the outward code SW1A, "K1A 0B1" to K1A, ZIP+4 to the 5-digit 
- `find_place` (says read-only): What is the postal code / ZIP / postcode / PIN code of a town, and which state, province, region, county, district or local government area is it in? Returns matching places (largest first) with admin1 (state/province/region), admin2 (county/district/LGA), population, coordinates, timezone and postal codes, plus postal codes nearby. Covers every place with 1,000+ people worldwide and every place i

## FAQ

### Does Postal codes and places require an API key?

The site describes the service as free and keyless.

### Which countries are covered?

The site states 124 countries, with coverage and accuracy varying by country.

### Which tools does the MCP server expose?

It lists find_place and lookup_postal_code.

### Is the data reliable for shipping or legal use?

The site advises checking the national postal operator for delivery or legal use.

### Is Postal codes and places free?

Yes. Postal codes and places is free to use.

### How do I add Postal codes and places to Claude Code?

Run this command in your terminal: claude mcp add --transport http place-lookup https://place-lookup.at01.io/mcp

### What are the best alternatives to Postal codes and places?

The closest alternatives to Postal codes and places are Canada Postal Code Lookup MCP, Australia Postcode Lookup MCP, UK Places MCP, Uk Postcodes Mcp and UK Data: UK places.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Canada Postal Code Lookup MCP](https://ai-powered.com/mcp/canada-postal-code-lookup-mcp): Canada Postal Code Lookup MCP is a freemium MCP server for maps and travel.
- [Australia Postcode Lookup MCP](https://ai-powered.com/mcp/australia-postcode-lookup-mcp): Australia Postcode Lookup MCP is a freemium MCP server for maps and travel.
- [UK Places MCP](https://ai-powered.com/mcp/uk-places-mcp): UK Places MCP is a freemium MCP server for maps and travel.
- [Uk Postcodes Mcp](https://ai-powered.com/mcp/uk-postcodes-mcp): Uk Postcodes Mcp is a freemium MCP server for maps and travel.
- [UK Data: UK places](https://ai-powered.com/mcp/uk-data-uk-places): UK Data: UK places is a freemium MCP server for maps and travel.
- [LatLng](https://ai-powered.com/mcp/latlng): LatLng is a freemium MCP server for maps and travel.
- [PlacesDataAPI — Google Maps Places, Reviews & Local B2B Leads MCP Server](https://ai-powered.com/mcp/placesdataapi-google-maps-places-reviews-and-local-b2b-leads): PlacesDataAPI — Google Maps Places, Reviews & Local B2B Leads MCP Server is a freemium MCP server for maps and travel.
- [Airport facts: codes, runways, frequencies](https://ai-powered.com/mcp/airport-facts-codes-runways-frequencies): Airport facts: codes, runways, frequencies is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/postal-codes-and-places
