Metadata-Version: 2.4
Name: real-estate-data-mcp-server
Version: 0.1.0
Summary: MCP server providing US real estate data — housing stats, demographics, amenities, and area comparisons via Census ACS and OpenStreetMap
Project-URL: Homepage, https://github.com/AiAgentKarl/real-estate-data-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/real-estate-data-mcp-server
Project-URL: Issues, https://github.com/AiAgentKarl/real-estate-data-mcp-server/issues
Author: AiAgentKarl
License: MIT
License-File: LICENSE
Keywords: ai-agent,amenities,census,demographics,housing,mcp,openstreetmap,property,real-estate
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.2.0
Description-Content-Type: text/markdown

# real-estate-data-mcp-server

<!-- mcp-name: real-estate-data-mcp-server -->

MCP server providing US real estate data — housing statistics, demographics, nearby amenities, area comparisons, cost-of-living analysis, and neighborhood search.

All data comes from **free, public APIs** — no API keys required:
- **US Census ACS 5-Year** (2022) for housing and demographic data
- **OpenStreetMap Nominatim** for geocoding
- **Overpass API** for nearby amenities (schools, hospitals, parks, transit)

[![Glama MCP Server](https://glama.ai/mcp/servers/badge)](https://glama.ai/mcp/servers)

## Tools

| Tool | Description |
|------|-------------|
| `get_housing_stats` | Median home value, rent, vacancy rates, owner-occupied % for any US state or county |
| `get_area_demographics` | Population, income, education, employment, age stats from Census ACS |
| `get_nearby_amenities` | Schools, hospitals, parks, transit stops, supermarkets via OpenStreetMap |
| `compare_areas` | Side-by-side comparison of housing metrics for 2-5 locations |
| `get_cost_of_living` | Housing affordability index, cost burden analysis, national comparison |
| `search_neighborhoods` | Find neighborhoods/places in a city with key housing stats |

## Installation

```bash
pip install real-estate-data-mcp-server
```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "real-estate": {
      "command": "real-estate-server"
    }
  }
}
```

## Usage with Claude Code

```bash
claude mcp add real-estate -- real-estate-server
```

## Example Queries

- "What are the housing stats for California?"
- "Compare housing costs between Texas and New York"
- "Find amenities near downtown San Francisco (37.7749, -122.4194)"
- "What's the cost of living in Colorado?"
- "Search neighborhoods in Austin, TX"
- "Get demographics for Harris County, Texas (county code 201)"

## US State Codes

States can be specified by full name or abbreviation:
- `"California"` or `"CA"`
- `"New York"` or `"NY"`
- `"Texas"` or `"TX"`

Counties require 3-digit FIPS codes (e.g., `"073"` for San Diego County, CA).

## Data Sources

- **US Census Bureau** — American Community Survey 5-Year Estimates (2022)
- **OpenStreetMap** — Nominatim geocoding + Overpass amenity queries
- All APIs are free and require no authentication for basic usage

## License

MIT
