
PostalKit: Mexican postal codes
SEPOMEX postal codes and colonias for Mexico, available to AI assistants
PostalKit: Mexican postal codes is a freemium MCP server for public data. It runs locally on your machine and is started by your AI client.
- Pricing
- Freemium
- Platforms
- API
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add postalkit-mcp --env POSTALKIT_KEY='<POSTALKIT_KEY>' -- npx -y postalkit-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"postalkit-mcp": {
"command": "npx",
"args": [
"-y",
"postalkit-mcp"
],
"env": {
"POSTALKIT_KEY": "<POSTALKIT_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"postalkit-mcp": {
"command": "npx",
"args": [
"-y",
"postalkit-mcp"
],
"env": {
"POSTALKIT_KEY": "<POSTALKIT_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"postalkit-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"postalkit-mcp"
],
"env": {
"POSTALKIT_KEY": "<POSTALKIT_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"postalkit-mcp": {
"command": "npx",
"args": [
"-y",
"postalkit-mcp"
],
"env": {
"POSTALKIT_KEY": "<POSTALKIT_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"postalkit-mcp": {
"command": "npx",
"args": [
"-y",
"postalkit-mcp"
],
"env": {
"POSTALKIT_KEY": "<POSTALKIT_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
POSTALKIT_KEYYour PostalKit API key. Get a free one at https://postalkit.mx/registerRequired
About PostalKit: Mexican postal codes
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.
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- 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
What it does
- 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
Pricing
Freemium
Free plan with 100 requests/month; paid plans from 149 MXN/month
Prices change. Check postalkit.mx before you buy.
PostalKit: Mexican postal codes 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.