# Zip-Codes.com MCP

> Lets your agent validate US addresses and look up ZIP Codes, with the census tract, districts, schools and demographics behind them.

Zip-Codes.com's own hosted MCP server for US address and ZIP Code data. Your agent looks answers up from current USPS data and Census boundaries instead of guessing them: it validates a street address and returns its ZIP+4, then adds what you ask for about the area around it.

What you can do with it
- Validate and standardise a US street address, even a messy one-line one, and get its ZIP+4
- Look up a US ZIP Code, ZIP+4, Canadian postal code or latitude and longitude: city, county, area codes, metro area and more
- Add Census geographies, congressional and state legislative districts, school district, time zone and American Community Survey estimates for the census tract or ZIP Code
- Compare then and now, with Census boundaries back to 2010 and survey data back to 2011
- Find every ZIP Code or Canadian postal area within a radius, and measure the distance between two places
- Turn partial or misspelled place names into places it can look up
- Look up counties, metro areas, USPS city naming rules and ZIP Code statistics, and cite where the data comes from

How it connects
Zip-Codes.com hosts it at https://mcp.zip-codes.com/mcp. It's read-only and works without a key in demo mode: the values it shows are real and current, but some deeper fields are withheld. For complete answers, send your Zip-Codes.com API key in the X-Api-Key header, or as a Bearer token. ChatGPT, and Claude connectors without request headers, run in demo mode.

Good to know
- A free key comes with a daily allowance of credits; paid plans and credit packs add more.
- Extra data is opt-in and each addition uses credits, so ask only for what you need.
- Survey estimates describe the census tract or ZIP Code area, never the person at an address, and carry margins of error.
- In demo mode, radius search lists only the nearest matches and place search the first few.

- Type: Plugin
- Made by: Zip Codes
- Category: Travel & maps
- Formats: Remote MCP
- Version: 1.0.0
- Website: https://www.zip-codes.com/api/mcp
- Source: https://github.com/zip-codes-api/zip-codes-mcp
- Page: https://pluginboard.ai/plugins/zip-codes-com-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `X-Api-Key` (optional): Optional API key; without it the server runs in demo mode

Replace each `<NAME>` placeholder with your own value.

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.zip-codes.com/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.zip-codes.com/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.zip-codes.com/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.zip-codes.com/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.zip-codes.com/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.zip-codes.com/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22zip-codes-com-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.zip-codes.com%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http zip-codes-com-mcp https://mcp.zip-codes.com/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=zip-codes-com-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC56aXAtY29kZXMuY29tL21jcCJ9

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "zip-codes-com-mcp": {
      "url": "https://mcp.zip-codes.com/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http zip-codes-com-mcp https://mcp.zip-codes.com/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add zip-codes-com-mcp --url https://mcp.zip-codes.com/mcp
```

### Antigravity

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

```json
{
  "mcpServers": {
    "zip-codes-com-mcp": {
      "url": "https://mcp.zip-codes.com/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http zip-codes-com-mcp https://mcp.zip-codes.com/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.zip-codes.com/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add zip-codes-com-mcp --url https://mcp.zip-codes.com/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.zip-codes.com/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login zip-codes-com-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add zip-codes-com-mcp --url https://mcp.zip-codes.com/mcp
```

If it needs a key: For https://mcp.zip-codes.com/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add zip-codes-com-mcp --url https://mcp.zip-codes.com/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "zip-codes-com-mcp": {
      "url": "https://mcp.zip-codes.com/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://mcp.zip-codes.com/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).