# TIGERweb MCP Server

MCP server for accessing US Census Bureau TIGERweb geographic boundary data. Returns GeoJSON for states, counties, census tracts, places, ZCTAs, and congressional districts.

## Installation

```bash
npm install
npm run build
```

## Configuration

Add to your Claude settings (`.claude/settings.local.json` or project settings):

```json
{
  "mcpServers": {
    "tigerweb": {
      "command": "node",
      "args": ["/Users/shawndrake/.claude/mcp-servers/tigerweb/dist/index.js"]
    }
  }
}
```

## Available Tools

### get_states
Get GeoJSON boundaries for US states.
- `stateFips` (optional): Comma-separated state FIPS codes (e.g., '12' for Florida)
- `includeGeometry` (optional): Whether to include coordinates (default: true)

### get_counties
Get GeoJSON boundaries for US counties.
- `stateFips`: State FIPS code to get all counties in that state
- `countyGeoid`: Specific 5-digit county GEOID (e.g., '12083' for Marion County, FL)
- `includeGeometry` (optional): Whether to include coordinates

### get_tracts
Get census tract boundaries within a county.
- `countyGeoid` (required): 5-digit county GEOID
- `includeGeometry` (optional): Whether to include coordinates

### get_places
Get city/town boundaries within a state.
- `stateFips` (required): State FIPS code
- `placeName` (optional): Filter by name (partial match)
- `includeGeometry` (optional): Whether to include coordinates

### get_zcta
Get ZIP Code Tabulation Area boundaries.
- `zcta` (required): Comma-separated ZCTA codes (e.g., '32601,32606')
- `includeGeometry` (optional): Whether to include coordinates

### get_congressional_districts
Get congressional district boundaries.
- `stateFips` (required): State FIPS code
- `district` (optional): Specific district number
- `includeGeometry` (optional): Whether to include coordinates

### list_layers
List all available geographic layer types with descriptions and examples.

## FIPS Code Reference

| State | FIPS |
|-------|------|
| Alabama | 01 |
| California | 06 |
| Florida | 12 |
| New York | 36 |
| Texas | 48 |

County GEOIDs are 5 digits: state FIPS (2) + county FIPS (3). Example: 12083 = Florida (12) + Marion (083).

## Data Source

All data comes from the US Census Bureau's TIGERweb REST Services:
https://tigerweb.geo.census.gov/arcgis/rest/services/