# ZipExplore MCP Server

Remote MCP server for [ZipExplore](https://www.zipexplore.com) — location intelligence for US ZIP codes.

## Connect to Claude Desktop

```json
{
  "mcpServers": {
    "zipexplore": {
      "url": "https://mcp.zipexplore.com/mcp",
      "headers": { "X-API-Key": "your_api_key_here" }
    }
  }
}
```

Get your API key at [zipexplore.com/account](https://www.zipexplore.com/account).

## Connect to Claude.ai (web)

Visit [mcp.zipexplore.com/oauth/authorize](https://mcp.zipexplore.com/oauth/authorize)
or click "Connect" in Claude.ai's MCP settings.

## Available Tools

**Aggregate (start here)**
- `search_zips` — find ZIPs matching criteria (crime, income, schools, etc.)
- `get_zip_profile` — full profile for one ZIP across all 12 domains
- `compare_zips` — side-by-side profiles for 2–5 ZIPs
- `get_search_fields` — list all searchable fields

**Domain depth** (when you need more detail on one topic)
- `get_census_profile`, `get_weather_profile`, `get_tax_profile`, `get_crime_profile`
- `get_cost_profile`, `get_voting_profile`, `get_education_profile`, `get_healthcare_profile`
- `get_business_profile`, `get_air_quality_profile`, `get_disaster_risk_profile`, `get_transit_profile`

**Geographic utilities**
- `reverse_geocode` — coordinates → ZIP code
- `get_zip_centroids` — ZIP codes → lat/lon centroids