{
  "markdown": "# @gener8v/mcp-geographic-data\n\nMCP server for the [loc8n Geographic Data API](https://loc8n.com). Exposes U.S. demographics, housing, mortgage, migration, employment, and geographic data as tools for any MCP-compatible client (Claude Desktop, Claude Code, Cursor, etc.).\n\n## Quick Start\n\n```bash\nnpm install -g @gener8v/mcp-geographic-data\n```\n\nSet your API key:\n\n```bash\nexport LOC8N_API_KEY=\"your-api-key\"\n```\n\nGet a key at [loc8n.com](https://loc8n.com).\n\n## Usage\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"geographic-data\": {\n      \"command\": \"mcp-geographic-data\",\n      \"env\": {\n        \"LOC8N_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd to your project's `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"geographic-data\": {\n      \"command\": \"mcp-geographic-data\",\n      \"env\": {\n        \"LOC8N_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Hosted SSE (no install required)\n\nConnect any MCP-compatible client directly to the hosted server at `mcp.loc8n.com`. Pass your API key as a query parameter or `Authorization` header:\n\n```\nSSE endpoint: https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY\n```\n\nOr with a Bearer token:\n\n```\nGET https://mcp.loc8n.com/sse\nAuthorization: Bearer YOUR_API_KEY\n```\n\nEach connection gets an isolated session — your API key is used for all requests and usage is tracked against your account.\n\n### Cursor\n\nAdd to your Cursor MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"geographic-data\": {\n      \"url\": \"https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY\"\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"geographic-data\": {\n      \"serverUrl\": \"https://mcp.loc8n.com/sse?apiKey=YOUR_API_KEY\"\n    }\n  }\n}\n```\n\n### Self-Hosted SSE\n\nRun the server locally for development or custom deployments:\n\n```bash\nmcp-geographic-data --transport sse --port 3100\n```\n\nEndpoints:\n- SSE: `http://localhost:3100/sse`\n- Messages: `http://localhost:3100/messages`\n- Health: `http://localhost:3100/health`\n\n## Tools (23)\n\n### Geographic Lookup\n\n| Tool | Description |\n|------|-------------|\n| `lookup_zip_code` | Get details for a ZIP code (city, county, state, coordinates) |\n| `search_zip_codes_by_city` | Find ZIP codes for a city/state |\n| `find_zip_codes_in_radius` | Find ZIP codes within a radius of a point |\n| `calculate_zip_code_distance` | Calculate distance between two ZIP codes |\n| `search_areas` | Search counties, states, or metro areas by name |\n\n### Demographics\n\n| Tool | Description |\n|------|-------------|\n| `get_demographics` | Full demographic profile (population, income, education, etc.) |\n| `get_demographics_category` | Single demographic category in detail |\n| `get_demographics_trend` | Year-over-year demographic trends |\n| `compare_demographics` | Side-by-side comparison of two areas |\n\n### Housing & Market Data\n\n| Tool | Description |\n|------|-------------|\n| `get_fair_market_rent` | HUD Fair Market Rent by bedroom count |\n| `get_fmr_trend` | Fair Market Rent trends over time |\n\n### Mortgage & Lending\n\n| Tool | Description |\n|------|-------------|\n| `get_mortgage_summary` | HMDA mortgage origination summary |\n| `get_mortgage_trends` | Mortgage lending trends over time |\n| `compare_mortgage` | Side-by-side mortgage comparison of two areas |\n\n### Migration\n\n| Tool | Description |\n|------|-------------|\n| `get_migration_summary` | IRS SOI migration inflows/outflows |\n| `get_migration_flows` | Top origin/destination flows for an area |\n| `get_migration_trends` | Migration trends across year pairs |\n\n### Employment\n\n| Tool | Description |\n|------|-------------|\n| `get_employment` | LODES employment profile (jobs, sectors, wages) |\n| `get_employment_trend` | Employment trends over time |\n| `compare_employment` | Side-by-side employment comparison |\n| `get_commute_flows` | Top commute origins/destinations |\n\n### Geocoding\n\n| Tool | Description |\n|------|-------------|\n| `geocode_address` | Convert address to coordinates and FIPS codes |\n| `reverse_geocode` | Convert coordinates to address and area identifiers |\n\n## Resources (7)\n\n| URI | Description |\n|-----|-------------|\n| `data://demographics/available-years` | Available years for ACS demographics data |\n| `data://fmr/available-years` | Available years for HUD Fair Market Rent data |\n| `data://mortgage/available-years` | Available years for HMDA mortgage data |\n| `data://migration/available-years` | Available year pairs for IRS migration data |\n| `data://employment/available-years` | Available years for LODES employment data |\n| `data://tiers` | Subscription tier definitions and permissions |\n| `data://auth/context` | Current API key tier, permissions, and rate limits |\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `LOC8N_API_KEY` | Yes | — | API key for the loc8n Geographic Data API |\n| `LOC8N_API_BASE_URL` | No | `https://api.loc8n.com` | API base URL |\n\n## CLI Options\n\n```\nmcp-geographic-data [options]\n\n  --transport <stdio|sse>  Transport protocol (default: stdio)\n  --port <number>          Port for SSE transport (default: 3100)\n  --help, -h               Show help\n```\n\n## License\n\nMIT\n",
  "bytes": 5286,
  "sha": "c0dc3c5c65be990671490d79105ad6423e450331fe8570faa8159c02818d00be",
  "repo_slug": "gener8v/gener8v.mcp.geographic-data",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gener8v_thomas_mcp_geographic__b650a4f0/readme"
}