FlatHunt

Über den Server

FlatHunt durchsucht möblierte Wohnungen, Studios, Privatzimmer und WG-Zimmer in Berlin bei mehreren Anbietern. Du kannst nach Preis, Größe, Zimmern, Bezirk, Verfügbarkeitsdaten, Ausstattung und Mietrichtlinien filtern, Details zu Inseraten lesen, Inserate nebeneinander vergleichen und Inseratkarten in einem Galerie-Widget anzeigen.

Der Server läuft als gehosteter Streamable-HTTP-Endpunkt. Suche, Inseratdetails, Vergleich und das Widget brauchen weder Anmeldung noch API-Schlüssel. Zum Speichern von Inseraten und Verwalten von Suchbenachrichtigungen musst du dich per OAuth anmelden.

Was du damit machen kannst

• Möblierte Berliner Inserate mit Filtern für Preis, Größe, Zimmer und Datum durchsuchen
• Filter nach Bezirk oder nach Koordinaten und Radius
• Vollständige Details eines einzelnen Inserats abrufen
• 2 bis 10 Inserate nebeneinander vergleichen
• Inseratkarten in einer interaktiven Galerie darstellen
• Favoriten speichern und verwalten (Anmeldung erforderlich)
• Suchbenachrichtigungen anlegen und löschen (Anmeldung erforderlich)

Tools 12

• search_listingsLiest nur

  Möblierte Berliner Inserate nach Preis, Größe, Zimmern, Gebiet, Datum, Ausstattung und Richtlinien durchsuchen.

• get_listingLiest nur

  Vollständige Details eines Inserats per numerischer ID abrufen.

• compare_listingsLiest nur

  Normalisierte Details zu 2 bis 10 Inseraten für den direkten Vergleich zurückgeben.

• list_citiesLiest nur

  List FlatHunt cities

• list_areasLiest nur

  Berliner Bezirke und Stadtteile mit kanonischen IDs auflisten.

• render_listings_widgetLiest nur

  UI-Karten und eine Galerie für 1 bis 10 Inserate zurückgeben.

• list_alertsLiest nur

  Gespeicherte Suchbenachrichtigungen des angemeldeten Nutzers auflisten.

• create_alertSchreibt

  Gespeicherte Suchbenachrichtigung für neue passende Inserate anlegen.

• delete_alertKann löschen

  Eine oder mehrere gespeicherte Suchbenachrichtigungen per ID löschen.

• list_saved_listingsLiest nur

  Favoriten des angemeldeten Nutzers auflisten.

• save_listingSchreibt

  Ein Inserat in den Favoriten speichern.

• remove_saved_listingKann löschen

  Ein Inserat aus den Favoriten entfernen.

Am 12. Nov. 2026 vom laufenden Server gelesen. „Liest nur“, „Schreibt“ und „Kann löschen“ sind Hinweise, die der Server selbst angibt; dein Client entscheidet, ob er vor dem Ausführen eines Tools nachfragt.

Beispiel-Prompts

• Finde ein möbliertes Studio in Kreuzberg unter 1.200 EUR, verfügbar ab Dezember

• Vergleiche die Inserate 1234 und 5678 für mich

• Nach welchen Berliner Bezirken kann ich filtern? Zeige die Neukölln-IDs

• Richte eine Benachrichtigung für 2-Zimmer-Wohnungen in Mitte mit Anmeldung ein

Einrichtung

Jeder Client verbindet sich mit mcp.flat-hunt.com. Wähl deinen; die Seite merkt sich deine Wahl.

claude mcp add --transport http flathunt https://mcp.flat-hunt.com/mcp

https://mcp.flat-hunt.com/mcp

{
  "mcpServers": {
    "flathunt": {
      "url": "https://mcp.flat-hunt.com/mcp"
    }
  }
}

code --add-mcp '{"name":"flathunt","type":"http","url":"https://mcp.flat-hunt.com/mcp"}'

