Erste Schritte

Der immo.zip-MCP-Server spricht JSON-RPC 2.0 über HTTPS (Streamable-HTTP-Transport). Er benötigt keine Authentifizierung und liefert ausschließlich öffentliche Inseratsdaten. Einmal verbinden — dein Assistent entdeckt alle fünf Werkzeuge automatisch über tools/list.

Endpoints

MCP-Endpoint

https://mcp.immo.zip/mcp

Diese URL ist in jedem Client die Server-Adresse.

Health-Check

https://mcp.immo.zip/health

Liefert 200, wenn der Dienst erreichbar ist.

Client-Einrichtung

1Connectors öffnen. Einstellungen → Connectors (oder Apps). Falls angeboten: Erweiterte Einstellungen → Entwicklermodus aktivieren.
2Server hinzufügen. „Neue App verbinden" / „MCP-Server hinzufügen" wählen, dann https://mcp.immo.zip/mcp einfügen.
3Authentifizierung: keine. Der Server stellt nur öffentliche Inseratsdaten bereit.
4Testen. Frag: „Zeig mir 3-Zimmer-Wohnungen in Wien unter 500.000 €."

Unterstützte Plattformen

immo.zip funktioniert in jedem MCP-fähigen Client. Überall gilt dasselbe: den Endpoint https://mcp.immo.zip/mcp als MCP-Server eintragen, Authentifizierung „keine". Hier die gängigsten Plattformen:

ChatGPTEinstellungen → Connectors → „MCP-Server hinzufügen", Endpoint einfügen, Auth: keine. (Entwicklermodus ggf. aktivieren.)

Claude (Web & Desktop)Einstellungen → Connectors → „Eigenen Connector hinzufügen", Endpoint-URL einfügen, keine Auth.

Claude Code (CLI)claude mcp add --transport http immozip https://mcp.immo.zip/mcp

CursorSettings → MCP → „Add new MCP server" oder Eintrag in .cursor/mcp.json mit der url.

WindsurfSettings → Cascade → MCP Servers → „Add server", Typ HTTP, Endpoint einfügen.

VS Code (Copilot / Agent Mode)MCP: Add Server → HTTP, Endpoint einfügen; oder in .vscode/mcp.json unter "servers" eintragen.

Cline (VS Code)MCP Servers → „Configure" → Remote/HTTP-Server mit der Endpoint-URL hinzufügen.

ZedAssistant-Einstellungen → „Add Context Server" → HTTP-URL des Endpoints eintragen.

ContinueIn der config (.continue) einen MCP-Server-Eintrag vom Typ http mit der url ergänzen.

LM StudioProgram → MCP → „Add MCP server", Remote-Server mit dem Endpoint hinzufügen.

Gemini CLIIn settings.json unter mcpServers einen httpUrl-Eintrag mit dem Endpoint anlegen.

JetBrains AI (IDEA, PyCharm …)AI Assistant → MCP → „Add" → HTTP-Server, Endpoint-URL eintragen.

WarpWarp Drive → MCP Servers → „Add" → URL-basierten Server mit dem Endpoint.

n8nMCP-Client-Node einfügen, Server-Typ HTTP, Endpoint-URL setzen, keine Credentials.

Werkzeug-Referenz

ToolBeschreibung

search_propertiesWohnungen, Häuser und Anlageobjekte nach Ort, Preis, Zimmern, Fläche und Kategorie suchen.Frag zum Beispiel: „3-Zimmer-Wohnungen in Wien unter 500.000 €"

get_property_detailVolles Exposé: Details, Bilder, Anbieter, Quellen und Direktlinks zu einem Objekt.Frag zum Beispiel: „Zeig mir alles zu Inserat 104290"

compare_propertiesZwei bis fünf Objekte nebeneinander stellen und ein strukturiertes Urteil erhalten.Frag zum Beispiel: „Vergleiche 104290 und 104289"

ai_searchFreitext-Anfragen in präzise immo.zip-Filter übersetzen.Frag zum Beispiel: „Etwas Ruhiges, im Grünen, max. 30 Min. ins Büro"

get_map_markersGeo-Marker für Kartenansichten und Bounding-Box-Suchen.Frag zum Beispiel: „Was steht rund um diese Adresse zum Verkauf?"

Was du suchen kannst

Über search_properties und ai_search deckst du das gesamte Filterspektrum von immo.zip ab. Dein Assistent übersetzt natürliche Sprache automatisch in die passenden Parameter — du musst dir keine Feldnamen merken.

Objektarten

Wohnung
Haus
Grundstück
Gewerbe / Ladenfläche
Anlageobjekt / Mehrfamilienhaus
Neubau-Projekt

Geschäftsart

Kauf
Miete
Anlage / Rendite
Provisionsfrei filtern

Filter

Ort, Bezirk, Umkreis oder Bounding-Box
Preis (kalt/warm) und Preis pro m²
Zimmer, Wohn- und Grundstücksfläche
Baujahr, Zustand, Energieklasse
Ausstattung: Balkon, Lift, Garten, Stellplatz
Bruttorendite (für Anlageobjekte)
Nur aktive / neue / preisreduzierte Inserate

Live-Daten

Status: aktiv / reserviert / offline
Kompletter Preisverlauf, täglich geprüft
Marktwert, Mietrendite und Lage-Score pro Objekt
Alle Originalquellen gebündelt

Sprache & Währung

Anfrage in jeder Sprache — automatisch übersetzt
Antwort in deiner Zielwährung (EZB-Tageskurs)
Automatische Standort-Erkennung, wenn kein Ort genannt ist

Märkte

Österreich live
Deutschland & Schweiz als Nächstes
28 EU-Märkte bis 2027

Funktionstest

curl -X POST https://mcp.immo.zip/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Liefert dies die Werkzeugliste, ist der Server erreichbar. Verbindet dein Client dennoch nicht, prüfe URL, HTTPS, Entwicklermodus und CORS.

Limits & Fair Use

Fair-Use-Ratelimits schützen den Dienst vor Missbrauch. Für normale, interaktive Nutzung durch KI-Assistenten sind sie großzügig bemessen; automatisierter Massen-Abruf wird gedrosselt.

Security: Der Server ist ohne Authentifizierung, weil er ausschließlich öffentliche Inserats- und Portaldaten liefert. Trag niemals Admin-Schlüssel, Passwörter oder private Kundendaten in MCP-Konfigurationen ein. Kommen später private Workflows dazu, wird OAuth zuerst ausgeliefert.

Philosophie

Model Context ProtocolAnthropic

Gebaut auf dem Model Context Protocol von Anthropic.

immo.zip baut auf dem Model Context Protocol (MCP) — dem offenen Standard von Anthropic, der KI-Assistenten mit Werkzeugen und Daten verbindet. Wir teilen diese Haltung: offen, transparent, zugänglich.

Open Standard

Kein proprietäres SDK, kein Lock-in. Ein offener Endpoint, den jeder MCP-Client sprechen kann.

Open Data

Nur öffentliche Immobiliendaten, transparent zur Originalquelle verlinkt. Nichts Verstecktes.

Open Access

Kein Account, keine Bezahlschranke, keine Werbung. Neutral sortiert, für alle nutzbar.

Privacy first

Keine Logs, kein Tracking, keine Profile. Deine Suche gehört dir.