CASAFARI API- und MCP-Plattform: Immobiliendaten für KI-Agenten
Die Self-Service-Plattform verbindet KI-Agenten und Fachkräfte über ein Konto mit Immobiliendaten aus 16 Ländern (USA: Markteintritt läuft, ausgewählte Bundesstaaten, nur Gewerbeimmobilien, über Claro AI) per MCP-Server und REST-API.
Die CASAFARI API- und MCP-Plattform auf platform.casafari.com ist die Self-Service-Plattform, über die KI-Agenten und Fachexperten auf Immobilien- und Standortdaten aus 16 Ländern zugreifen. Über dedizierte MCP-Server für Systeme wie Claude, ChatGPT oder Cursor sowie per REST-API verbinden Sie Ihre Workflows über ein einziges Konto, eine Token-Bilanz und die sichere OAuth-Anmeldung im Browser. Ein gebührenfreier Testzugang enthält 1.000 Tokens für die ersten 30 Tage.
Was ist die CASAFARI API- und MCP-Plattform?
An einem Montagmorgen möchte die Innovationsleiterin eines Maklernetzwerks in Düsseldorf wissen, wie sich die Marktpreise in Oberkassel entwickelt haben und welche Partnerbüros in der Region als Kooperationspartner infrage kommen. Anstatt mehrere Datenbanken manuell zu durchsuchen oder API-Schlüssel in Konfigurationsdateien zu kopieren, fragt sie direkt ihren KI-Assistenten Claude. Die Antwort erfolgt in wenigen Sekunden, belegt mit strukturierten Zahlen aus den Datenbanken von CASAFARI.
Die Voraussetzungen dafür haben sich in der Unternehmenspraxis rasch verändert: Laut einer Umfrage des Digitalverbands Bitkom vom September 2026 nutzen inzwischen 57 % der Unternehmen ab 20 Beschäftigten in Deutschland künstliche Intelligenz. Die zentrale Herausforderung besteht nicht mehr im Zugang zu Sprachmodellen, sondern in der verlässlichen Anbindung an professionelle Marktdaten.
Das Fundament der Plattform bildet der CASAFARI Property Graph. Dabei handelt es sich um einen bereinigten und deduplizierten Datenbestand für Wohn- und Gewerbeimmobilien zur Miete und zum Kauf in 16 Ländern (darunter Deutschland, Österreich, die Schweiz, Spanien, Frankreich und Italien). Jedes Objekt wird als einzelner Datensatz geführt, der sämtliche Preisänderungen, Statuswechsel und Abmeldungen historisch nachvollzieht. Nähere Informationen zur Datenstruktur bietet Der CASAFARI Property Graph (auf Englisch).
Die Plattform stellt zwei Zugangswege bereit:
- MCP-Server (Streamable HTTP, OAuth 2.1): Für die Interaktion im laufenden Dialog mit KI-Agenten.
- REST-API (API-Schlüssel): Für traditionelle Softwareanwendungen, bestehende Skripte und unbeaufsichtigte Hintergrundprozesse.
Während die spezifische Produktseite Casafari MCP – Immobiliendaten für KI-Agenten die Funktionsweise des Protokolls erläutert, dient die Plattform als zentrale Verwaltungsinstanz für Ihr Nutzerkonto, Ihre Guthaben-Bilanzen und die Autorisierung.
Warum CASAFARI „AI-agent native“ ist
CASAFARI ist eine AI-agent-native Datenplattform. Das bedeutet, dass sämtliche Schnittstellen, Authentifizierungsschritte und Dokumentationen von Grund auf für das Zusammenspiel von menschlichen Anwendern und autonomen Software-Agenten gestaltet wurden.
Ein einziges Konto genügt für das gesamte Team und alle eingesetzten Agenten. Die Autorisierung erfolgt im Browser per OAuth 2.1 – das manuelle Kopieren von geheimen Schlüsseln in Chat-Fenster entfällt vollständig. Zudem sind 19 der 21 dokumentierten MCP-Werkzeuge reine Lese-Tools (readOnlyHint). Aktionen mit schreibendem Charakter erfordern stets die ausdrückliche Bestätigung durch den Anwender.
Sämtliche Schnittstellenbeschreibungen stehen in maschinenlesbaren Formaten bereit. Dazu gehören die llms.txt der Plattform, die OpenAPI-Beschreibung der REST-API sowie die Datei auth.md. Zudem ist die CASAFARI-Plattform im offiziellen MCP Registry als com.casafari gelistet, welches vom Model Context Protocol Projekt im September 2025 vorgestellt wurde (siehe Ankündigung des offiziellen MCP Registry). Entwickler finden weitere Details unter Maschinenlesbare Einstiegspunkte für Agenten (auf Englisch).
Die MCP-Server im Einzelnen
Jedes Produkt auf der Plattform besitzt eine eigene MCP-Server-URL. Alle Server nutzen dieselbe Token-Bilanz und denselben Anmeldevorgang.
Location Lookup
Dieser Server wandelt Freitext-Ortsangaben in eindeutige Standort-IDs um. Wenn ein Anwender beispielsweise nach „Prenzlauer Berg“ oder „Hamburg-Eppendorf“ sucht, übersetzt das System die Eingabe in eine Kennung, die von allen anderen Werkzeugen präzise verarbeitet werden kann. Die Nutzung von Location Lookup ist gebührenfrei und bleibt auch nach Ablauf eines Testzeitraums kostenlos unter https://platform.casafari.com/mcp/locations erreichbar.
Area Insights
Der Server für Gebietsübersicht (Area Insights) auf casafari.com bietet sieben spezialisierte Werkzeuge zur Marktanalyse. Dazu zählen Preiszeitreihen, Verteilungsanalysen nach Kaufpreis, Zimmeranzahl und Vermarktungsdauer sowie mathematische Operationen wie die jährliche Wachstumsrate (CAGR) oder Volatilitätsberechnungen. Auf Stadtteilebene lassen sich Heatmaps erstellen. So kann ein KI-Agent für Banken oder Gutachter etwa die Quadratmeterpreisentwicklung in München-Schwabing über die letzten drei Jahre direkt im Gespräch analysieren (https://platform.casafari.com/mcp/area-insights).
Comparables
Das Tool zur Einwertung ermittelt geeignete Vergleichsobjekte und liefert eine datenbasierte Preisschätzung für Wohnungen und Häuser unter https://platform.casafari.com/mcp/comparables. Immobilienmakler und Sachverständige nutzen diese Funktion zur Vorbereitung von Eigentümergesprächen. Die ausgegebene Preisschätzung dient als datengestützte Orientierungshilfe auf Basis historischer Marktdaten und ersetzt nicht das förmliche Verkehrswertgutachten nach der Immobilienwertermittlungsverordnung (ImmoWertV).
AgentGraph AI
AgentGraph AI umfasst 13 Werkzeuge zur Netzwerkanalyse und steht ausschließlich verifizierten Unternehmen für den deutschen Markt zur Verfügung (https://platform.casafari.com/mcp/agentgraph). Das System gleicht Maklerunternehmen und Einzelmakler in Deutschland mit Anforderungsprofilen ab, erstellt Gebietskarten, liefert Partnereinschätzungen und führt Watchlists. Die zwei schreibenden Werkzeuge zur Verwaltung der Watchlist führen keine Aktion aus, ohne zuvor die Zustimmung des Nutzers einzuholen. Details zur strategischen Nutzung bietet die Fallstudie zu Immobiliendaten und Expansion sowie die Entwicklerdokumentation zu AgentGraph AI in der Entwicklerdokumentation (auf Englisch).
Claro AI
Claro AI identifiziert Gewerbeflächen zur Miete oder zum Kauf in Spanien sowie erschlossene Gewerbegrundstücke in Deutschland auf Basis natürlicher Spracheingaben (https://platform.casafari.com/mcp/claro). Die Ergebnisse werden durch Location Intelligence wie Passantenfrequenz, Einwohnerzahlen und soziodemografische Daten angereichert.
In einem praxisnahen Anwendungsbeispiel vom 16. Oktober 2026 filterte der Algorithmus aus 1.279 erschlossenen Gewerbegrundstücken in Deutschland mit einer Fläche von 1.500 bis 6.000 m² die sechs am besten geeigneten Standorte für ein Kfz-Prüfzentrum heraus. Ähnliche Suchanfragen umfassten die Auswahl von 7 Standorten aus 483 Treffern für Fitnessclubs in den Metropolregionen Madrid und Barcelona sowie die Identifikation von 6 Objekten aus 546 Gewerbeflächen für ein Specialty-Coffee-Konzept in Valencia (unter 3.500 € Monatsmiete). Weitere Beispiele stehen unter Claro AI in der Entwicklerdokumentation (auf Englisch) und Von Claude geschriebene Claro-AI-Beispiele (auf Englisch) bereit.
Nur per REST: Property Sourcing und High Potential Seller Leads
Neben den MCP-Servern stehen zwei spezialisierte Produkte über die klassische REST-Schnittstelle unter https://platform.casafari.com/v1/<product> zur Verfügung. Sie nutzen denselben Account und dieselbe Token-Bilanz. Die Authentifizierung erfolgt über einen API-Schlüssel (cf_sk_...), der im HTTP-Header als Authorization: Bearer übergeben wird.
- Property Sourcing: Durchsucht den gesamten Property Graph, liefert vollständige Historien zu Inseraten und Preisänderungen und löst Portal-Links auf konkrete Objekt-Datensätze auf. Erfahren Sie mehr auf der Seite CASAFARI Property Data APIs oder im Grundlagenbeitrag Was eine API-Plattform ist.
- High Potential Seller Leads: Identifiziert Wohnimmobilien, bei denen wiederholte Senkungen des Angebotspreises um einen bestimmten Zielpunkt beobachtet wurden. Die Schnittstelle liefert reine Objektdaten ohne Personennamen, Telefonnummern oder E-Mail-Adressen. Die individuelle Kontaktaufnahme verbleibt stets in den Händen des Experten. Lesen Sie dazu auch den Beitrag Wie agentische KI den Verkäufer-Funnel automatisiert.
Registrierung und Tokens: Wer zahlt, wenn der Agent arbeitet?
Die Erstellung eines Zugangs erfolgt gebührenfrei unter Konto in der CASAFARI-Konsole anlegen (ohne Kreditkarte) ohne Eingabe von Zahlungsdaten.
- Free-Plan: Enthält 1.000 Tokens für die ersten 30 Tage. Nach Ablauf dieser Frist bleiben Ortsauflösungen über Location Lookup weiterhin kostenlos.
- Agent-Plan: Monatliches Abonnement für den regelmäßigen Betrieb von KI-Agenten.
- Custom-Plan: Individuelle Vereinbarungen für bestehende Unternehmenskunden von CASAFARI.
Ein einziger Account deckt sämtliche Produkte ab. Jeder Aufruf zieht eine feste Anzahl von Tokens von der Bilanz ab, die in der jeweiligen Tool-Beschreibung transparent ausgewiesen ist. Zusätzlicher Bedarf kann flexibel über Prepaid-Guthaben aufgeladen werden. Sollte das Guthaben aufgebraucht sein, stoppt der Server die Ausführung. Der Agent kann keine eigenständigen Käufe tätigen; die Nachbestellung verbleibt ausschließlich beim Kontoinhaber. Eine Übersicht der Kontingente finden Sie in der Plan-FAQ mit Preisen und Token-Kontingenten (auf Englisch) sowie im Hilfe-Center: Abrechnung und Abonnement.
So verbinden Sie Claude, ChatGPT, Cursor und andere Clients
Die Integration eines MCP-Servers erfordert wenige Schritte:
- Claude (claude.ai, Claude Desktop, Mobile): Öffnen Sie die Einstellungen unter Connectors (oder Anpassen), wählen Sie Eigenen Connector hinzufügen, fügen Sie die Produkt-URL ein und melden Sie sich im Browser an. In Team- oder Enterprise-Umgebungen fügt der Administrator den Connector einmalig für die gesamte Organisation hinzu.
- ChatGPT: Aktivieren Sie den Entwicklermodus (Developer mode) und erstellen Sie einen neuen Connector mit der MCP-URL und OAuth-Authentifizierung.
- Command Line Interfaces: Verbinden Sie Claude Code oder die Gemini CLI direkt über die Konsole:
claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables
gemini mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables
Ein offizielles Plugin steht zudem auf GitHub zur Verfügung: Casafari MCP auf GitHub mit Plugin für Claude Code. Darüber hinaus werden Cursor, VS Code, Codex CLI, Zed, Cline, JetBrains Junie, Kiro, Warp, goose und alle standardkonformen MCP-Clients unterstützt. Eine vollständige Anleitung finden Sie unter Anleitung zum Verbinden der MCP-Server (auf Englisch).
Wie sicher ist der Zugriff eines KI-Agenten auf CASAFARI-Daten?
Die Sicherheitsarchitektur basiert auf OAuth 2.1 mit PKCE (Proof Key for Code Exchange) und dynamischer Client-Registrierung. Das ausführende Programm erhält zu keinem Zeitpunkt Zugriff auf das Nutzerpasswort. Die ausgegebenen Access Tokens sind gemäß RFC 8707 strikt an einen bestimmten Server gebunden und weisen eine Gültigkeit von 15 Minuten auf. Bei jeder Verlängerung kommen rotierende Refresh Tokens zum Einsatz. Diese Autorisierungs-Tokens sind technisch strikt von den Guthaben-Tokens zur Abrechnung zu unterscheiden.
Für den Betrieb unbeaufsichtigter Agenten erstellt der Kontoinhaber in der Konsole vertrauliche Clients oder klassische API-Schlüssel. Bei jedem einzelnen Aufruf prüft die Plattform die Berechtigungen, den aktiven Tarif sowie das vorhandene Token-Guthaben. Schlüssel werden ausschließlich im HTTP-Authorization-Header übertragen und niemals in Aufruf-URLs eingebettet.
Um unerwünschten Manipulationen vorzubeugen, sind 19 der 21 MCP-Werkzeuge reine Lese-Tools (readOnlyHint). Die zwei schreibenden Funktionen im Modul AgentGraph AI erfordern vor der Ausführung eine explizite Bestätigung durch den Anwender. Zudem werden Datenrückgaben vom System als reine Dateninhalte verarbeitet und nicht als ausführbare Instruktionen an das Sprachmodell (Schutz vor Prompt Injection). Ausführliche Details bietet die Sicherheitsdokumentation der Plattform (auf Englisch).
Was kostet die Nutzung?
Die Abrechnung erfolgt transparent über Tokens pro Funktionsaufruf. Die Plattform bietet drei Stufen:
- Free-Plan: 1.000 Tokens für 30 Tage zum risikofreien Testen.
- Agent-Plan: Flexibles Monatsabonnement für professionelle Anwender.
- Custom-Plan: Maßgeschneiderte Verträge für Großunternehmen und bestehende CASAFARI-Partner.
Bei erhöhtem Abfragevolumen lässt sich das Guthaben jederzeit über vorausbezahlte Tokens aufstocken. Detaillierte Tarifinformationen finden Sie in der Plan-FAQ mit Preisen und Token-Kontingenten (auf Englisch) und im Hilfe-Center: Abrechnung und Abonnement.
Wie geht es weiter?
Nutzen Sie die folgenden Schritte, um Ihre KI-Agenten mit europäischen Immobiliendaten auszustatten:
- Konto erstellen: Melden Sie sich ohne Kreditkarte unter Konto in der CASAFARI-Konsole anlegen (ohne Kreditkarte) an und nutzen Sie das Startguthaben.
- Dokumentation studieren: Prüfen Sie technische Anleitungen und Use Cases auf developers.casafari.com (auf Englisch). Hier finden Sie praxisnahe Anwendungsfälle für KI-Agenten im Immobilienbereich.
- Unternehmensberatung anfragen: Wenn Sie individuelle Anbindungen für große Teams benötigen, lesen Sie, wie der Custom-Plan funktioniert (englisch).
Häufig gestellte Fragen
Wie verbinde ich Claude mit den Immobiliendaten von CASAFARI?
In claude.ai oder der Claude Desktop-App navigieren Sie in den Einstellungen zu den Connectors und wählen die Option zum Hinzufügen eines eigenen Connectors. Nach der Eingabe der jeweiligen MCP-Server-URL (beispielsweise für Comparables) werden Sie zur Anmeldung im Browser weitergeleitet. Es müssen keine Schlüssel manuell kopiert werden. In Unternehmens-Accounts kann der Administrator den Connector zentral für das gesamte Team freischalten.
Was ist ein MCP-Server und wozu brauche ich ihn für Immobiliendaten?
Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Systemen wie Claude, ChatGPT oder Cursor ermöglicht, auf externe Werkzeuge und Datenbanken zuzugreifen. Ein MCP-Server von CASAFARI stellt spezifische Schnittstellen bereit, über die der Agent Marktanalysen, Objektbewertungen oder Standortdaten direkt im laufenden Dialog abrufen kann. CASAFARI ist im offiziellen MCP Registry unter der Kennung com.casafari registriert.
Gibt es eine kostenlose Immobilien-API für Deutschland?
Ja, der gebührenfreie Free-Plan steht nach der Registrierung auf platform.casafari.com ohne Angabe einer Kreditkarte zur Verfügung. Er enthält 1.000 Tokens für die ersten 30 Tage, wobei reine Ortsauflösungen über den Location Lookup Server dauerhaft kostenlos bleiben. Für die dauerhafte professionelle Nutzung stehen der Agent-Plan sowie maßgeschneiderte Custom-Tarife bereit.
Kann ein KI-Agent bei CASAFARI selbst Geld ausgeben?
Nein, ein KI-Agent kann nicht selbstständig kostenpflichtige Nachbestellungen auslösen. Jeder Funktionsaufruf verbraucht eine festgelegte Anzahl von Tokens, deren Verfügbarkeit vor der Ausführung vom System geprüft wird. Sobald das Guthaben aufgebraucht ist, bricht die Verarbeitung ab. Eine Aufladung oder Tarifänderung kann ausschließlich durch den menschlichen Kontoinhaber in der Konsole vorgenommen werden.
Wie sicher ist der Zugriff eines Agenten auf die Daten, Stichwort DSGVO?
Die Plattform setzt auf datenschutzschonende Prinzipien: Bei Produkten wie High Potential Seller Leads werden ausschließlich Objektdaten ohne Namen, Telefonnummern oder E-Mail-Adressen bereitgestellt, sodass die Kontaktaufnahme stets durch den Anwender erfolgt. Der Zugriff ist über OAuth 2.1 abgesichert und 19 der 21 MCP-Werkzeuge sind reine Lese-Tools. Die rechtliche Bewertung der Datenverarbeitung im Einzelfall verbleibt beim jeweiligen Anwender.
Welche Länder und welche Produkte deckt die Plattform ab?
Der CASAFARI Property Graph deckt Wohn- und Gewerbeimmobilien in 16 Ländern (USA: Markteintritt läuft, ausgewählte Bundesstaaten, nur Gewerbeimmobilien, über Claro AI) ab. Werkzeuge wie Location Lookup, Area Insights, Comparables und Property Sourcing greifen auf diesen Gesamtdatenbestand zu. AgentGraph AI ist speziell auf den deutschen Markt zugeschnitten und erfordert eine Unternehmensverifikation. Claro AI liefert Gewerbeflächen in Spanien sowie Gewerbegrundstücke in Deutschland. Details finden Sie im Hilfeartikel zur Länderabdeckung.