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 Windsurf (Devin Desktop)

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

In the Cascade panel, open the … (Actions) menu and click Open MCP config file in the MCPs section.
Add the server under "mcpServers" with "serverUrl" and save.
Check the MCPs section in Cascade for the server and its tools.
Ask Cascade a question the tools can answer.

Add to ~/.config/devin/mcp_config.json:

{
  "mcpServers": {
    "ziplore": {
      "serverUrl": "https://ziplore.cybermaxtools.com/mcp?via=use-with-windsurf"
    }
  }
}

With a paid key:

{
  "mcpServers": {
    "ziplore": {
      "serverUrl": "https://ziplore.cybermaxtools.com/mcp?via=use-with-windsurf",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

Keep this file out of shared folders and repositories if it holds a key.

Where it goes:

~/.config/devin/mcp_config.json (macOS and Linux)
%APPDATA%\devin\mcp_config.json (Windows)

Config format checked 2026-10-09 against Windsurf (Devin Desktop)'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

Windsurf's documentation (docs.windsurf.com) now redirects to Devin Desktop's at docs.devin.ai; these steps follow that page.
The documented remote field is "serverUrl" (the docs say "url" is also accepted).
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 Cline OpenAI Codex CLI Gemini CLI

More MCP servers for Windsurf (Devin Desktop)

All Ziplore: US ZIP Code API (county, time zone, demographics, radius) setups · All Windsurf (Devin Desktop) setups · All