Skip to main content
Glama
Sign In
immo-mcp

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: MCP Immobilier France (DVF)

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Sherlock Homes

      RomainLaffitau
      F
      license
      Not graded
      quality
      D
      maintenance
      French real estate data platform for AI agents. Identifies property owners likely to sell and tracks behavioral signals on active listings. Coverage: metropolitan France.
      -

    • nyambot-mcp

      GabMJ23
      A
      license
      A
      quality
      D
      maintenance
      A French administration MCP server that enables AI agents to access official public data including communes, geocoding, property risks, and energy performance certificates (DPE) for real estate evaluation.
      4
      35 PyPI
      MIT

    Appeared in Searches