loc8n Geographic Data

io.github.gener8v-thomasPublished by GitHub account gener8v-thomasv0.1.3Updated Oct 24, 2026

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

VerifiedSSEWeb executableLocation & Lifestyle Data & Analytics

Server details

Identifier: io.github.gener8v-thomas/mcp-geographic-data
Transport: SSE
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account gener8v-thomas for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.gener8v-thomas%2Fmcp-geographic-data.svg)](https://sourceweft.com/mcp/io.github.gener8v-thomas%2Fmcp-geographic-data?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

MCP server exposing U.S. geographic, demographic, housing, mortgage, migration and employment data from the loc8n API to an assistant.

What you can do: Look up ZIP codes, search ZIPs by city or radius, measure distances and search counties, states and metro areas by name, plus geocode and reverse geocode addresses to coordinates and FIPS codes. Retrieve demographic profiles, single categories, year-over-year trends and side-by-side area comparisons. Read HUD Fair Market Rent figures and trends by bedroom count. Summarize and compare HMDA mortgage lending and its trends. Review IRS migration inflows, outflows and trends, and LODES employment, wages, commute flows and comparisons. Read resources listing available years per dataset and the current API key tier, permissions and rate limits.
When to use it: Useful when an assistant needs U.S. location and community data: profiling an area's population and income, comparing regions, checking rents or mortgage activity, or tracing migration and commuting patterns.
Requirements: Either the hosted SSE endpoint or the npm package @gener8v/mcp-geographic-data run locally with Node.js. A loc8n API key is required, supplied as the LOC8N_API_KEY environment variable or as an Authorization bearer token (or query parameter) for the hosted server. Network access to the loc8n API.

Before you install

The API key is a secret; the hosted option accepts it as a URL query parameter, which can leak into logs or shared configs, so prefer the Authorization header. Usage is tracked against your account and subject to subscription tiers and rate limits. Data comes from third-party sources through the loc8n API.

Installation

In SourceWeft

Open loc8n Geographic Data in the dashboard and add it to a workspace.
Connect Authorization token credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.gener8v-thomas%2Fmcp-geographic-data/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "loc8n-geographic-data": {
      "type": "sse",
      "url": "https://mcp.loc8n.com/sse",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

@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

Set your API key:

Get a key at 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"      }    }  }}

{  "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"      }    }  }}

{  "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:

Or with a Bearer token:

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"    }  }}

{  "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"    }  }}

{  "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:

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

Mortgage & Lending

Migration

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

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

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

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

Source: README.md at commit 80f2687

Tools

This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

v0.1.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declaredRequired10 pts
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

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

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

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

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

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