FlatHunt
v0.1.1Search furnished Berlin housing, compare listings, and manage favorites and saved-search alerts.
Endpoint health
online- Last checked
- 11/20/2026, 6:17:31 AM
- Latency
- 124 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.flat-hunt%2Fmcp
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.flat-hunt/mcp": {
"url": "https://mcp.flat-hunt.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
12 shown · authentication unknown
Compare listings
compare_listings
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.
Schema valid · SHA-256 a3ae1be129e3…
View input 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" }Create a saved search alert
create_alert
Create a saved search alert so FlatHunt notifies the user about new matching listings in the chosen city (Berlin unless `city` is set). Accepts housing, price, size, rooms, availability, canonical area ids, amenity and rental-policy filters. Email notifications are enabled by default; Telegram too when the user has linked Telegram on FlatHunt. Requires the alerts.write scope.
Schema valid · SHA-256 6b491d5fc84f…
View input 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 }, "city": { "description": "City (search market) id from list_cities, e.g. es-madrid. Omit for Berlin (the default). Every search is scoped to one city; areas (district ids) exist only for Berlin.", "type": "string" }, "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 area IDs from list_areas (Berlin only, e.g. berlin:ortsteil:prenzlauer-berg). Up to 20 IDs; multiple IDs are combined with OR. District / Ortsteil mode — do not mix with lat/lng/radiusKm. 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 post code in the searched city, e.g. 10115 (Berlin).", "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" }
Connections
streamable-http
https://mcp.flat-hunt.com/mcp