MCP Server
Connect Claude, Cursor, Windsurf, or any Model Context Protocol compatible client directly to U.S. geographic data. 23 tools covering demographics, housing, mortgage lending, migration, employment, and spatial queries — no code required.
Hosted Endpoint
No installation required. Connect any MCP client directly to the hosted server. Each connection gets an isolated session and usage is tracked against your API key.
https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY
Or pass the key as an Authorization: Bearer header.
Setup
Claude Desktop
Add to claude_desktop_config.json
{
"mcpServers": {
"geographic-data": {
"command": "mcp-geographic-data",
"env": {
"LOC8N_API_KEY": "your-api-key"
}
}
}
}Requires npm install -g @gener8v/mcp-geographic-data
Claude Code
Add to your project's .mcp.json
{
"mcpServers": {
"geographic-data": {
"command": "mcp-geographic-data",
"env": {
"LOC8N_API_KEY": "your-api-key"
}
}
}
}Requires npm install -g @gener8v/mcp-geographic-data
Cursor
Add to your Cursor MCP settings. Uses the hosted endpoint — no install needed.
{
"mcpServers": {
"geographic-data": {
"url": "https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY"
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"geographic-data": {
"serverUrl": "https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY"
}
}
}Tools (23)
Each tool maps to one or more REST API endpoints. Tool access follows your API key's tier permissions.
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 |
| calculate_zip_code_distance | 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 up to 10 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 |
Migration
| Tool | Description |
|---|---|
| get_migration_summary | IRS SOI migration inflows/outflows |
| get_migration_flows | Top origin/destination flows |
| 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 |
| reverse_geocode | Convert coordinates to address |
Resources (7)
MCP resources provide metadata your client can read for context — available data years, tier permissions, and rate limits.
| 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 |
Install via npm
For stdio-based clients or self-hosted deployments:
npm install -g @gener8v/mcp-geographic-data
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
Environment Variables
| Variable | Required | Description |
|---|---|---|
| LOC8N_API_KEY | stdio only | API key for the loc8n Geographic Data API. For SSE transport, clients pass their own key per connection. |
| LOC8N_API_BASE_URL | No | API base URL (default: https://api.loc8n.com) |
23 tools across 7 domains
All tools use your existing API key and tier permissions. Usage from MCP clients counts toward your plan's request quota.