# Zip-Codes.com MCP server

> Validates US addresses and provides geocoding, census demographics, school districts, and spatial analysis for ZIP codes.

- Repository: https://github.com/ZIP-Codes-API/zip-codes-mcp
- Page: https://hostedmcp.org/servers/zip-codes-api/zip-codes-mcp
- Transport: remote
- Stars: 0
- Latest version: 1.1.0

## Install

### Claude Code

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

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "zip-codes-mcp": {
      "type": "http",
      "url": "https://mcp.zip-codes.com/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"zip-codes-mcp","type":"http","url":"https://mcp.zip-codes.com/mcp"}'
```

### Codex

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

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.zip-codes-mcp]
url = "https://mcp.zip-codes.com/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http zip-codes-mcp https://mcp.zip-codes.com/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (12)

- `about_data`
- `buy_credits`
- `city_name_rules`
- `county_reference`
- `distance`
- `metro_area_reference`
- `quick_zip`
- `radius_search`
- `suggest_places`
- `validate_address`
- `zip_facts`
- `zip_lookup`

## FAQ

### What information can I get from a US address validation?

You can validate a US street address and receive its ZIP+4, census tract demographics, income, housing, and school district information in a single call.

### How can an AI agent purchase more credits?

Agents can use the buy_credits tool to purchase credit packs using an MPP wallet, such as Stripe Link, with the owner's approval.

### Is there a free tier available?

Yes, you can start without a key, and a free key provides 2,500 credits per day.
