immo-mcp
Analyzes French real-estate market using open data sources like DVF transactions, DPE certificates, and risk data.
README
immo-mcp
An MCP (Model Context Protocol) server for French real-estate market analysis, built exclusively on open data sources. No third-party site automation.
Data sources
| Source | What it provides |
|---|---|
| DVF Etalab | All notarised property transactions in France (2018-present) |
| OpenDataSoft DVF API | Same DVF data, queryable without a local DB |
| ADEME DPE-v2 | Energy-performance certificates (DPE) |
| Géorisques | Flood, seismic, radon, ICPE risk data |
| CRE | Regulated electricity tariffs |
| INSEE | Postal code → INSEE commune lookup |
| Nominatim / Overpass OSM | Geocoding and points of interest |
MCP tools
| Tool | Description |
|---|---|
dvf |
Search DVF transactions by city / postal code / department |
dvf_stats |
Aggregate price statistics from DVF (median, p25/p75, …) |
dvf_db_info |
Report on the local DuckDB DVF database |
pappers_immo |
DVF statistics via the OpenDataSoft public API |
detect_underpriced |
Compare a market segment against DVF + ODS reference prices |
dpe |
Search DPE certificates by city or postal code |
georisques |
Risk analysis for a location (flood, seismic, radon, ICPE) |
list_georisques_kinds |
List available Géorisques risk categories |
electricity_tariff |
Fetch current regulated electricity tariffs (CRE) |
insee_lookup |
Resolve a postal code to its INSEE commune codes |
geocode |
Forward geocode an address via Nominatim |
pois |
Search points of interest around a location (OSM Overpass) |
list_poi_categories |
List available POI category presets |
listings_stats |
Compute price statistics on a list of listings |
listings_gap |
Annotate listings with gap-from-median percentage |
Quick start
1. Install
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
2. (Optional) Build a local DVF database
For faster, offline DVF queries you can build a local DuckDB:
# Requires Docker
cd docker/dvf
DVF_HOST_DATA_DIR=~/.immo-mcp/dvf docker compose up
The MCP server will look for the database at ~/.immo-mcp/dvf/dvf.duckdb.
Without it, the dvf tool falls back to the OpenDataSoft API automatically.
3. Start the server
python -m immo_mcp.server
4. Connect from Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"immo-mcp": {
"command": "/path/to/.venv/bin/python",
"args": ["-m", "immo_mcp.server"]
}
}
}
Environment variables
| Variable | Default | Description |
|---|---|---|
DVF_DB_PATH |
~/.immo-mcp/dvf/dvf.duckdb |
Path to local DuckDB DVF file |
IMMO_CACHE_DB |
~/.immo-mcp/listings.db |
SQLite listing cache |
Development
pip install -r requirements.txt
pytest
License
MIT — see LICENSE.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.