Skip to main content
Glama
WardenPro

immo-mcp

by WardenPro
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

Related MCP server: Sherlock Homes

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers