Home › Use with › Ziplore: US ZIP Code API (county, time zone, demographics, radius)

Use Ziplore: US ZIP Code API (county, time zone, demographics, radius) MCP with Gemini 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

Run the command, or add the server to settings.json under "mcpServers".
Start Gemini CLI and run /mcp to list the server and its tools.
Ask a question the tools can answer.

Run:

gemini mcp add --transport http ziplore 'https://ziplore.cybermaxtools.com/mcp?via=use-with-gemini-cli'

Or add it to settings.json yourself::

{
  "mcpServers": {
    "ziplore": {
      "httpUrl": "https://ziplore.cybermaxtools.com/mcp?via=use-with-gemini-cli"
    }
  }
}

With a paid key:

gemini mcp add --transport http --header "x-api-key: YOUR_KEY" ziplore 'https://ziplore.cybermaxtools.com/mcp?via=use-with-gemini-cli'

Use the project file only if it is not committed with the key in it.

Where it goes:

~/.gemini/settings.json (user)
.gemini/settings.json (project, the default for the add command)

Config format checked 2026-10-09 against Gemini CLI's MCP documentation.

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

Use "httpUrl" for Streamable HTTP; "url" is for the older SSE transport.
The docs note that for unpaid-tier and Google One users, Gemini CLI was replaced by Antigravity CLI on 18 June 2026.
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

Cursor VS Code (GitHub Copilot)Claude Code Claude Desktop and claude.ai Windsurf (Devin Desktop)Cline OpenAI Codex CLI

More MCP servers for Gemini CLI

All Ziplore: US ZIP Code API (county, time zone, demographics, radius) setups · All Gemini CLI setups · All