FlatHunt

Présentation

FlatHunt recherche des appartements meublés, studios, chambres privées et colocations à Berlin auprès de plusieurs fournisseurs. Vous pouvez filtrer par prix, surface, nombre de pièces, quartier, dates de disponibilité, équipements et conditions de location, consulter le détail des annonces, les comparer côte à côte et afficher les fiches d’annonces dans un widget de galerie.

Le serveur fonctionne comme un endpoint Streamable HTTP hébergé. La recherche, le détail des annonces, la comparaison et le widget ne nécessitent ni compte ni clé API. Pour enregistrer des annonces et gérer des alertes de recherche, vous devez vous identifier avec OAuth.

Ce que vous pouvez faire

• Rechercher des annonces meublées à Berlin avec des filtres de prix, surface, pièces et dates
• Filtrer par quartier ou par coordonnées et rayon
• Obtenir le détail complet d’une annonce
• Comparer de 2 à 10 annonces côte à côte
• Afficher des fiches d’annonces dans une galerie interactive
• Enregistrer des annonces favorites et les gérer (compte requis)
• Créer et supprimer des alertes de recherche (compte requis)

Outils 12

• search_listingsLecture seule

  Rechercher des annonces meublées à Berlin par prix, surface, pièces, zone, dates, équipements et conditions de location.

• get_listingLecture seule

  Obtenir le détail complet d’une annonce à partir de son id numérique.

• compare_listingsLecture seule

  Renvoyer les détails normalisés de 2 à 10 annonces pour une comparaison côte à côte.

• list_citiesLecture seule

  List FlatHunt cities

• list_areasLecture seule

  Lister les arrondissements et quartiers de Berlin avec leurs ids canoniques.

• render_listings_widgetLecture seule

  Renvoyer des fiches d’interface et une galerie pour 1 à 10 annonces.

• list_alertsLecture seule

  Lister les alertes de recherche enregistrées de l’utilisateur connecté.

• create_alertÉcriture

  Créer une alerte de recherche enregistrée pour les nouvelles annonces correspondantes.

• delete_alertPeut supprimer

  Supprimer une ou plusieurs alertes de recherche enregistrées par id.

• list_saved_listingsLecture seule

  Lister les annonces favorites de l’utilisateur connecté.

• save_listingÉcriture

  Enregistrer une annonce dans les favoris de l’utilisateur.

• remove_saved_listingPeut supprimer

  Retirer une annonce des favoris de l’utilisateur.

Lus directement sur le serveur le 12 nov. 2026. Lecture seule, Écriture et Peut supprimer sont des indications déclarées par le serveur ; c’est votre client qui décide de vous demander confirmation avant d’exécuter un outil.

Exemples de prompts

• Trouve-moi un studio meublé à Kreuzberg à moins de 1 200 EUR disponible à partir de décembre

• Compare pour moi les annonces 1234 et 5678

• Quels quartiers de Berlin puis-je utiliser comme filtre ? Montre les ids de Neukölln

• Crée une alerte pour les appartements de 2 pièces à Mitte avec Anmeldung

Configuration

Chaque client se connecte à mcp.flat-hunt.com. Choisissez le vôtre ; la page retient votre choix.

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"
    }
  }
}

Intégrer

Affichez FlatHunt dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise l’URL du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations

La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.

Badge pour README Carte pour site web iframe JSON Prompt pour l’IA

Badge pour README

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>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

HTML

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

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.

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>

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, URL du serveur, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

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

Ce que signifie chaque champ

Prompt pour l’IA

Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de FlatHunt à votre site.

Markdown

Ajoute à mon site la carte mcp.tc de FlatHunt, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.

Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :

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

Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.

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

Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.

Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).

Pour un README ou une autre doc en Markdown, utilise plutôt le badge :

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

Référence : https://mcp.tc/fr/embed

Historique des changements

Nous lisons la liste d’outils de ce serveur toutes les 3 heures et notons ce qui change. Dernière lecture : 12 nov. 2026, 11:36 UTC.

1. 11 nov. 2026, 14:53 UTC, Vérification automatique

   3 outils modifiés.

   Détails, 11 nov. 2026, 14:53 UTC

   Modifiés 3

   • compare_listingsschéma de sortie
   • get_listingschéma de sortie
   • search_listingsschéma de sortie

2. 9 nov. 2026, 11:52 UTC, Vérification automatique

   2 outils modifiés.

   Détails, 9 nov. 2026, 11:52 UTC

   Modifiés 2

   • render_listings_widgetschéma d’entrée et schéma de sortie
   • search_listingsschéma de sortie

3. 9 nov. 2026, 02:51 UTC, Vérification automatique

   1 outil ajouté et 7 outils modifiés. Instructions du serveur modifiées.

   Nouvelles instructions du serveur

   Détails, 9 nov. 2026, 02:51 UTC

   Ajoutés 1

   • list_citiesLecture seule

     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.

   Modifiés 7

   • compare_listingstitre, schéma de sortie et indications

     titre

     Avant

     Compare Berlin listings

     Après

     Compare listings

   • create_alertdescription et schéma d’entrée
     Avant

     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.

     Après

     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.

     • Nouveaux paramètres : city
     • Description de areas
       Avant

       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…

       Après

       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…

     • Description de postCode
       Avant

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

       Après

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

   • get_listingdescription, titre, schéma de sortie et indications
     Avant

     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.

     Après

     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.

     titre

     Avant

     Get Berlin listing details

     Après

     Get listing details

   • list_areasdescription, titre, schéma d’entrée, schéma de sortie et indications
     Avant

     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.

     Après

     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.

     titre

     Avant

     List Berlin districts catalog

     Après

     List districts catalog

     • Nouveaux paramètres : city
   • list_saved_listingsschéma de sortie
   • render_listings_widgetschéma de sortie
   • search_listingsdescription, titre, schéma d’entrée, schéma de sortie et indications
     Avant

     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.

     Après

     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.

     titre

     Avant

     Search Berlin furnished listings

     Après

     Search furnished listings

     • Nouveaux paramètres : city
     • Description de areas
       Avant

       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…

       Après

       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…

     • Description de postCode
       Avant

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

       Après

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

   Instructions du serveur

   Avant

   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)…

   Après

   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, Vérification automatique

   5 outils modifiés.

   Détails, 8 nov. 2026, 17:53 UTC

   Modifiés 5

   • compare_listingsschéma de sortie
   • get_listingschéma de sortie
   • list_saved_listingsschéma de sortie
   • render_listings_widgetschéma de sortie
   • search_listingsschéma de sortie

5. 15 oct. 2026, 16:28 UTC, Vérification automatique

   Début de l’observation : 11 outils.

FAQ