Skip to content
MCP server

PostalKit: Mexican postal codes

SEPOMEX postal codes and colonias for Mexico, available to AI assistants

Runs locally
Install

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-mcp

Add 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.

How AIPoweredBot checks servers