{
  "servers": {
    "flathunt": {
      "type": "http",
      "url": "https://mcp.flat-hunt.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "flathunt": {
      "serverUrl": "https://mcp.flat-hunt.com/mcp"
    }
  }
}

codex mcp add flathunt --url https://mcp.flat-hunt.com/mcp

[mcp_servers.flathunt]
url = "https://mcp.flat-hunt.com/mcp"

gemini mcp add --transport http flathunt https://mcp.flat-hunt.com/mcp

{
  "mcpServers": {
    "flathunt": {
      "type": "http",
      "url": "https://mcp.flat-hunt.com/mcp"
    }
  }
}

Einbinden

Zeig FlatHunt in einem README oder auf deiner Website. Jede Einbindung verlinkt auf diese Seite, nutzt die eigene URL des Servers und setzt keine Cookies. So funktionieren Einbindungen

Karte, iframe und JSON sind auf Englisch. Häng ?lang=it, fr, de oder es an ihre Adresse an, um eine andere Sprache zu bekommen.

README-Badge Website-Karte iframe JSON KI-Prompt

README-Badge

Markdown

[![FlatHunt on mcp.tc](https://mcp.tc/i/flathunt/badge.svg)](https://mcp.tc/i/flathunt)

HTML

<a href="https://mcp.tc/i/flathunt"><img src="https://mcp.tc/i/flathunt/badge.svg" alt="FlatHunt on mcp.tc" height="20"></a>

Es folgt dem hellen oder dunklen Modus der Lesenden. Hänge ?theme=light oder ?theme=dark an, um ihn festzulegen, oder ?style=compact, um das Zeichen ohne Schriftzug zu zeigen.

Website-Karte

HTML

<script src="https://mcp.tc/w/flathunt.js" async></script>

Die Karte erscheint dort, wo das Tag steht. Füge dem Tag data-theme="dark" oder data-size="compact" hinzu, um sie zu ändern. Die Datei enthält alles, was sie braucht, stellt also keine weiteren Anfragen und setzt keine Cookies.

iframe

HTML

<iframe src="https://mcp.tc/embed/flathunt" title="FlatHunt on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Nutze es auf Seiten, die keine Skripte erlauben. Hänge ?theme=light oder ?theme=dark an die Adresse an, um die Farben festzulegen.

JSON

Der Eintrag als Daten für deine eigenen Seiten und Tools: Name, Kurzbeschreibung, die eigene URL des Servers, Tools und die „Add to“-Links. Jede Website kann ihn lesen (CORS ist offen).

https://mcp.tc/i/flathunt.json

Was jedes Feld bedeutet

KI-Prompt

Füg ihn in einen KI-Coding-Assistenten wie Claude Code oder Cursor ein, und er baut die Karte von FlatHunt in deine Website ein.

Markdown

Füge meiner Website die mcp.tc-Karte für den MCP-Server FlatHunt hinzu. Es ist ein einziges statisches Skript: kein Build-Schritt, kein Paket zu installieren, keine Cookies.

Setz dieses Tag dorthin, wo die Karte erscheinen soll. Die Karte erscheint direkt davor:

```html
<script src="https://mcp.tc/w/flathunt.js" async></script>
```

Um sie woanders zu zeigen, setz dort diesen Platzhalter ein und lade dasselbe Skript nur einmal, zum Beispiel vor `</body>`. Lass den Link darin stehen: Besucher ohne JavaScript sehen ihn.

```html
<div data-mcptc="flathunt"><a href="https://mcp.tc/i/flathunt">FlatHunt on mcp.tc</a></div>
```

Optionen:
- `data-theme="light"` oder `"dark"` am Tag oder Platzhalter legt die Farben fest. Ohne das Attribut folgt die Karte dem hellen oder dunklen Modus der Besucher.
- `data-size="compact"` ergibt eine kleinere Karte ohne Kurzbeschreibung.
- Die CSS-Variable `--mcptc-max-width` am Platzhalter oder einem Elternelement legt die Breite fest (Standard `520px`).
- `?lang=` in der Skript-URL legt die Sprache der Karte fest: `en`, `it`, `fr`, `de` oder `es`.

Wenn die Website eine Content Security Policy hat, erlaube `script-src https://mcp.tc` und `img-src data:` (das Icon ist eingebettet).

Für ein README oder andere Markdown-Dokumentation nimm stattdessen das Badge:

```markdown
[![FlatHunt on mcp.tc](https://mcp.tc/i/flathunt/badge.svg)](https://mcp.tc/i/flathunt)
```

Referenz: https://mcp.tc/de/embed

Änderungsverlauf

Wir lesen die Tool-Liste dieses Servers alle 3 Stunden und halten fest, was sich ändert. Zuletzt gelesen: 12. Nov. 2026, 11:36 UTC.

1. 11. Nov. 2026, 14:53 UTC, Automatische Prüfung

   3 Tools geändert.

   Details, 11. Nov. 2026, 14:53 UTC

   Geändert 3

   • compare_listingsAusgabeschema
   • get_listingAusgabeschema
   • search_listingsAusgabeschema

2. 9. Nov. 2026, 11:52 UTC, Automatische Prüfung

   2 Tools geändert.

   Details, 9. Nov. 2026, 11:52 UTC

   Geändert 2

   • render_listings_widgetEingabeschema und Ausgabeschema
   • search_listingsAusgabeschema

3. 9. Nov. 2026, 02:51 UTC, Automatische Prüfung

   1 Tool hinzugefügt und 7 Tools geändert. Server-Anweisungen geändert.

   Neue Server-Anweisungen

   Details, 9. Nov. 2026, 02:51 UTC

   Hinzugefügt 1

   • list_citiesLiest nur

     List the cities FlatHunt covers (Berlin plus European university cities) with the canonical `city` id to pass to search_listings and create_alert, country, currency, how many listings are live, and whether district polygons (list_areas) exist for it. Berlin is the default city: omit `city` for Berlin. Call this when the user names any other city, or asks where FlatHunt works.

   Geändert 7

   • compare_listingsTitel, Ausgabeschema und Hinweise

     Titel

     Vorher

     Compare Berlin listings

     Nachher

     Compare listings

   • create_alertBeschreibung und Eingabeschema
     Vorher

     Create a saved search alert so FlatHunt notifies the user about new matching Berlin listings. Accepts housing, price, size, rooms, availability, canonical area ids, amenity and rental-policy filters. Email notifications are enabled by default; Telegram too when the user has linked Telegram on FlatHunt. Requires the alerts.write scope.

     Nachher

     Create a saved search alert so FlatHunt notifies the user about new matching listings in the chosen city (Berlin unless `city` is set). Accepts housing, price, size, rooms, availability, canonical area ids, amenity and rental-policy filters. Email notifications are enabled by default; Telegram too when the user has linked Telegram on FlatHunt. Requires the alerts.write scope.

     • Neue Parameter: city
     • Beschreibung von areas
       Vorher

       Canonical Berlin area IDs from list_areas (e.g. berlin:ortsteil:prenzlauer-berg). Up to 20 IDs; multiple IDs are combined with OR. District / Ortsteil mode — do not mix with lat/lng/radiusKm. When th…

       Nachher

       Canonical area IDs from list_areas (Berlin only, e.g. berlin:ortsteil:prenzlauer-berg). Up to 20 IDs; multiple IDs are combined with OR. District / Ortsteil mode — do not mix with lat/lng/radiusKm. W…

     • Beschreibung von postCode
       Vorher

       Exact Berlin post code (PLZ), e.g. 10115.

       Nachher

       Exact post code in the searched city, e.g. 10115 (Berlin).

   • get_listingBeschreibung, Titel, Ausgabeschema und Hinweise
     Vorher

     Get detailed information about a single FlatHunt listing in Berlin by its numeric id. Returns its description, amenities, rental-policy flags, capacity, stay terms, utilities, nearby distances, media, provider and tracking URLs. Availability and provider terms may change.

     Nachher

     Get detailed information about a single FlatHunt listing by its numeric id (any city). Returns its description, amenities, rental-policy flags, capacity, stay terms, utilities, nearby distances, media, provider and tracking URLs. Availability and provider terms may change.

     Titel

     Vorher

     Get Berlin listing details

     Nachher

     Get listing details

   • list_areasBeschreibung, Titel, Eingabeschema, Ausgabeschema und Hinweise
     Vorher

     List supported Berlin districts (Bezirke) and neighbourhoods (Ortsteile) with canonical FlatHunt ids. Returns id, name, slug, type and parent area information, with optional name and type filtering. Mitte exists both as a whole Bezirk (berlin:bezirk:mitte) and as a smaller Ortsteil (berlin:ortsteil:mitte). Charlottenburg is an Ortsteil; the parent Bezirk is Charlottenburg-Wilmersdorf.

     Nachher

     List district polygons (Berlin: Bezirke and Ortsteile) with canonical FlatHunt ids for the `areas` filter. District catalogs exist only for cities where list_cities reports hasAreas (today: Berlin, the default). For other cities search by city, post code or lat/lng/radiusKm. Returns id, name, slug, type and parent area information, with optional name and type filtering. Mitte exists both as a whole Bezirk (berlin:bezirk:mitte) and as a smaller Ortsteil (berlin:ortsteil:mitte). Charlottenburg is an Ortsteil; the parent Bezirk is Charlottenburg-Wilmersdorf.

     Titel

     Vorher

     List Berlin districts catalog

     Nachher

     List districts catalog

     • Neue Parameter: city
   • list_saved_listingsAusgabeschema
   • render_listings_widgetAusgabeschema
   • search_listingsBeschreibung, Titel, Eingabeschema, Ausgabeschema und Hinweise
     Vorher

     Search current furnished apartments, studios, private rooms and shared rooms in Berlin through FlatHunt. Supports price, size, rooms, bedrooms, canonical area ids or nearby coordinates, availability dates, capacity, deposit, providers, amenity tags, rental-policy flags, sorting and pagination up to 20 results. Returns normalized listing summaries and pagination metadata. Availability, prices and provider terms may change.

     Nachher

     Search current furnished apartments, studios, private rooms and shared rooms through FlatHunt in Berlin (default) or any city from list_cities via `city`. Supports price, size, rooms, bedrooms, canonical area ids (Berlin) or nearby coordinates, availability dates, capacity, deposit, providers, amenity tags, rental-policy flags, sorting and pagination up to 20 results. Returns normalized listing summaries and pagination metadata. Availability, prices and provider terms may change.

     Titel

     Vorher

     Search Berlin furnished listings

     Nachher

     Search furnished listings

     • Neue Parameter: city
     • Beschreibung von areas
       Vorher

       Canonical Berlin area IDs from list_areas (e.g. berlin:ortsteil:prenzlauer-berg). Up to 20 IDs; multiple IDs are combined with OR. District / Ortsteil mode — do not mix with lat/lng/radiusKm. When th…

       Nachher

       Canonical area IDs from list_areas (Berlin only, e.g. berlin:ortsteil:prenzlauer-berg). Up to 20 IDs; multiple IDs are combined with OR. District / Ortsteil mode — do not mix with lat/lng/radiusKm. W…

     • Beschreibung von postCode
       Vorher

       Exact Berlin post code (PLZ), e.g. 10115.

       Nachher

       Exact post code in the searched city, e.g. 10115 (Berlin).

   Server-Anweisungen

   Vorher

   You are FlatHunt's Berlin housing co-pilot: a sharp, warm, decisive friend who helps people actually find and rent furnished apartments, studios, private rooms, and shared rooms in Berlin. Guide the user from a vague need to a verified shortlist and an informed next step. Do not dump listings or let a provider link substitute for explaining a recommendation. Search, get_listing, compare, and the listings widget work without login. Save listing and create_alert require the user to be signed in (OAuth). Tone: expert friend who knows Berlin housing. Be specific, opinionated when helpful, never vague. Match the user's language. Keep replies scannable (short paragraphs, bullets for options). Celebrate good finds briefly; never hype a weak match. Never sound helpless or bureaucratic. Personalization (use conversation history + tools, never invent preferences): - Remember and reuse stated constraints: budget, rooms, move-in date, must-have amenities, commute goals, vibe (quiet / nightlife / family / students), and areas already discussed. - When authenticated, call list_saved_listings and list_alerts early if relevant — use them as taste signals; reference them naturally. - If preferences conflict with inventory, say so and propose the best trade-offs (budget bump, adjacent Ortsteil, later availableFrom). - Ask at most 1–3 clarifying questions when a search would be guesswork. Prefer searching with sensible defaults over interrogation. Filters and soft criteria: - One precise search_listings with backend filters ≫ paging then hand-filtering. Put every hard constraint in that one call (limit max 20). Paginate only when meta.totalPages > 1 and the user asks for more — never page to drop small flats or wrong districts. - Structured filters: priceMin/priceMax, squareMetersMin/squareMetersMax, rooms[] (exact OR) or roomsMin/roomsMax, bedroomsMin, areas (list_areas ids — district polygons) OR lat+lng+radiusKm (nearby; never mix geo modes), availableFrom/availableTo (YYYY-MM-DD)…

   Nachher

   You are FlatHunt's housing co-pilot: a sharp, warm, decisive friend who helps people actually find and rent furnished apartments, studios, private rooms, and shared rooms in Berlin (the default city) and in the other European cities FlatHunt covers (list_cities: Lisbon, Porto, Madrid, Barcelona, Milan, Rome, Paris, Vienna … mostly Uniplaces student housing there). Guide the user from a vague need to a verified shortlist and an informed next step. Do not dump listings or let a provider link substitute for explaining a recommendation. Search, get_listing, compare, and the listings widget work without login. Save listing and create_alert require the user to be signed in (OAuth). Tone: expert friend who knows the local housing market. Be specific, opinionated when helpful, never vague. Match the user's language. Keep replies scannable (short paragraphs, bullets for options). Celebrate good finds briefly; never hype a weak match. Never sound helpless or bureaucratic. Personalization (use conversation history + tools, never invent preferences): - Remember and reuse stated constraints: budget, rooms, move-in date, must-have amenities, commute goals, vibe (quiet / nightlife / family / students), and areas already discussed. - When authenticated, call list_saved_listings and list_alerts early if relevant — use them as taste signals; reference them naturally. - If preferences conflict with inventory, say so and propose the best trade-offs (budget bump, adjacent Ortsteil, later availableFrom). - Ask at most 1–3 clarifying questions when a search would be guesswork. Prefer searching with sensible defaults over interrogation. Filters and soft criteria: - One precise search_listings with backend filters ≫ paging then hand-filtering. Put every hard constraint in that one call (limit max 20). Paginate only when meta.totalPages > 1 and the user asks for more — never page to drop small flats or wrong districts. - Structured filters: priceMin/priceMax, squareMetersMin/squareMetersMax…

4. 8. Nov. 2026, 17:53 UTC, Automatische Prüfung

   5 Tools geändert.

   Details, 8. Nov. 2026, 17:53 UTC

   Geändert 5

   • compare_listingsAusgabeschema
   • get_listingAusgabeschema
   • list_saved_listingsAusgabeschema
   • render_listings_widgetAusgabeschema
   • search_listingsAusgabeschema

5. 15. Okt. 2026, 16:28 UTC, Automatische Prüfung

   Beginn der Beobachtung: 11 Tools.

Häufige Fragen