English Français العربية

loc8n Geographic Data

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

متغيرات البيئة

  • LOC8N_API_KEY إلزامي سري API key for the loc8n Geographic Data API

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو loc8n Geographic Data؟

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

كيف أثبّت loc8n Geographic Data؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport sse loc8n-geographic-data 'https://mcp.loc8n.com/sse' --header 'Authorization: <Bearer token — your loc8n API key>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج loc8n Geographic Data إلى مفتاح API؟

نعم. يتطلب LOC8N_API_KEY, Authorization، وتضبطها في إعداداته.

هل loc8n Geographic Data مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون loc8n Geographic Data؟

ينشره gener8v. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.