Der MCP-Server von flatin.es für KI-Agenten
flatin.es betreibt einen öffentlichen Server des Model Context Protocol (MCP): Ein KI-Assistent – Claude, ChatGPT, Cursor oder ein anderer – kann unseren Neubaukatalog, unsere Rechner und die lokalen Daten direkt abfragen, statt zu raten oder veraltete Seiten zu lesen. Kostenlos, ohne Registrierung und ohne Schlüssel.
Jede Antwort nennt Quelle und Datum jeder Zahl und verlinkt die Seite von flatin.es, auf der alles vollständig steht: Der Assistent kann sie zitieren, Sie können sie prüfen.
Was er beantworten kann
- Neubauten im Verkauf in einer Gemeinde, einer Provinz oder einer Käuferzone (Costa Blanca, Costa del Sol): Name, Bauträger, Preis ab, Schlafzimmer, Fertigstellung und das Datum, an dem die Website des Bauträgers gelesen wurde.
- Kaufnebenkosten einer Wohnung überall in Spanien: Mehrwertsteuer und Stempelsteuer beim Neubau oder Grunderwerbsteuer beim Bestand je nach Steuergebiet, dazu Notar und Grundbuch nach den amtlichen Gebühren – wie unser Kaufnebenkostenrechner.
- Steuer für Nichtresidenten (IRNR, Modelo 210) eines Eigentümers: fiktives Einkommen und Miete, EU/EWR oder nicht – wie der Modelo-210-Rechner.
- 2 bis 4 Orte vergleichen mit offenen Daten: Wohnungspreise, Miete, IBI, Bevölkerung, Einkommen, Ferienwohnungen, Ausländeranteil und mehr, jede Zahl mit Zeitraum und Quelle.
- IBI-Satz einer Gemeinde mit Jahr und Quelle (Finanzministerium) – der IBI-Datensatz.
Abdeckung: Der Neubaukatalog umfasst Costa Blanca und Costa del Sol; lokale Daten und Vergleiche die Gemeinden der Provinzen Alicante, Málaga, Valencia und Murcia. Kaufnebenkosten werden für ganz Spanien berechnet, die IRNR hängt nicht vom Ort ab. Außerhalb dieser Abdeckung sagt das Werkzeug das, statt etwas zu erfinden.
Werkzeuge
newbuilds_in_placeNeubauprojekte im Verkauf in einer Gemeinde, Zone oder Provinz (bis zu 25 pro Aufruf, mit Link zur vollständigen Liste).
ibi_rateJährlicher IBI-Satz (urbana) einer Gemeinde mit Jahr und Quelle.
compare_placesAktuelle Zahlen für 2 bis 4 Orte nebeneinander, jeweils mit Einheit, Zeitraum und Quelle.
purchase_costsSteuern und Gebühren beim Wohnungskauf in Spanien nach Preis, Ort und Art (Neubau oder Bestand).
non_resident_taxJährliche IRNR (Modelo 210) eines nicht ansässigen Eigentümers.
Beispielfragen
- Welche Neubauprojekte werden in Torrevieja verkauft, und ab welchem Preis?
- Wie hoch sind Steuern und Gebühren für eine neue Wohnung für 250.000 € in Málaga?
- Vergleiche Orihuela, Torrevieja und Santa Pola: Wohnungspreise, Miete und IBI.
- Ich wohne in Deutschland und besitze eine Wohnung in Spanien mit einem Katasterwert von 80.000 €, vor weniger als zehn Jahren revidiert, nicht vermietet: Wie viel IRNR zahle ich im Jahr?
- Wie hoch ist der IBI-Satz in Benidorm?
So verbinden Sie ihn
Serveradresse und Transport Streamable HTTP (JSON-RPC per POST, ohne Sitzung). Keine Anmeldung nötig: Wählen Sie „keine Authentifizierung“, wenn der Client fragt.
https://flatin.es/mcp
MCP 2025-06-18, 2025-11-25
Claude Code
Im Terminal:
claude mcp add --transport http flatin https://flatin.es/mcp
Claude (claude.ai, Desktop)
Customize → Connectors → Add custom connector, mit dieser URL und ohne Authentifizierung. In den Tarifen Team und Enterprise fügt ein Administrator der Organisation ihn hinzu.
https://flatin.es/mcp
ChatGPT
Entwicklermodus einschalten (Settings → Apps & Connectors → Advanced settings) und einen eigenen MCP-Server mit dieser URL und ohne Authentifizierung hinzufügen. Die Menünamen ändern sich von Version zu Version.
https://flatin.es/mcp
Cursor
In ~/.cursor/mcp.json:
{
"mcpServers": {
"flatin": {
"url": "https://flatin.es/mcp"
}
}
}
VS Code
In .vscode/mcp.json:
{
"servers": {
"flatin": {
"type": "http",
"url": "https://flatin.es/mcp"
}
}
}
Limits
Damit der Dienst kostenlos und schnell bleibt: bis zu 20 Aufrufe pro Minute und 120 pro Stunde von einer Adresse sowie 60 pro Minute und 360 pro Stunde aus einem Netz. Darüber antwortet der Server mit HTTP 429 und der Wartezeit (Retry-After). Projektlisten liefern bis zu 25 pro Aufruf, ohne Seitenweiterschaltung, und ein Netz erhält Listen für höchstens 12 verschiedene Orte pro Stunde; danach die Anzahl und den Link zur Seite. IP-Adressen speichern wir nicht. Jede Anfrage zählt, auch die des Verbindungsaufbaus (initialize, tools/list).
Die Connectoren von Claude (claude.ai) und ChatGPT rufen von den Servern ihrer Plattform aus an, daher teilen sich alle ihre Nutzer diese Limits. Für intensive Nutzung verbinden Sie sich aus Claude Code, Cursor oder VS Code – sie rufen von Ihrer eigenen Adresse aus an.
Nutzungsbedingungen
Antworten dürfen mit einem Link zu flatin.es angezeigt und zitiert werden. Die Angaben zu jedem Projekt stammen vom Bauträger: Nennen Sie ihn und verlinken Sie die Seite von flatin.es. Offene Daten tragen Quelle und Zeitraum: Nennen Sie sie. Steuerberechnungen sind Schätzungen nach den allgemeinen Regeln, keine Steuerberatung. Ein leeres Feld bedeutet „unbekannt“: Füllen Sie es nicht aus. Einzelheiten in den Nutzungsbedingungen; für Agenten auch in llms.txt.
Für Menschen
Wenn Sie eine Immobilie suchen, beginnen Sie mit dem Neubaukatalog oder dem Ratgeber zum Immobilienkauf in Spanien.