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: civic-library-mcp

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

Install Server

license - permissive license

quality

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.

Tools

View all tools

Related MCP Servers

Census MCP Server
Government Data Open Data Research & Data
mattpodwysocki
A
license
A
quality
C
maintenance
Node.js MCP server enabling AI agents to access comprehensive U.S. Census Bureau demographic and economic data, including ACS, decennial census, and business patterns.
Last updated 2026-01-27
17
23
MIT
civic-library-mcp
Government Data Open Data Location Services
adriancisnerosspeed-hub
A
license
-
quality
B
maintenance
An MCP server that gives AI agents clean, token-efficient access to US civic & property data — geocoding, census tracts, Opportunity Zones, ACS demographics, and FEMA flood zones — sourced entirely from free federal open data.
Last updated 2026-06-16
53
1
MIT
country-state-city
Location Services Open Data
tansuasici
A
license
-
quality
B
maintenance
Provides complete world location data (countries, states, cities) as an MCP server for AI assistants, enabling search and retrieval of geographic information through 11 tools and 5 resources.
Last updated 2026-07-20
337
MIT
census-mcp-server
Government Data Open Data Search
zenlyticgreg
F
license
-
quality
C
maintenance
A production-grade MCP server for querying U.S. Census Bureau data (ACS 5-Year and Decennial) with tools for geographic fuzzy matching, variable search, and batched data retrieval, backed by a PostgreSQL cache for performance.
Last updated 2026-07-07

View all related MCP servers

Related MCP Connectors

IBGE Brasil MCP
MCP server for live, sourced Brazilian public data from the official IBGE APIs.
earth
MCP server for Mireye Earth — federal-source-cited geospatial data for any MCP-aware agent.
nominatim
Nominatim MCP — wraps OpenStreetMap Nominatim geocoding API (free, no auth)

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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