Use Ziplore: US ZIP Code API (county, time zone, demographics, radius) MCP with OpenAI Codex CLI
Ziplore: US ZIP to county, FIPS, time zone, Census demographics; radius and city ZIPs. Free, no key.
Remote MCP server (Streamable HTTP), nothing to install. Free: 200 free calls/day, no key · Paid: Starter $19/month; Pro $39/month; Starter yearly $190/year; Pro yearly $390/year
Set it up
- Open ~/.codex/config.toml (create it if needed).
- Add the [mcp_servers] table shown and save.
- Start Codex; the server's tools are available to the agent.
- Ask a question the tools can answer.
Add to ~/.codex/config.toml:
[mcp_servers.ziplore]
url = "https://ziplore.cybermaxtools.com/mcp?via=use-with-codex"With a paid key:
[mcp_servers.ziplore]
url = "https://ziplore.cybermaxtools.com/mcp?via=use-with-codex"
env_http_headers = { "x-api-key" = "CYBERMAX_API_KEY" }env_http_headers maps the header to an environment variable name, so the key stays in your environment.
- ~/.codex/config.toml (or .codex/config.toml in a trusted project)
Tools you get
Endpoint checked 2026-10-09: https://ziplore.cybermaxtools.com/mcp answered an MCP initialize (protocol 2025-06-18) and tools/list with 5 tools, all marked read-only. No key was used and no tool was called.
| Tool | What it does | Required inputs |
|---|---|---|
zip_lookup | City, state, county and FIPS, coordinates, time zone with UTC offset, and Census demographics (population, income, home value, rent) for up to 10 US ZIP codes. Accepts ZIP+4, addresses and ZIPs missing a leading zero. | zips |
zips_in_radius | Every US ZIP within N miles (max 25) of a ZIP or a lat/lon point, closest first, with distance in miles. | miles |
city_zips | All ZIP codes of a US city, largest population first. | city |
nearest_zip | Reverse geocode a latitude/longitude to the nearest US ZIP code(s), with distance. | lat, lon |
zip_distance | Great-circle distance in miles and km between two US ZIP codes. | from, to |
Test the endpoint from a terminal
This lists the tools without a key and without calling any of them:
curl -s https://ziplore.cybermaxtools.com/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'If it does not work
- Each server is its own [mcp_servers.<name>] table; keep the name to letters, digits, dashes and underscores.
- For a fixed header value instead of an environment variable, Codex also documents http_headers.
- The free tier has a daily limit (see the pricing line above); a paid key raises it.
Ziplore: US ZIP Code API (county, time zone, demographics, radius) in other clients
More MCP servers for OpenAI Codex CLI
All Ziplore: US ZIP Code API (county, time zone, demographics, radius) setups · All OpenAI Codex CLI setups · All