MCP server

CodePostalPro Official

com.codepostalpro/postal-codes

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Postal lookups for 120 countries with cited sources; deep US tier: demographics, climate, area codes

Website

At a glance

Type

MCP server

Publisher

codepostalpro.com (verified by the MCP Registry)

Status

Working at last check

Tools

7

Token cost

About 1,518 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http postal-codes https://api.codepostalpro.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.postal-codes]
url = "https://api.codepostalpro.com/mcp"

Gemini CLI

{"mcpServers":{"postal-codes":{"httpUrl":"https://api.codepostalpro.com/mcp"}}}

Cursor

{"mcpServers":{"postal-codes":{"url":"https://api.codepostalpro.com/mcp"}}}

VS Code

{"servers":{"postal-codes":{"type":"http","url":"https://api.codepostalpro.com/mcp"}}}

Antigravity

agy mcp add postal-codes https://api.codepostalpro.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"postal-codes","server_url":"https://api.codepostalpro.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"postal-codes","server_url":"https://api.codepostalpro.com/mcp"}

Tools

• area_code_lookup ~218 tokens
  Where a US telephone area code is used: the state(s) it serves, the cities with the most ZIPs listing it, total ZIP and city counts, and `overlay_codes` — codes assigned to the same territory (e.g. 310 and 424 in west Los Angeles). Use it for "where is area code 310", "what area code is Denver" (via
• get_group ~160 tokens
  A city (US), département (France), province (Morocco), post office (Algeria) or delegation (Tunisia) with all its localities / ZIP codes. For a US city this is the complete list of its ZIP codes with coordinates, time zone and area codes. Needs the region slug and the group slug (both from get_regio
• get_region ~152 tokens
  A state, région, wilaya or governorate with the list of its cities / départements / delegations (names, slugs and their postal codes), plus for US states every telephone area code in use. Use the slugs it returns to call get_group or get_place. Region slugs are lower-case hyphenated names: "texas",
• list_countries ~128 tokens
  Coverage overview: the eight curated countries with postal-code format, hierarchy labels (e.g. state › city › ZIP), key facts (capital, population, area, currency, calling code) and time zones — plus `bulk_tier` with per-country postal-code counts for the ~115 additional countries served from GeoNam
• lookup_postal_code ~412 tokens
  Look up a postal code or US ZIP code. Returns every locality that carries the code with its city, county/administrative division, region (state, département, wilaya…), coordinates, IANA time zone, US telephone area codes, USDA 2023 plant hardiness / planting zone (e.g. 7b with its temperature band),
• nearby_places ~192 tokens
  List localities around a latitude/longitude, nearest first, each with `distance_km`. Use it for "what ZIP codes are near…", "postal codes within 10 km of…", or to resolve coordinates to the closest postal code (the first result). Distances are to the locality centroid from the source data, not to a
• search_places ~256 tokens
  Find localities by name, city name, or the beginning of a postal code. Use this when the user gives a place name and wants its postal code(s), or has a partial code. Results are ranked exact-name-first, then by population. Returns the same full records as lookup_postal_code. Restrict with `country`

Browse

• Legal research
• Government and public data
• Property

Related MCP servers

• Postal Codes
  Postal code lookup with place names and coordinates for 60+ countries. Via Zippopotam.us.
• Ipinfo
  IPInfo MCP — wraps ipinfo.io (free tier, no auth required for basic usage)
• TidyData Tools
  Holidays, business days, currency, time zones, DNS/WHOIS, web page checks, geodata and text tools.
• Tollbooth
  37 paid x402 MCP tools for OSINT, prediction markets, web intel, and agent security on Base USDC.
• geonames-mcp-server
  Search GeoNames places, walk admin hierarchies, reverse geocode, get postal codes and country info.
• Zippopotam
  Zippopotam MCP — wraps Zippopotam.us ZIP/postal code API (free, no auth)
• BizVerify
  KYB for AI agents: verify business registrations from MCP clients.
• MCPFax Public-Data Utility API
  One public fact when you have no API key: where, what time, what rate. 31 lookups.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.codepostalpro/postal-codes.svg)](https://aptlynx.net/servers/com.codepostalpro/postal-codes)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents