Summary
Connects Claude to the loc8n Geographic Data API for U.S. census, housing, and employment queries. You get 23 tools covering ACS demographics, HUD Fair Market Rent, HMDA mortgage originations, IRS migration flows, and LODES employment data. Works across ZIP codes, counties, metro areas, and states with trend analysis, side-by-side comparisons, and geocoding. Runs via stdio or SSE, with a hosted option at mcp.loc8n.com if you don't want to install anything. Useful when you're building location intelligence features, analyzing real estate markets, or need population and economic data without writing API clients. Requires a loc8n API key.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
23 tools
lookup_zip_codeLook up full details for a single 5-digit US ZIP code, including city, state, county, timezone, coordinates, area codes, land/water area, and elevation.1 params
Look up full details for a single 5-digit US ZIP code, including city, state, county, timezone, coordinates, area codes, land/water area, and elevation.
Parameters* required
zipCodestringThe 5-digit ZIP code to look up (e.g., "30301")
search_zip_codes_by_citySearch for all ZIP codes in a given city and state. Returns the full list of matching ZIP codes with details.2 params
Search for all ZIP codes in a given city and state. Returns the full list of matching ZIP codes with details.
Parameters* required
citystringCity name (e.g., "Atlanta")
statestring2-letter state abbreviation (e.g., "GA")
find_zip_codes_in_radiusFind all ZIP codes within a given radius of a center ZIP code. Returns each nearby ZIP with its distance from the center.5 params
Find all ZIP codes within a given radius of a center ZIP code. Returns each nearby ZIP with its distance from the center.
Parameters* required
sortstringSort order for resultsone of
distance · zipdefault: distanceunitstringDistance unitone of
miles · kilometersdefault: mileslimitintegerMaximum number of results (1 to 500, default 100)default: 100
radiusnumberSearch radius (0.1 to 500)
zipCodestringCenter ZIP code (5 digits)
calculate_zip_code_distanceCalculate the distance between two ZIP codes using either the Haversine or Vincenty formula. Returns origin/destination details and the computed distance.4 params
Calculate the distance between two ZIP codes using either the Haversine or Vincenty formula. Returns origin/destination details and the computed distance.
Parameters* required
tostringDestination ZIP code (5 digits)
fromstringOrigin ZIP code (5 digits)
unitstringDistance unitone of
miles · kilometers · meters · feet · nautical_milesdefault: milesmethodstringCalculation methodone of
haversine · vincentydefault: haversinesearch_areasSearch for geographic areas by name across all boundary types (county, state, CBSA, census tract, ZIP). Uses trigram matching for fuzzy name search.3 params
Search for geographic areas by name across all boundary types (county, state, CBSA, census tract, ZIP). Uses trigram matching for fuzzy name search.
Parameters* required
limitintegerMaximum number of results (1 to 50, default 20)default: 20
querystringSearch term -- name or partial ZIP code (minimum 2 characters)
typesarrayRestrict to specific boundary types
get_demographicsRetrieve a full demographic profile (population, income, housing, education, employment, households) for a single geographic area such as a ZIP code, county, state, place, CBSA, census tract, or block group.3 params
Retrieve a full demographic profile (population, income, housing, education, employment, households) for a single geographic area such as a ZIP code, county, state, place, CBSA, census tract, or block group.
Parameters* required
area_codestringArea identifier: 5-digit ZIP, 2-digit state FIPS, 5-digit county FIPS, 11-digit tract GEOID, 12-digit block group GEOID, place FIPS, or CBSA code.
area_typestringGeographic area type. Use 'zip' for ZIP codes, or a Census boundary type.one of
zip · county · state · place · cbsa · tractdata_yearintegerSpecific ACS data year (e.g. 2023). Omit for the most recent available year.
get_demographics_categoryRetrieve specific demographic categories (e.g. population, income, housing) for a geographic area. Use this instead of get_demographics when you only need a subset of categories to keep the response concise.4 params
Retrieve specific demographic categories (e.g. population, income, housing) for a geographic area. Use this instead of get_demographics when you only need a subset of categories to keep the response concise.
Parameters* required
area_codestringArea identifier (ZIP code, FIPS code, GEOID, or CBSA code).
area_typestringGeographic area type.one of
zip · county · state · place · cbsa · tractdata_yearintegerSpecific ACS data year. Omit for the most recent available year.
categoriesarrayOne or more demographic categories to retrieve: population, income, housing, education, employment, households.
get_demographics_trendRetrieve historical demographic data across multiple years for a single geographic area, useful for analysing population growth, income changes, or housing trends over time.4 params
Retrieve historical demographic data across multiple years for a single geographic area, useful for analysing population growth, income changes, or housing trends over time.
Parameters* required
end_yearintegerLast year of the range. Omit for the most recent available year.
area_codestringArea identifier (ZIP code, FIPS code, GEOID, or CBSA code).
area_typestringGeographic area type.one of
zip · county · state · place · cbsa · tractstart_yearintegerFirst year of the range. Omit for the earliest available year.
compare_demographicsCompare demographics side by side for two to ten ZIP codes. Returns each ZIP's demographic profile plus summary comparison ranges (population, income, housing).3 params
Compare demographics side by side for two to ten ZIP codes. Returns each ZIP's demographic profile plus summary comparison ranges (population, income, housing).
Parameters* required
data_yearintegerSpecific ACS data year. Omit for the most recent available year.
zip_codesarrayTwo to ten 5-digit ZIP codes to compare.
categoriesarrayOptional list of categories to include in the comparison.
get_fair_market_rentLook up HUD Fair Market Rent (FMR) rates for a geographic area by ZIP code, county FIPS, CBSA/metro code, or state FIPS. Returns monthly rent estimates by bedroom count (efficiency through 4-bedroom). Note: State-level queries return all ZIP-level FMR records within the state,...3 params
Look up HUD Fair Market Rent (FMR) rates for a geographic area by ZIP code, county FIPS, CBSA/metro code, or state FIPS. Returns monthly rent estimates by bedroom count (efficiency through 4-bedroom). Note: State-level queries return all ZIP-level FMR records within the state,...
Parameters* required
yearintegerFMR fiscal year (default: latest available)
area_codestringArea identifier — format depends on area_type
area_typestringGeographic area type: zip (5-digit), county (5-digit FIPS), cbsa (CBSA/metro code), or state (2-digit FIPS)one of
zip · county · cbsa · stateget_fmr_trendRetrieve Fair Market Rent data across multiple years for a single area. Returns an array of yearly FMR records with rent values by bedroom count. Supports ZIP, county, and CBSA area types. State-level trends are not supported because state queries return aggregated lists of ZI...4 params
Retrieve Fair Market Rent data across multiple years for a single area. Returns an array of yearly FMR records with rent values by bedroom count. Supports ZIP, county, and CBSA area types. State-level trends are not supported because state queries return aggregated lists of ZI...
Parameters* required
end_yearintegerLast year of the range (default: latest available)
area_codestringArea identifier — format depends on area_type
area_typestringGeographic area type: zip, county, or cbsa (state is not supported for trends)one of
zip · county · cbsastart_yearintegerFirst year of the range (default: earliest available)
get_mortgage_summaryRetrieve the mortgage lending summary for a single geographic area (census tract, county, or state) from HMDA data. Returns origination count, denial rate, median loan amount, median interest rate, loan purpose mix, and loan type mix (conventional, FHA, VA, USDA). Source: CFPB...3 params
Retrieve the mortgage lending summary for a single geographic area (census tract, county, or state) from HMDA data. Returns origination count, denial rate, median loan amount, median interest rate, loan purpose mix, and loan type mix (conventional, FHA, VA, USDA). Source: CFPB...
Parameters* required
yearintegerHMDA data year (default: most recent available)
geoidstringFIPS code — 11 digits for tract, 5 for county, 2 for state
area_typestringGeographic level: tract (or census_tract), county, or stateone of
tract · census_tract · county · stateget_mortgage_trendsRetrieve multi-year mortgage lending data for a single area across all available HMDA years. Returns an array of yearly summaries including origination count, denial rate, median loan amount, median interest rate, and loan purpose/type breakdowns. Source: CFPB/FFIEC HMDA.2 params
Retrieve multi-year mortgage lending data for a single area across all available HMDA years. Returns an array of yearly summaries including origination count, denial rate, median loan amount, median interest rate, and loan purpose/type breakdowns. Source: CFPB/FFIEC HMDA.
Parameters* required
geoidstringFIPS code — 11 digits for tract, 5 for county, 2 for state
area_typestringGeographic level: tract (or census_tract), county, or stateone of
tract · census_tract · county · statecompare_mortgageCompare mortgage lending metrics across 2-5 geographic areas for a single HMDA data year. All areas must be the same geographic level (tract, county, or state). Returns side-by-side summaries including origination count, denial rate, median loan amount, and loan type/purpose b...3 params
Compare mortgage lending metrics across 2-5 geographic areas for a single HMDA data year. All areas must be the same geographic level (tract, county, or state). Returns side-by-side summaries including origination count, denial rate, median loan amount, and loan type/purpose b...
Parameters* required
yearintegerHMDA data year (default: most recent available)
geoidsarrayArray of 2-5 FIPS codes to compare
area_typestringGeographic level (must be same for all areas): tract (or census_tract), county, or stateone of
tract · census_tract · county · stateget_migration_summaryRetrieve migration summary for a county or state showing aggregate inflows, outflows, and net migration. Returns net returns (positive = net in-migration, negative = net out-migration), net exemptions (proxy for people), and net AGI (adjusted gross income in thousands of dolla...3 params
Retrieve migration summary for a county or state showing aggregate inflows, outflows, and net migration. Returns net returns (positive = net in-migration, negative = net out-migration), net exemptions (proxy for people), and net AGI (adjusted gross income in thousands of dolla...
Parameters* required
fipsstringFIPS code — 5 digits for county, 2 for state
yearstringYear pair (e.g., '2021-2022'). Defaults to most recent available.
levelstringGeographic level: county or stateone of
county · stateget_migration_flowsRetrieve top inflow or outflow areas for a county or state, ranked by number of tax returns or AGI. Inflows show where people moved from (into this area); outflows show where people moved to (out of this area). Returns an array of flow records with FIPS, area name, returns, ex...6 params
Retrieve top inflow or outflow areas for a county or state, ranked by number of tax returns or AGI. Inflows show where people moved from (into this area); outflows show where people moved to (out of this area). Returns an array of flow records with FIPS, area name, returns, ex...
Parameters* required
fipsstringFIPS code — 5 digits for county, 2 for state
sortstringRanking metric: 'returns' (household count) or 'agi' (income). Default: 'returns'.one of
returns · agiyearstringYear pair (e.g., '2021-2022'). Defaults to most recent available.
levelstringGeographic level: county or stateone of
county · statelimitintegerNumber of top flow areas to return (1-50, default: 10)
directionstringFlow direction: inflow (moved into area) or outflow (moved out of area)one of
inflow · outflowget_migration_trendsRetrieve migration summary data across all available year pairs for a county or state. Returns an array of yearly migration summaries sorted by year pair, each including net returns, net exemptions, net AGI, and inflow/outflow breakdowns. AGI values are in thousands of dollars...2 params
Retrieve migration summary data across all available year pairs for a county or state. Returns an array of yearly migration summaries sorted by year pair, each including net returns, net exemptions, net AGI, and inflow/outflow breakdowns. AGI values are in thousands of dollars...
Parameters* required
fipsstringFIPS code — 5 digits for county, 2 for state
levelstringGeographic level: county or stateone of
county · stateget_employmentRetrieve employment data for a single geographic area. Returns total jobs, industry mix by NAICS sector, earnings distribution, and age breakdown. The 'perspective' parameter controls whether data reflects jobs physically located in the area (workplace, WAC data — default) or...4 params
Retrieve employment data for a single geographic area. Returns total jobs, industry mix by NAICS sector, earnings distribution, and age breakdown. The 'perspective' parameter controls whether data reflects jobs physically located in the area (workplace, WAC data — default) or...
Parameters* required
yearintegerData year. Omit to use the most recent available year.
geoidstringFIPS code for the area — 11 digits for tract, 5 for county, 2 for state.
area_typestringGeographic level: tract, county, or state.one of
tract · county · stateperspectivestringworkplace (jobs located in the area, default) or residence (jobs held by area residents).one of
workplace · residenceget_employment_trendRetrieve employment data across all available years for a single area. Returns an array of yearly metrics (total jobs, industry mix, earnings, age breakdown) ordered ascending by year. Use 'perspective' to choose workplace (default) or residence.3 params
Retrieve employment data across all available years for a single area. Returns an array of yearly metrics (total jobs, industry mix, earnings, age breakdown) ordered ascending by year. Use 'perspective' to choose workplace (default) or residence.
Parameters* required
geoidstringFIPS code for the area — 11 digits for tract, 5 for county, 2 for state.
area_typestringGeographic level: tract, county, or state.one of
tract · county · stateperspectivestringworkplace (jobs located in the area, default) or residence (jobs held by area residents).one of
workplace · residencecompare_employmentCompare employment data for multiple areas side by side (2-10 areas). All geoids must share the same area type. Returns per-area metrics including total jobs, industry mix, earnings, and age breakdown.4 params
Compare employment data for multiple areas side by side (2-10 areas). All geoids must share the same area type. Returns per-area metrics including total jobs, industry mix, earnings, and age breakdown.
Parameters* required
yearintegerData year. Omit to use the most recent available year.
geoidsstringComma-separated FIPS codes to compare (2-10). All must match the specified area type.
area_typestringGeographic level shared by all geoids.one of
tract · county · stateperspectivestringworkplace (default) or residence.one of
workplace · residenceget_commute_flowsRetrieve commute flow (origin-destination) data for a county or state. Shows where workers come from (inbound) or where residents commute to (outbound). Returns top flow pairs with job counts and a 3-supersector industry breakdown (Goods Producing, Trade/Transport/Utilities, A...6 params
Retrieve commute flow (origin-destination) data for a county or state. Shows where workers come from (inbound) or where residents commute to (outbound). Returns top flow pairs with job counts and a 3-supersector industry breakdown (Goods Producing, Trade/Transport/Utilities, A...
Parameters* required
yearintegerData year. Omit to use the most recent available year.
geoidstringFIPS code — 5 digits for county, 2 for state.
limitintegerNumber of top flow pairs to return (1-100, default 25).
min_jobsintegerMinimum job count threshold to include a flow pair (default 0).
area_typestringGeographic level: county or state (tract is not supported for flows).one of
county · statedirectionstringinbound = where workers come from; outbound = where residents commute to.one of
inbound · outboundgeocode_addressConvert a street address or place name into geographic coordinates. Returns up to 'limit' candidate results with coordinates, formatted address, address components, confidence score, and provider name. The optional 'country' parameter biases (but does not strictly filter) resu...3 params
Convert a street address or place name into geographic coordinates. Returns up to 'limit' candidate results with coordinates, formatted address, address components, confidence score, and provider name. The optional 'country' parameter biases (but does not strictly filter) resu...
Parameters* required
limitintegerMaximum number of results to return (1-10, default 5).
addressstringThe address or place name to geocode (minimum 3 characters).
countrystring2-letter uppercase ISO 3166-1 country code to bias results (e.g., 'US'). Biases but does not strictly filter — results from other countries may appear.
reverse_geocodeConvert a latitude/longitude coordinate pair into a street address. Returns the best-match formatted address, address components, and coordinates.2 params
Convert a latitude/longitude coordinate pair into a street address. Returns the best-match formatted address, address components, and coordinates.
Parameters* required
latitudenumberLatitude in decimal degrees (-90 to 90).
longitudenumberLongitude in decimal degrees (-180 to 180).
@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
| 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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
LOC8N_API_KEY*secretAPI key for the loc8n Geographic Data API
Categories
Registryactive
Package@gener8v/mcp-geographic-data
TransportSTDIO, SSE
AuthRequired
UpdatedMar 31, 2026
