How do I use geographic-data?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@geographic-data Show demographics for 10001" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

geographic-data

by gener8v

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

@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.

Related MCP server: Census MCP Server

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

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

5Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gener8v/gener8v.mcp.geographic-data'

If you have feedback or need assistance with the MCP directory API, please join our Discord server