FlatHunt
Search furnished Berlin housing, compare listings, and manage favorites and saved-search alerts.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~9,607토큰 (도구 정의)
~9.6 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 7.51%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"mcp": {
"url": "https://mcp.flat-hunt.com/mcp"
}
}
}원격 엔드포인트
https://mcp.flat-hunt.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (11)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"type": "object",
"properties": {
"removed": {
"type": "boolean"
},
"listingId": {
"type": "number"
}
},
"required": [
"removed",
"listingId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 11개