English Français العربية

loc8n Geographic Data

Official registry Other

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (sse)
Claude Code 
claude mcp add --transport sse loc8n-geographic-data 'https://mcp.loc8n.com/sse' --header 'Authorization: <Bearer token — your loc8n API key>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "loc8n-geographic-data": {
            "type": "sse",
            "url": "https://mcp.loc8n.com/sse",
            "headers": {
                "Authorization": "<Bearer token — your loc8n API key>"
            }
        }
    }
}
NPM package @gener8v/mcp-geographic-data
Claude Code 
claude mcp add loc8n-geographic-data -e 'LOC8N_API_KEY=<your loc8n_api_key>' -- npx -y @gener8v/mcp-geographic-data@0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "loc8n-geographic-data": {
            "command": "npx",
            "args": [
                "-y",
                "@gener8v/mcp-geographic-data@0.1.3"
            ],
            "env": {
                "LOC8N_API_KEY": "<your loc8n_api_key>"
            }
        }
    }
}

Environment variables

  • LOC8N_API_KEY required secret API key for the loc8n Geographic Data API

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @gener8v/mcp-geographic-data
  2. Quick Start
  3. Usage
  4. Tools (23)
  5. Resources (7)
  6. Environment Variables
  7. CLI Options
  8. License

@gener8v/mcp-geographic-data

MCP server for the loc8n Geographic Data API. 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

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

Set your API key:

export LOC8N_API_KEY="your-api-key"

Get a key at loc8n.com.

Usage

Claude Desktop

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

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

Add to your project's .mcp.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:

{
  "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"
    }
  }
}
Self-Hosted SSE

Run the server locally for development or custom deployments:

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
ToolDescription
lookup_zip_codeGet details for a ZIP code (city, county, state, coordinates)
search_zip_codes_by_cityFind ZIP codes for a city/state
find_zip_codes_in_radiusFind ZIP codes within a radius of a point
calculate_zip_code_distanceCalculate distance between two ZIP codes
search_areasSearch counties, states, or metro areas by name
Demographics
ToolDescription
get_demographicsFull demographic profile (population, income, education, etc.)
get_demographics_categorySingle demographic category in detail
get_demographics_trendYear-over-year demographic trends
compare_demographicsSide-by-side comparison of two areas
Housing & Market Data
ToolDescription
get_fair_market_rentHUD Fair Market Rent by bedroom count
get_fmr_trendFair Market Rent trends over time
Mortgage & Lending
ToolDescription
get_mortgage_summaryHMDA mortgage origination summary
get_mortgage_trendsMortgage lending trends over time
compare_mortgageSide-by-side mortgage comparison of two areas
Migration
ToolDescription
get_migration_summaryIRS SOI migration inflows/outflows
get_migration_flowsTop origin/destination flows for an area
get_migration_trendsMigration trends across year pairs
Employment
ToolDescription
get_employmentLODES employment profile (jobs, sectors, wages)
get_employment_trendEmployment trends over time
compare_employmentSide-by-side employment comparison
get_commute_flowsTop commute origins/destinations
Geocoding
ToolDescription
geocode_addressConvert address to coordinates and FIPS codes
reverse_geocodeConvert coordinates to address and area identifiers

Resources (7)

URIDescription
data://demographics/available-yearsAvailable years for ACS demographics data
data://fmr/available-yearsAvailable years for HUD Fair Market Rent data
data://mortgage/available-yearsAvailable years for HMDA mortgage data
data://migration/available-yearsAvailable year pairs for IRS migration data
data://employment/available-yearsAvailable years for LODES employment data
data://tiersSubscription tier definitions and permissions
data://auth/contextCurrent API key tier, permissions, and rate limits

Environment Variables

VariableRequiredDefaultDescription
LOC8N_API_KEYYes—API key for the loc8n Geographic Data API
LOC8N_API_BASE_URLNohttps://api.loc8n.comAPI 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

Frequently asked questions

What is loc8n Geographic Data?

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

How do I install loc8n Geographic Data?

It runs as a remote server. In Claude Code: claude mcp add --transport sse loc8n-geographic-data 'https://mcp.loc8n.com/sse' --header 'Authorization: <Bearer token — your loc8n API key>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does loc8n Geographic Data need an API key?

Yes. It expects LOC8N_API_KEY, Authorization, which you set in its configuration.

Is loc8n Geographic Data open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains loc8n Geographic Data?

It is published by gener8v. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.