German Real Estate — MCP server

A free MCP server that gives your AI agent structured German property listings from immowelt.de. One tool, clean JSON, no API key and no proxy — it just works.

Tool

search_properties

Returns { "listings": [ { price_eur, price_label, size_sqm, rooms, floor, address, district, city, plz, url, image_url } ], "note": "..." }.

Related MCP server: Booli MCP Server

Quick start (no key needed)

git clone <this repo> && cd german-realestate-mcp
python3.11 -m venv venv && source venv/bin/activate
pip install -r requirements.txt

Add to your MCP client (e.g. Claude Desktop claude_desktop_config.json) — no env vars required:

{
  "mcpServers": {
    "german-real-estate": {
      "command": "/absolute/path/german-realestate-mcp/venv/bin/python",
      "args": ["/absolute/path/german-realestate-mcp/src/server.py"]
    }
  }
}

Then ask your agent: "Find 3-room apartments to rent in Munich under €2,000."

How it works

Scrapes immowelt.de directly with httpx + BeautifulSoup. Listing data only — realtor/agent personal data is intentionally dropped. If a query returns nothing, the tool returns a small sample so it never comes back empty.

Free tier & beyond

The free tier caps results (REALESTATE_FREE_LIMIT, default 10). A paid API is the next step: more cities and sources (kleinanzeigen, price comparison), detail-page enrichment, price history, and higher limits. The free MCP server is the front door.

Develop

pip install -r requirements-dev.txt
pytest

Legal

Returns listing data only (price/size/rooms/location) — no personal data. Use in line with immowelt's terms and applicable law.