# PostalKit: Mexican postal codes

> PostalKit: Mexican postal codes is a freemium MCP server for public data. SEPOMEX postal codes and colonias for Mexico, available to AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://postalkit.mx
- **Repository:** https://github.com/postalkit/postalkit-mcp
- **MCP Registry name:** io.github.postalkit/postalkit-mcp
- **Categories:** [public data](https://ai-powered.com/categories/public-data), [mcp data access](https://ai-powered.com/categories/mcp-data-access)
- **Listing updated:** 2026-11-20

## About

Developers and assistants can look up Mexican postal codes and their colonias, municipalities and states from the official SEPOMEX catalog. A single request returns the full address hierarchy for a five-digit code, so a tool can fill in state, municipality and neighborhood without manual lookup tables.

The server runs locally through npx and connects to the PostalKit REST API using an API key. Tools cover code lookup, prefix autocomplete, search by state, municipality or colonia name, and listing states and municipalities. Usage and remaining quota can be checked through a dedicated tool.

It suits teams validating shipping or customer addresses, e-commerce checkouts, and anyone building Mexico-focused logistics or form-filling workflows who wants an AI assistant to query postal data directly.

## Features

- **Full address hierarchy:** A postal code lookup returns its state, municipality, city and every associated colonia.
- **Prefix autocomplete:** Finds postal codes that start with a given numeric prefix for form completion.
- **Search by place name:** Finds postal codes from a combination of state, municipality and colonia name.
- **Nationwide colonia search:** Looks up colonias by name across all 32 states.
- **Read-only access:** All tools only read data and do not change anything on the PostalKit side.
- **Usage tracking:** A tool reports the current plan, monthly limit and requests used.

## Good for

- Validate shipping addresses and flag postal codes that do not match their colonia
- Autocomplete Mexican addresses in checkout or signup forms
- Find every colonia in a municipality for delivery zone planning
- Ask an AI assistant which postal code belongs to a given neighborhood

## Install

### Claude Code (Terminal)

```sh
claude mcp add postalkit-mcp --env POSTALKIT_KEY='<POSTALKIT_KEY>' -- npx -y postalkit-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "postalkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "postalkit-mcp"
      ],
      "env": {
        "POSTALKIT_KEY": "<POSTALKIT_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "postalkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "postalkit-mcp"
      ],
      "env": {
        "POSTALKIT_KEY": "<POSTALKIT_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "postalkit-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "postalkit-mcp"
      ],
      "env": {
        "POSTALKIT_KEY": "<POSTALKIT_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "postalkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "postalkit-mcp"
      ],
      "env": {
        "POSTALKIT_KEY": "<POSTALKIT_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "postalkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "postalkit-mcp"
      ],
      "env": {
        "POSTALKIT_KEY": "<POSTALKIT_KEY>"
      }
    }
  }
}
```

## Tools

- `lookup_postal_code`: State, municipality, city and every colonia for a 5-digit postal code
- `search_postal_codes`: Postal codes that start with a prefix
- `find_postal_codes_by_place`: Postal codes for a state, municipality and/or colonia name
- `search_colonias`: Colonias by name, nationwide
- `list_states`: The 32 states with INEGI codes
- `list_municipalities`: Municipalities of a state
- `list_municipality_colonias`: Every colonia in a municipality
- `search_streets`: Streets of a municipality, by name
- `geocode_postal_code`: Latitude and longitude for a postal code
- `reverse_geocode`: Nearest postal code to a coordinate
- `get_usage`: Plan, monthly limit and requests used

## FAQ

### Where does the postal data come from?

It comes from the official SEPOMEX catalog, normalized into a relational schema with stable IDs and re-verified monthly.

### Do I need a credit card to start?

No. The free plan includes 100 requests per month and only requires email verification.

### What rate limits apply?

A burst limit of 60 requests per minute applies along with the monthly quota of your plan. Responses include rate limit headers.

### Can I cancel a paid plan at any time?

Yes. Paid plans are billed monthly in Mexican pesos through Stripe and can be cancelled from the customer portal without a contract or penalty.

### How do I add PostalKit: Mexican postal codes to Claude Code?

Run this command in your terminal: claude mcp add postalkit-mcp --env POSTALKIT_KEY='<POSTALKIT_KEY>' -- npx -y postalkit-mcp

### What are the best alternatives to PostalKit: Mexican postal codes?

The closest alternatives to PostalKit: Mexican postal codes are Tlaloc MCP, PostFinder post offices and parcel points, Agentic House Search, Italy OpenData and UK Data: UK places.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Tlaloc MCP](https://ai-powered.com/mcp/tlaloc-mcp): Tlaloc MCP is a paid MCP server for public data.
- [PostFinder post offices and parcel points](https://ai-powered.com/mcp/postfinder-post-offices-and-parcel-points): PostFinder post offices and parcel points is a free MCP server for maps and travel.
- [Agentic House Search](https://ai-powered.com/mcp/agentic-house-search): Agentic House Search is an open-source MCP server for public data.
- [Italy OpenData](https://ai-powered.com/mcp/italy-opendata): Italy OpenData is an open-source MCP server for public data.
- [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.
- [Zipexplore MCP](https://ai-powered.com/mcp/zipexplore-mcp): Zipexplore MCP is an MCP server for public data.

---
Source: https://ai-powered.com/mcp/postalkit-mexican-postal-codes
