FlatHunt
Search furnished Berlin housing, compare listings, and manage favorites and saved-search alerts.
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~9,607token 数（工具定义）
~9.6 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 7.51%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `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 个工具