Meta Agent Tools
PT

Back to the catalog

loc8n Geographic Data

U.S. demographics, housing, mortgage, migration, and employment data via loc8n API

Open source Repository Open in the app JSON README (API)

About

U.S. demographics, housing, mortgage, migration, and employment data via loc8n API

Details

Kind
MCP servers
Topic
No topic detected
Publisher
gener8v-thomas
Origin
official
Category
ferramentas
Transport
sse
Version
0.1.3
Last push
2026-04-16T19:19:47Z
Repository state
ativo
Language
TypeScript
Added
2026-08-29 03:02:50
Updated
2026-08-29 03:02:50
Origin id
io.github.gener8v-thomas/mcp-geographic-data

README

# @gener8v/mcp-geographic-data

MCP server for the [loc8n Geographic Data API](https://loc8n.com). Exposes U.S. demographics, housing, mortgage, migration, employment, and geographic data as tools for any MCP-compatible client (Claude Desktop, Claude Code, Cursor, etc.).

## Quick Start

```bash
npm install -g @gener8v/mcp-geographic-data
```

Set your API key:

```bash
export LOC8N_API_KEY="your-api-key"
```

Get a key at [loc8n.com](https://loc8n.com).

## Usage

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "geographic-data": {
      "command": "mcp-geographic-data",
      "env": {
        "LOC8N_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Claude Code

Add to your project's `.mcp.json`:

```json
{
  "mcpServers": {
    "geographic-data": {
      "command": "mcp-geographic-data",
      "env": {
        "LOC8N_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Hosted SSE (no install required)

Connect any MCP-compatible client directly to the hosted server at `mcp.loc8n.com`. Pass your API key as a query parameter or `Authorization` header:

```
SSE endpoint: https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY
```

Or with a Bearer token:

```
GET https://mcp.loc8n.com/sse
Authorization: Bearer YOUR_API_KEY
```

Each connection gets an isolated session — your API key is used for all requests and usage is tracked against your account.

### Cursor

Add to your Cursor MCP settings:

```json
{
  "mcpServers": {
    "geographic-data": {
      "url": "https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY"
    }
  }
}
```

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "geographic-data": {
      "serverUrl": "https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY"
    }
  }
}
```

### Self-Hosted SSE

Run the server locally for development or custom deployments:

```bash
mcp-geographic-data --transport sse --port 3100
```

Endpoints:
- SSE: `http://localhost:3100/sse`
- Messages: `http://localhost:3100/messages`
- Health: `http://localhost:3100/health`

## Tools (23)

### Geographic Lookup

| Tool | Description |
|------|-------------|
| `lookup_zip_code` | Get details for a ZIP code (city, county, state, coordinates) |
| `search_zip_codes_by_city` | Find ZIP codes for a city/state |
| `find_zip_codes_in_radius` | Find ZIP codes within a radius of a point |
| `calculate_zip_code_distance` | Calculate distance between two ZIP codes |
| `search_areas` | Search counties, states, or metro areas by name |

### Demographics

| Tool | Description |
|------|-------------|
| `get_demographics` | Full demographic profile (population, income, education, etc.) |
| `get_demographics_category` | Single demographic category in detail |
| `get_demographics_trend` | Year-over-year demographic trends |
| `compare_demographics` | Side-by-side comparison of two areas |

### Housing & Market Data

| Tool | Description |
|------|-------------|
| `get_fair_market_rent` | HUD Fair Market Rent by bedroom count |
| `get_fmr_trend` | Fair Market Rent trends over time |

### Mortgage & Lending

| Tool | Description |
|------|-------------|
| `get_mortgage_summary` | HMDA mortgage origination summary |
| `get_mortgage_trends` | Mortgage lending trends over time |
| `compare_mortgage` | Side-by-side mortgage comparison of two areas |

### Migration

| Tool | Description |
|------|-------------|
| `get_migration_summary` | IRS SOI migration inflows/outflows |
| `get_migration_flows` | Top origin/destination flows for an area |
| `get_migration_trends` | Migration trends across year pairs |

### Employment

| Tool | Description |
|------|-------------|
| `get_employment` | LODES employment profile (jobs, sectors, wages) |
| `get_employment_trend` | Employment trends over time |
| `compare_employment` | Side-by-side employment comparison |
| `get_commute_flows` | Top commute origins/destinations |

### Geocoding

| Tool | Description |
|------|-------------|
| `geocode_address` | Convert address to coordinates and FIPS codes |
| `reverse_geocode` | Convert coordinates to address and area identifiers |

## Resources (7)

| URI | Description |
|-----|-------------|
| `data://demographics/available-years` | Available years for ACS demographics data |
| `data://fmr/available-years` | Available years for HUD Fair Market Rent data |
| `data://mortgage/available-years` | Available years for HMDA mortgage data |
| `data://migration/available-years` | Available year pairs for IRS migration data |
| `data://employment/available-years` | Available years for LODES employment data |
| `data://tiers` | Subscription tier definitions and permissions |
| `data://auth/context` | Current API key tier, permissions, and rate limits |

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `LOC8N_API_KEY` | Yes | — | API key for the loc8n Geographic Data API |
| `LOC8N_API_BASE_URL` | No | `https://api.loc8n.com` | API base URL |

## CLI Options

```
mcp-geographic-data [options]

  --transport <stdio|sse>  Transport protocol (default: stdio)
  --port <number>          Port for SSE transport (default: 3100)
  --help, -h               Show help
```

## License

MIT

More