FlatHunt
Search furnished Berlin housing, compare listings, and manage favorites and saved-search alerts.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~9,607Tokens (Tool-Definitionen)
~9.6 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (7.51% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.flat-hunt.com/mcp"
}
}
}Remote-Endpunkte
https://mcp.flat-hunt.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (11)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢search_listings(housingType, roomType, priceMin, priceMax, rooms, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"housingType": {
"description": "Type of housing. Studios map to apartment; room includes both private and shared rooms unless roomType narrows it.",
"type": "string",
"enum": [
"room",
"apartment"
]
},
"roomType": {
"description": "Room occupancy: private = one private bedroom in shared housing; shared = a bed in a shared bedroom. Omit to include both. housingType=room remains the broad backwards-compatible filter.",
"type": "string",
"enum": [
"private",
"shared"
]
},
"priceMin": {
"description": "Minimum monthly price in EUR.",
"type": "number",
"minimum": 0
},
"priceMax": {
"description": "Maximum monthly price in EUR.",
"type": "number",
"minimum": 0
},
"rooms": {
"description": "Exact room counts (OR). Allowed values only: \"studio\", \"1\", \"2\", …, \"10\" (strings, not numbers). Prefer over roomsMin/roomsMax for \"1–2 rooms\": [\"1\",\"2\"] or [\"studio\",\"1\"].",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"studio"
]
}
},
"roomsMin": {
"description": "Minimum rooms (studio = 0). Prefer rooms[] for exact OR lists.",
"type": "number",
"minimum": 0
},
"roomsMax": {
"description": "Maximum rooms. Prefer rooms[] for exact OR lists.",
"type": "number",
"minimum": 0
},
"providers": {
"description": "Restrict to specific housing providers (ids from the providers catalog).",
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
}
},
"areas": {
"description": "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 the user names an area, call list_areas first. Pass only canonical IDs returned by list_areas. Never construct, translate, normalize, or guess IDs.",
"maxItems": 20,
"type": "array",
"items": {
"type": "string"
}
},
"postCode": {
"description": "Exact Berlin post code (PLZ), e.g. 10115.",
"type": "string"
},
"lat": {
"description": "Latitude for nearby search; must be provided with lng (+ radiusKm). Do not mix with areas.",
"type": "number"
},
"lng": {
"description": "Longitude for nearby search; must be provided with lat (+ radiusKm). Do not mix with areas.",
"type": "number"
},
"radiusKm": {
"description": "Search radius in km around lat/lng (min 0.1, max 25). Nearby mode — do not mix with areas.",
"type": "number",
"minimum": 0.1,
"maximum": 25
},
"bedroomsMin": {
"description": "Minimum number of bedrooms (from provider extra data when available).",
"type": "number",
"minimum": 0
},
"squareMetersMin": {
"description": "Minimum living area in m². \"from 40 m²\" → 40. Filter on the backend — do not paginate to drop small listings.",
"type": "number",
"minimum": 0
},
"squareMetersMax": {
"description": "Maximum living area in m².",
"type": "number",
"minimum": 0
},
"availableFrom": {
"description": "Available from / not earlier than (YYYY-MM-DD), e.g. \"2026-08-01\".",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"availableTo": {
"description": "Available until / not later than (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"personsMaxMin": {
"description": "Minimum capacity (personsMax). Use 2 for couples, 1 for solo — filters listings that can accommodate at least this many people.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"depositMax": {
"description": "Maximum deposit (Kaution) in EUR.",
"type": "number",
"minimum": 0
},
"amenityTags": {
"description": "Canonical amenity tags (AND). Backend filters listings that have ALL of these tags. Catalog (snake_case only): wifi, parking, bike_parking, wheelchair, dishwasher, washing_machine, dryer, elevator, balcony, desk, tv, oven, heating, furnished, fridge, microwave, cooktop, coffee_machine, iron, hair_dryer, closet, wardrobe, bed, bathtub, shower, garden, basement, air_conditioning, parking_street, workspace, fitness, concierge, laundry, pets_friendly. Do not invent aliases (wiFi, hasWifi, Waschmaschine).",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"petsAllowed": {
"description": "true = pets explicitly allowed.",
"type": "boolean"
},
"smokingAllowed": {
"description": "false = non-smokers only / smoking not allowed.",
"type": "boolean"
},
"registrationPossible": {
"description": "true = Anmeldung / registration explicitly possible (strict).",
"type": "boolean"
},
"anmeldungLikely": {
"description": "true = Anmeldung likely (broader). Prefer for \"with Anmeldung\" unless the user needs a hard guarantee.",
"type": "boolean"
},
"schufaRequired": {
"description": "true = Schufa required.",
"type": "boolean"
},
"noSchufaRequired": {
"description": "true = Schufa explicitly not required (strict).",
"type": "boolean"
},
"noSchufaLikely": {
"description": "true = Schufa likely not required (broader). Prefer for \"without Schufa\".",
"type": "boolean"
},
"studentsFriendly": {
"description": "true = student-oriented housing (broader).",
"type": "boolean"
},
"onlyStudentsAllowed": {
"description": "true = students-only listings.",
"type": "boolean"
},
"sortBy": {
"description": "Sort field (default rank). sortOrder is ignored when sortBy=rank. Cheaper first → price+asc; larger area → squareMeters+desc.",
"type": "string",
"enum": [
"rank",
"price",
"squareMeters",
"createdAt",
"availableFrom"
]
},
"sortOrder": {
"description": "Sort direction (default desc). Ignored when sortBy=rank.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page (default 10, max 20).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 20
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"title": {
"type": "string"
},
"price": {
"type": "number"
},
"priceFormatted": {
"type": "string"
},
"rooms": {
"type": [
"number",
"string"
]
},
"housingType": {
"type": "string"
},
"roomType": {
"type": "string",
"enum": [
"private",
"shared"
]
},
"location": {
"type": "string"
},
"area": {
"type": "string"
},
"areaSquareMeters": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"provider": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"logoUrl": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"availableFrom": {
"type": "string"
},
"availableTo": {
"type": "string"
},
"detailsUrl": {
"type": "string"
},
"trackingUrl": {
"type": "string"
},
"deposit": {
"type": "number"
},
"depositFormatted": {
"type": "string"
},
"noDeposit": {
"type": "boolean"
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"alt": {
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"amenityTags": {
"type": "array",
"items": {
"type": "string"
}
},
"amenitiesUnknown": {
"type": "array",
"items": {
"type": "string"
}
},
"buildingAmenityTags": {
"type": "array",
"items": {
"type": "string"
}
},
"buildingAmenitiesUnknown": {
"type": "array",
"items": {
"type": "string"
}
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"petsAllowed": {
"type": "boolean"
},
"smokingAllowed": {
"type": "boolean"
},
"registrationPossible": {
"type": "boolean"
},
"anmeldungLikely": {
"type": "boolean"
},
"schufaRequired": {
"type": "boolean"
},
"noSchufaRequired": {
"type": "boolean"
},
"noSchufaLikely": {
"type": "boolean"
},
"studentsFriendly": {
"type": "boolean"
},
"onlyStudentsAllowed": {
"type": "boolean"
},
"couplesAllowed": {
"type": "boolean"
},
"childrenAllowed": {
"type": "boolean"
},
"partyAllowed": {
"type": "boolean"
},
"guarantorRequired": {
"type": "boolean"
},
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"personsMax": {
"type": "number"
},
"minStayMonths": {
"type": "number"
},
"maxStayMonths": {
"type": "number"
},
"furnished": {
"type": "string"
},
"postCode": {
"type": "string"
},
"propertySubtype": {
"type": "string"
},
"floor": {
"type": "string"
},
"minAge": {
"type": "number"
},
"maxAge": {
"type": "number"
},
"preferredGender": {
"type": "string"
}
},
"required": [
"id",
"title"
],
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"total": {
"type": "number"
},
"totalPages": {
"type": "number"
}
},
"required": [
"page",
"limit",
"total",
"totalPages"
],
"additionalProperties": false
}
},
"required": [
"listings",
"pagination"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_listing(listingId)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"listingId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric FlatHunt listing id."
}
},
"required": [
"listingId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"listing": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"title": {
"type": "string"
},
"price": {
"type": "number"
},
"priceFormatted": {
"type": "string"
},
"rooms": {
"type": [
"number",
"string"
]
},
"housingType": {
"type": "string"
},
"roomType": {
"type": "string",
"enum": [
"private",
"shared"
]
},
"location": {
"type": "string"
},
"area": {
"type": "string"
},
"areaSquareMeters": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"provider": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"logoUrl": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"availableFrom": {
"type": "string"
},
"availableTo": {
"type": "string"
},
"detailsUrl": {
"type": "string"
},
"trackingUrl": {
"type": "string"
},
"deposit": {
"type": "number"
},
"depositFormatted": {
"type": "string"
},
"noDeposit": {
"type": "boolean"
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"alt": {
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"amenityTags": {
"type": "array",
"items": {
"type": "string"
}
},
"amenitiesUnknown": {
"type": "array",
"items": {
"type": "string"
}
},
"buildingAmenityTags": {
"type": "array",
"items": {
"type": "string"
}
},
"buildingAmenitiesUnknown": {
"type": "array",
"items": {
"type": "string"
}
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"petsAllowed": {
"type": "boolean"
},
"smokingAllowed": {
"type": "boolean"
},
"registrationPossible": {
"type": "boolean"
},
"anmeldungLikely": {
"type": "boolean"
},
"schufaRequired": {
"type": "boolean"
},
"noSchufaRequired": {
"type": "boolean"
},
"noSchufaLikely": {
"type": "boolean"
},
"studentsFriendly": {
"type": "boolean"
},
"onlyStudentsAllowed": {
"type": "boolean"
},
"couplesAllowed": {
"type": "boolean"
},
"childrenAllowed": {
"type": "boolean"
},
"partyAllowed": {
"type": "boolean"
},
"guarantorRequired": {
"type": "boolean"
},
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"personsMax": {
"type": "number"
},
"minStayMonths": {
"type": "number"
},
"maxStayMonths": {
"type": "number"
},
"furnished": {
"type": "string"
},
"postCode": {
"type": "string"
},
"propertySubtype": {
"type": "string"
},
"floor": {
"type": "string"
},
"minAge": {
"type": "number"
},
"maxAge": {
"type": "number"
},
"preferredGender": {
"type": "string"
},
"description": {
"type": "string"
},
"address": {
"type": "string"
},
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"utilitiesIncluded": {
"type": "array",
"items": {
"type": "string"
}
},
"utilitiesCost": {
"type": "number"
},
"nearbyDistances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"place": {
"type": "string"
},
"distance": {
"type": "string"
}
},
"required": [
"place",
"distance"
],
"additionalProperties": false
}
},
"virtualTourUrl": {
"type": "string"
},
"saved": {
"type": "boolean"
}
},
"required": [
"id",
"title"
],
"additionalProperties": false
}
},
"required": [
"listing"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢compare_listings(listingIds)
Return normalized detail fields for 2–10 FlatHunt listings by numeric id in one read-only response. Includes prices, location, amenities, rental-policy flags, capacity, description, utilities, nearby distances, provider and tracking URLs for side-by-side comparison.
Eingabe-Schema
{
"type": "object",
"properties": {
"listingIds": {
"minItems": 2,
"maxItems": 10,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Between 2 and 10 unique listing ids."
}
},
"required": [
"listingIds"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"title": {
"type": "string"
},
"price": {
"type": "number"
},
"priceFormatted": {
"type": "string"
},
"rooms": {
"type": [
"number",
"string"
]
},
"housingType": {
"type": "string"
},
"roomType": {
"type": "string",
"enum": [
"private",
"shared"
]
},
"location": {
"type": "string"
},
"area": {
"type": "string"
},
"areaSquareMeters": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"provider": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"logoUrl": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"availableFrom": {
"type": "string"
},
"availableTo": {
"type": "string"
},
"detailsUrl": {
"type": "string"
},
"trackingUrl": {
"type": "string"
},
"deposit": {
"type": "number"
},
"depositFormatted": {
"type": "string"
},
"noDeposit": {
"type": "boolean"
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"alt": {
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"amenityTags": {
"type": "array",
"items": {
"type": "string"
}
},
"amenitiesUnknown": {
"type": "array",
"items": {
"type": "string"
}
},
"buildingAmenityTags": {
"type": "array",
"items": {
"type": "string"
}
},
"buildingAmenitiesUnknown": {
"type": "array",
"items": {
"type": "string"
}
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"petsAllowed": {
"type": "boolean"
},
"smokingAllowed": {
"type": "boolean"
},
"registrationPossible": {
"type": "boolean"
},
"anmeldungLikely": {
"type": "boolean"
},
"schufaRequired": {
"type": "boolean"
},
"noSchufaRequired": {
"type": "boolean"
},
"noSchufaLikely": {
"type": "boolean"
},
"studentsFriendly": {
"type": "boolean"
},
"onlyStudentsAllowed": {
"type": "boolean"
},
"couplesAllowed": {
"type": "boolean"
},
"childrenAllowed": {
"type": "boolean"
},
"partyAllowed": {
"type": "boolean"
},
"guarantorRequired": {
"type": "boolean"
},
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"personsMax": {
"type": "number"
},
"minStayMonths": {
"type": "number"
},
"maxStayMonths": {
"type": "number"
},
"furnished": {
"type": "string"
},
"postCode": {
"type": "string"
},
"propertySubtype": {
"type": "string"
},
"floor": {
"type": "string"
},
"minAge": {
"type": "number"
},
"maxAge": {
"type": "number"
},
"preferredGender": {
"type": "string"
},
"description": {
"type": "string"
},
"address": {
"type": "string"
},
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"utilitiesIncluded": {
"type": "array",
"items": {
"type": "string"
}
},
"utilitiesCost": {
"type": "number"
},
"nearbyDistances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"place": {
"type": "string"
},
"distance": {
"type": "string"
}
},
"required": [
"place",
"distance"
],
"additionalProperties": false
}
},
"virtualTourUrl": {
"type": "string"
},
"saved": {
"type": "boolean"
}
},
"required": [
"id",
"title"
],
"additionalProperties": false
}
}
},
"required": [
"listings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_areas(query, type)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"description": "Optional case-insensitive substring filter on area name or slug. Omit to return the full catalog (109 areas).",
"type": "string"
},
"type": {
"description": "Optional filter by area type.",
"type": "string",
"enum": [
"bezirk",
"ortsteil"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"areas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"bezirk",
"ortsteil"
]
},
"parentAreaId": {
"type": [
"string",
"null"
]
},
"parentName": {
"type": "string"
}
},
"required": [
"id",
"name",
"slug",
"type"
],
"additionalProperties": false
}
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"catalogVersion": {
"type": "string"
}
},
"required": [
"areas",
"total",
"catalogVersion"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢render_listings_widget(listingIds, alertCriteria)
Return UI-ready cards and an interactive MCP Apps gallery for 1–10 FlatHunt listing ids. The tool refreshes current listing data and displays images, provider, price, availability and listing actions. Optional alertCriteria adds a saved-search control for the represented filters.
Eingabe-Schema
{
"type": "object",
"properties": {
"listingIds": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Between 1 and 10 unique FlatHunt listing ids."
},
"alertCriteria": {
"description": "Optional saved-search criteria represented by this result set. Every nested field is optional. Pagination and sort fields are not accepted.",
"type": "object",
"properties": {
"name": {
"description": "Optional. Short saved-search label in the user's language so Save search uses a meaningful name (not a generic default).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"housingType": {
"description": "Optional. Same housingType as the preceding search_listings call.",
"type": "string",
"enum": [
"room",
"apartment"
]
},
"roomType": {
"description": "Optional. Same roomType as the preceding search_listings call.",
"type": "string",
"enum": [
"private",
"shared"
]
},
"priceMin": {
"description": "Optional. Minimum monthly price in EUR from the search.",
"type": "number",
"minimum": 0
},
"priceMax": {
"description": "Optional. Maximum monthly price in EUR from the search.",
"type": "number",
"minimum": 0
},
"rooms": {
"description": "Optional. Exact room counts from the search. Allowed: \"studio\", \"1\"…\"10\" (strings only).",
"type": "array",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"studio"
]
}
},
"roomsMin": {
"description": "Optional. Minimum rooms from the search (studio = 0).",
"type": "number",
"minimum": 0
},
"roomsMax": {
"description": "Optional. Maximum rooms from the search.",
"type": "number",
"minimum": 0
},
"providers": {
"description": "Optional. Provider ids from the search.",
"type": "array",
"items": {
"type": "string"
}
},
"areas": {
"description": "Optional. Canonical area ids from list_areas used in the search.",
"type": "array",
"items": {
"type": "string"
}
},
"postCode": {
"description": "Optional. Exact Berlin PLZ from the search.",
"type": "string"
},
"lat": {
"description": "Optional. Nearby-search latitude (with lng).",
"type": "number"
},
"lng": {
"description": "Optional. Nearby-search longitude (with lat).",
"type": "number"
},
"radiusKm": {
"description": "Optional. Nearby-search radius in km.",
"type": "number",
"exclusiveMinimum": 0
},
"bedroomsMin": {
"description": "Optional. Minimum bedrooms from the search.",
"type": "number",
"minimum": 0
},
"squareMetersMin": {
"description": "Optional. Minimum living area m² from the search.",
"type": "number",
"minimum": 0
},
"squareMetersMax": {
"description": "Optional. Maximum living area m² from the search.",
"type": "number",
"minimum": 0
},
"availableFrom": {
"description": "Optional. Available-from date (YYYY-MM-DD) from the search.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"availableTo": {
"description": "Optional. Available-to date (YYYY-MM-DD) from the search.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"personsMaxMin": {
"description": "Optional. Minimum capacity from the search.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"depositMax": {
"description": "Optional. Maximum deposit EUR from the search.",
"type": "number",
"minimum": 0
},
"amenityTags": {
"description": "Optional. Canonical amenity tags (AND) from the search, e.g. wifi, parking, washing_machine.",
"type": "array",
"items": {
"type": "string"
}
},
"petsAllowed": {
"description": "Optional. Pets filter from the search.",
"type": "boolean"
},
"smokingAllowed": {
"description": "Optional. Smoking filter from the search.",
"type": "boolean"
},
"registrationPossible": {
"description": "Optional. Anmeldung/registration filter from the search.",
"type": "boolean"
},
"anmeldungLikely": {
"description": "Optional. Anmeldung-likely filter from the search.",
"type": "boolean"
},
"schufaRequired": {
"description": "Optional. Schufa-required filter from the search.",
"type": "boolean"
},
"noSchufaRequired": {
"description": "Optional. No-Schufa-required filter from the search.",
"type": "boolean"
},
"noSchufaLikely": {
"description": "Optional. No-Schufa-likely filter from the search.",
"type": "boolean"
},
"studentsFriendly": {
"description": "Optional. Students-friendly filter from the search.",
"type": "boolean"
},
"onlyStudentsAllowed": {
"description": "Optional. Students-only filter from the search.",
"type": "boolean"
}
}
}
},
"required": [
"listingIds"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"available": {
"type": "boolean"
},
"title": {
"type": "string"
},
"price": {
"type": "number"
},
"priceFormatted": {
"type": "string"
},
"housingType": {
"type": "string"
},
"roomType": {
"type": "string",
"enum": [
"private",
"shared"
]
},
"rooms": {
"type": [
"number",
"string"
]
},
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"personsMax": {
"type": "number"
},
"address": {
"type": "string"
},
"area": {
"type": "string"
},
"areaSquareMeters": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"availableFrom": {
"type": "string"
},
"availableFromFormatted": {
"type": "string"
},
"availableTo": {
"type": "string"
},
"deposit": {
"type": "number"
},
"depositFormatted": {
"type": "string"
},
"noDeposit": {
"type": "boolean"
},
"provider": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"logoUrl": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"alt": {
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"amenities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"icon": {
"type": "string"
},
"tone": {
"type": "string",
"enum": [
"neutral",
"positive"
]
}
},
"required": [
"id",
"label",
"tone"
],
"additionalProperties": false
}
},
"amenitiesMoreCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"petsAllowed": {
"type": "boolean"
},
"registrationPossible": {
"type": "boolean"
},
"detailsUrl": {
"type": "string"
},
"trackingUrl": {
"type": "string"
},
"saved": {
"type": "boolean"
}
},
"required": [
"id",
"available",
"images",
"amenities",
"amenitiesMoreCount"
],
"additionalProperties": false
}
},
"alertCriteria": {
"type": "object",
"properties": {
"name": {
"description": "Optional. Short saved-search label in the user's language so Save search uses a meaningful name (not a generic default).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"housingType": {
"description": "Optional. Same housingType as the preceding search_listings call.",
"type": "string",
"enum": [
"room",
"apartment"
]
},
"roomType": {
"description": "Optional. Same roomType as the preceding search_listings call.",
"type": "string",
"enum": [
"private",
"shared"
]
},
"priceMin": {
"description": "Optional. Minimum monthly price in EUR from the search.",
"type": "number",
"minimum": 0
},
"priceMax": {
"description": "Optional. Maximum monthly price in EUR from the search.",
"type": "number",
"minimum": 0
},
"rooms": {
"description": "Optional. Exact room counts from the search. Allowed: \"studio\", \"1\"…\"10\" (strings only).",
"type": "array",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"studio"
]
}
},
"roomsMin": {
"description": "Optional. Minimum rooms from the search (studio = 0).",
"type": "number",
"minimum": 0
},
"roomsMax": {
"description": "Optional. Maximum rooms from the search.",
"type": "number",
"minimum": 0
},
"providers": {
"description": "Optional. Provider ids from the search.",
"type": "array",
"items": {
"type": "string"
}
},
"areas": {
"description": "Optional. Canonical area ids from list_areas used in the search.",
"type": "array",
"items": {
"type": "string"
}
},
"postCode": {
"description": "Optional. Exact Berlin PLZ from the search.",
"type": "string"
},
"lat": {
"description": "Optional. Nearby-search latitude (with lng).",
"type": "number"
},
"lng": {
"description": "Optional. Nearby-search longitude (with lat).",
"type": "number"
},
"radiusKm": {
"description": "Optional. Nearby-search radius in km.",
"type": "number",
"exclusiveMinimum": 0
},
"bedroomsMin": {
"description": "Optional. Minimum bedrooms from the search.",
"type": "number",
"minimum": 0
},
"squareMetersMin": {
"description": "Optional. Minimum living area m² from the search.",
"type": "number",
"minimum": 0
},
"squareMetersMax": {
"description": "Optional. Maximum living area m² from the search.",
"type": "number",
"minimum": 0
},
"availableFrom": {
"description": "Optional. Available-from date (YYYY-MM-DD) from the search.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"availableTo": {
"description": "Optional. Available-to date (YYYY-MM-DD) from the search.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"personsMaxMin": {
"description": "Optional. Minimum capacity from the search.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"depositMax": {
"description": "Optional. Maximum deposit EUR from the search.",
"type": "number",
"minimum": 0
},
"amenityTags": {
"description": "Optional. Canonical amenity tags (AND) from the search, e.g. wifi, parking, washing_machine.",
"type": "array",
"items": {
"type": "string"
}
},
"petsAllowed": {
"description": "Optional. Pets filter from the search.",
"type": "boolean"
},
"smokingAllowed": {
"description": "Optional. Smoking filter from the search.",
"type": "boolean"
},
"registrationPossible": {
"description": "Optional. Anmeldung/registration filter from the search.",
"type": "boolean"
},
"anmeldungLikely": {
"description": "Optional. Anmeldung-likely filter from the search.",
"type": "boolean"
},
"schufaRequired": {
"description": "Optional. Schufa-required filter from the search.",
"type": "boolean"
},
"noSchufaRequired": {
"description": "Optional. No-Schufa-required filter from the search.",
"type": "boolean"
},
"noSchufaLikely": {
"description": "Optional. No-Schufa-likely filter from the search.",
"type": "boolean"
},
"studentsFriendly": {
"description": "Optional. Students-friendly filter from the search.",
"type": "boolean"
},
"onlyStudentsAllowed": {
"description": "Optional. Students-only filter from the search.",
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Optional object. If present, include only the filter keys used in the preceding search_listings call — every nested field is optional; omit unused keys. Never require all fields. Do not include page, limit, sortBy, or sortOrder."
}
},
"required": [
"listings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_alerts
List the current user's saved search alerts on FlatHunt, including each alert's numeric id, name and creation time when available. Requires alerts.read.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"alerts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"createdAt": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false
}
}
},
"required": [
"alerts"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡create_alert(name, housingType, roomType, priceMin, priceMax, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"name": {
"description": "Optional short label for the saved search (max 120 characters). If omitted, FlatHunt derives a concise label from housing type, budget and location filters.",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"housingType": {
"description": "Type of housing. Studios map to apartment; room includes both private and shared rooms unless roomType narrows it.",
"type": "string",
"enum": [
"room",
"apartment"
]
},
"roomType": {
"description": "Room occupancy: private = one private bedroom in shared housing; shared = a bed in a shared bedroom. Omit to include both. housingType=room remains the broad backwards-compatible filter.",
"type": "string",
"enum": [
"private",
"shared"
]
},
"priceMin": {
"description": "Minimum monthly price in EUR.",
"type": "number",
"minimum": 0
},
"priceMax": {
"description": "Maximum monthly price in EUR.",
"type": "number",
"minimum": 0
},
"rooms": {
"description": "Exact room counts (OR). Allowed values only: \"studio\", \"1\", \"2\", …, \"10\" (strings, not numbers). Prefer over roomsMin/roomsMax for \"1–2 rooms\": [\"1\",\"2\"] or [\"studio\",\"1\"].",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"studio"
]
}
},
"roomsMin": {
"description": "Minimum rooms (studio = 0). Prefer rooms[] for exact OR lists.",
"type": "number",
"minimum": 0
},
"roomsMax": {
"description": "Maximum rooms. Prefer rooms[] for exact OR lists.",
"type": "number",
"minimum": 0
},
"providers": {
"description": "Restrict to specific housing providers (ids from the providers catalog).",
"maxItems": 10,
"type": "array",
"items": {
"type": "string"
}
},
"areas": {
"description": "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 the user names an area, call list_areas first. Pass only canonical IDs returned by list_areas. Never construct, translate, normalize, or guess IDs.",
"maxItems": 20,
"type": "array",
"items": {
"type": "string"
}
},
"postCode": {
"description": "Exact Berlin post code (PLZ), e.g. 10115.",
"type": "string"
},
"lat": {
"description": "Latitude for nearby search; must be provided with lng (+ radiusKm). Do not mix with areas.",
"type": "number"
},
"lng": {
"description": "Longitude for nearby search; must be provided with lat (+ radiusKm). Do not mix with areas.",
"type": "number"
},
"radiusKm": {
"description": "Search radius in km around lat/lng (min 0.1, max 25). Nearby mode — do not mix with areas.",
"type": "number",
"minimum": 0.1,
"maximum": 25
},
"bedroomsMin": {
"description": "Minimum number of bedrooms (from provider extra data when available).",
"type": "number",
"minimum": 0
},
"squareMetersMin": {
"description": "Minimum living area in m². \"from 40 m²\" → 40. Filter on the backend — do not paginate to drop small listings.",
"type": "number",
"minimum": 0
},
"squareMetersMax": {
"description": "Maximum living area in m².",
"type": "number",
"minimum": 0
},
"availableFrom": {
"description": "Available from / not earlier than (YYYY-MM-DD), e.g. \"2026-08-01\".",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"availableTo": {
"description": "Available until / not later than (YYYY-MM-DD).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"personsMaxMin": {
"description": "Minimum capacity (personsMax). Use 2 for couples, 1 for solo — filters listings that can accommodate at least this many people.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"depositMax": {
"description": "Maximum deposit (Kaution) in EUR.",
"type": "number",
"minimum": 0
},
"amenityTags": {
"description": "Canonical amenity tags (AND). Backend filters listings that have ALL of these tags. Catalog (snake_case only): wifi, parking, bike_parking, wheelchair, dishwasher, washing_machine, dryer, elevator, balcony, desk, tv, oven, heating, furnished, fridge, microwave, cooktop, coffee_machine, iron, hair_dryer, closet, wardrobe, bed, bathtub, shower, garden, basement, air_conditioning, parking_street, workspace, fitness, concierge, laundry, pets_friendly. Do not invent aliases (wiFi, hasWifi, Waschmaschine).",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"petsAllowed": {
"description": "true = pets explicitly allowed.",
"type": "boolean"
},
"smokingAllowed": {
"description": "false = non-smokers only / smoking not allowed.",
"type": "boolean"
},
"registrationPossible": {
"description": "true = Anmeldung / registration explicitly possible (strict).",
"type": "boolean"
},
"anmeldungLikely": {
"description": "true = Anmeldung likely (broader). Prefer for \"with Anmeldung\" unless the user needs a hard guarantee.",
"type": "boolean"
},
"schufaRequired": {
"description": "true = Schufa required.",
"type": "boolean"
},
"noSchufaRequired": {
"description": "true = Schufa explicitly not required (strict).",
"type": "boolean"
},
"noSchufaLikely": {
"description": "true = Schufa likely not required (broader). Prefer for \"without Schufa\".",
"type": "boolean"
},
"studentsFriendly": {
"description": "true = student-oriented housing (broader).",
"type": "boolean"
},
"onlyStudentsAllowed": {
"description": "true = students-only listings.",
"type": "boolean"
},
"sortBy": {
"description": "Sort field (default rank). sortOrder is ignored when sortBy=rank. Cheaper first → price+asc; larger area → squareMeters+desc.",
"type": "string",
"enum": [
"rank",
"price",
"squareMeters",
"createdAt",
"availableFrom"
]
},
"sortOrder": {
"description": "Sort direction (default desc). Ignored when sortBy=rank.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"alert": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"createdAt": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false
}
},
"required": [
"alert"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴delete_alert(alertIds, alertId)
Delete one or more of the current user's saved search alerts by numeric id. This is destructive and cannot be undone. Accepts 1–10 ids per call and requires alerts.write.
Eingabe-Schema
{
"type": "object",
"properties": {
"alertIds": {
"description": "Between 1 and 10 alert ids to delete. Preferred for one or many.",
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"alertId": {
"description": "Deprecated single-id form; use alertIds: [id] instead.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"deleted": {
"type": "boolean"
},
"alertIds": {
"type": "array",
"items": {
"type": "number"
}
}
},
"required": [
"deleted",
"alertIds"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_saved_listings
List the current user's saved (favorited) FlatHunt listings. Requires the favorites.read scope.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"savedListings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"listingId": {
"type": "number"
},
"savedAt": {
"type": "string"
},
"listing": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"title": {
"type": "string"
},
"price": {
"type": "number"
},
"priceFormatted": {
"type": "string"
},
"rooms": {
"type": [
"number",
"string"
]
},
"housingType": {
"type": "string"
},
"roomType": {
"type": "string",
"enum": [
"private",
"shared"
]
},
"location": {
"type": "string"
},
"area": {
"type": "string"
},
"areaSquareMeters": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"provider": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"logoUrl": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"availableFrom": {
"type": "string"
},
"availableTo": {
"type": "string"
},
"detailsUrl": {
"type": "string"
},
"trackingUrl": {
"type": "string"
},
"deposit": {
"type": "number"
},
"depositFormatted": {
"type": "string"
},
"noDeposit": {
"type": "boolean"
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"alt": {
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"amenityTags": {
"type": "array",
"items": {
"type": "string"
}
},
"amenitiesUnknown": {
"type": "array",
"items": {
"type": "string"
}
},
"buildingAmenityTags": {
"type": "array",
"items": {
"type": "string"
}
},
"buildingAmenitiesUnknown": {
"type": "array",
"items": {
"type": "string"
}
},
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"petsAllowed": {
"type": "boolean"
},
"smokingAllowed": {
"type": "boolean"
},
"registrationPossible": {
"type": "boolean"
},
"anmeldungLikely": {
"type": "boolean"
},
"schufaRequired": {
"type": "boolean"
},
"noSchufaRequired": {
"type": "boolean"
},
"noSchufaLikely": {
"type": "boolean"
},
"studentsFriendly": {
"type": "boolean"
},
"onlyStudentsAllowed": {
"type": "boolean"
},
"couplesAllowed": {
"type": "boolean"
},
"childrenAllowed": {
"type": "boolean"
},
"partyAllowed": {
"type": "boolean"
},
"guarantorRequired": {
"type": "boolean"
},
"bedrooms": {
"type": "number"
},
"bathrooms": {
"type": "number"
},
"personsMax": {
"type": "number"
},
"minStayMonths": {
"type": "number"
},
"maxStayMonths": {
"type": "number"
},
"furnished": {
"type": "string"
},
"postCode": {
"type": "string"
},
"propertySubtype": {
"type": "string"
},
"floor": {
"type": "string"
},
"minAge": {
"type": "number"
},
"maxAge": {
"type": "number"
},
"preferredGender": {
"type": "string"
}
},
"required": [
"id",
"title"
],
"additionalProperties": false
}
},
"required": [
"listingId"
],
"additionalProperties": false
}
}
},
"required": [
"savedListings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡save_listing(listingId)
Save (favorite) a FlatHunt listing for the current user by its numeric id. Requires the favorites.write scope. Ownership and duplicate handling are enforced by FlatHunt.
Eingabe-Schema
{
"type": "object",
"properties": {
"listingId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the listing to save."
}
},
"required": [
"listingId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"saved": {
"type": "boolean"
},
"listingId": {
"type": "number"
}
},
"required": [
"saved",
"listingId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴remove_saved_listing(listingId)
Remove a listing from the current user's saved (favorited) listings by its numeric id. Requires the favorites.write scope.
Eingabe-Schema
{
"type": "object",
"properties": {
"listingId": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric id of the listing to remove."
}
},
"required": [
"listingId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"removed": {
"type": "boolean"
},
"listingId": {
"type": "number"
}
},
"required": [
"removed",
"listingId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet11 Tools