FlatHunt

Descrizione

FlatHunt cerca appartamenti arredati, monolocali, stanze private e stanze condivise a Berlino presso diversi fornitori. Puoi filtrare per prezzo, superficie, numero di stanze, quartiere, date di disponibilità, servizi e indicatori delle condizioni di affitto, leggere i dettagli degli annunci, confrontarli affiancati e mostrare le schede degli annunci in un widget a galleria.

Il server funziona come endpoint Streamable HTTP ospitato. Ricerca, dettagli degli annunci, confronto e widget non richiedono accesso né chiave API. Per salvare gli annunci e gestire gli avvisi di ricerca serve accedere con OAuth.

Cosa puoi fare

• Cercare annunci arredati a Berlino con filtri per prezzo, superficie, stanze e date
• Filtrare per quartiere o per coordinate e raggio
• Ottenere tutti i dettagli di un singolo annuncio
• Confrontare da 2 a 10 annunci affiancati
• Mostrare le schede degli annunci in una galleria interattiva
• Salvare gli annunci preferiti e gestirli (richiede l’accesso)
• Creare ed eliminare avvisi di ricerca (richiede l’accesso)

Tool 12

• search_listingsSola lettura

  Cerca annunci arredati a Berlino per prezzo, superficie, stanze, zona, date, servizi e indicatori delle condizioni.

• get_listingSola lettura

  Ottiene tutti i dettagli di un annuncio tramite id numerico.

• compare_listingsSola lettura

  Restituisce dettagli normalizzati di 2-10 annunci per il confronto affiancato.

• list_citiesSola lettura

  List FlatHunt cities

• list_areasSola lettura

  Elenca i distretti e i quartieri di Berlino con gli id canonici.

• render_listings_widgetSola lettura

  Restituisce schede UI e una galleria per 1-10 annunci.

• list_alertsSola lettura

  Elenca gli avvisi di ricerca salvati dell’utente che ha effettuato l’accesso.

• create_alertScrive

  Crea un avviso di ricerca salvato per i nuovi annunci corrispondenti.

• delete_alertPuò eliminare

  Elimina uno o più avvisi di ricerca salvati tramite id.

• list_saved_listingsSola lettura

  Elenca gli annunci preferiti dell’utente che ha effettuato l’accesso.

• save_listingScrive

  Salva un annuncio nei preferiti dell’utente.

• remove_saved_listingPuò eliminare

  Rimuove un annuncio dai preferiti dell’utente.

Letti dal server attivo (12 nov 2026). Sola lettura, Scrive e Può eliminare sono indicazioni dichiarate dal server; è il tuo client a decidere se chiederti conferma prima di eseguire un tool.

Prompt di esempio

• Trova un monolocale arredato a Kreuzberg sotto i 1.200 EUR disponibile da dicembre

• Confrontami gli annunci 1234 e 5678

• Per quali quartieri di Berlino posso filtrare? Mostrami gli id di Neukölln

• Imposta un avviso per appartamenti di 2 stanze a Mitte con Anmeldung

Configurazione

Ogni client si collega a mcp.flat-hunt.com. Scegli il tuo; la pagina ricorda la tua scelta.

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

Embed

Mostra FlatHunt in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa l’URL del server stesso e non imposta cookie. Come funzionano gli embed

Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.

Badge per il README Card per il sito iframe JSON Prompt per l’AI

Badge per il 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>

Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.

Card per il sito

HTML

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

La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta 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>

Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.

JSON

La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, URL del server, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).

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

Cosa significa ogni campo

Prompt per l’AI

Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di FlatHunt al tuo sito.

Markdown

Aggiungi al mio sito la card di mcp.tc per FlatHunt, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.

Metti questo tag dove deve comparire la card. La card appare subito prima del tag:

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

Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.

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

Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.

Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).

Per un README o altra documentazione in Markdown, usa invece il badge:

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

Riferimento: https://mcp.tc/it/embed

Cronologia delle modifiche

Leggiamo l’elenco dei tool di questo server ogni 3 ore e registriamo cosa cambia. Ultima lettura: 12 nov 2026, 11:36 UTC.

1. 11 nov 2026, 14:53 UTC, Controllo automatico

   3 tool modificati.

   Dettagli, 11 nov 2026, 14:53 UTC

   Modificati 3

   • compare_listingsschema di output
   • get_listingschema di output
   • search_listingsschema di output

2. 9 nov 2026, 11:52 UTC, Controllo automatico

   2 tool modificati.

   Dettagli, 9 nov 2026, 11:52 UTC

   Modificati 2

   • render_listings_widgetschema di input e schema di output
   • search_listingsschema di output

3. 9 nov 2026, 02:51 UTC, Controllo automatico

   1 tool aggiunto e 7 tool modificati. Istruzioni del server modificate.

   Nuove istruzioni del server

   Dettagli, 9 nov 2026, 02:51 UTC

   Aggiunti 1

   • list_citiesSola lettura

     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.

   Modificati 7

   • compare_listingstitolo, schema di output e indicazioni

     titolo

     Prima

     Compare Berlin listings

     Dopo

     Compare listings

   • create_alertdescrizione e schema di input
     Prima

     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.

     Dopo

     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.

     • Nuovi parametri: city
     • Descrizione di areas
       Prima

       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…

       Dopo

       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…

     • Descrizione di postCode
       Prima

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

       Dopo

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

   • get_listingdescrizione, titolo, schema di output e indicazioni
     Prima

     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.

     Dopo

     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.

     titolo

     Prima

     Get Berlin listing details

     Dopo

     Get listing details

   • list_areasdescrizione, titolo, schema di input, schema di output e indicazioni
     Prima

     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.

     Dopo

     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.

     titolo

     Prima

     List Berlin districts catalog

     Dopo

     List districts catalog

     • Nuovi parametri: city
   • list_saved_listingsschema di output
   • render_listings_widgetschema di output
   • search_listingsdescrizione, titolo, schema di input, schema di output e indicazioni
     Prima

     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.

     Dopo

     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.

     titolo

     Prima

     Search Berlin furnished listings

     Dopo

     Search furnished listings

     • Nuovi parametri: city
     • Descrizione di areas
       Prima

       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…

       Dopo

       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…

     • Descrizione di postCode
       Prima

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

       Dopo

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

   Istruzioni del server

   Prima

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

   Dopo

   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, Controllo automatico

   5 tool modificati.

   Dettagli, 8 nov 2026, 17:53 UTC

   Modificati 5

   • compare_listingsschema di output
   • get_listingschema di output
   • list_saved_listingsschema di output
   • render_listings_widgetschema di output
   • search_listingsschema di output

5. 15 ott 2026, 16:28 UTC, Controllo automatico

   Inizio del tracciamento: 11 tool.

Domande frequenti