Luxembourg real estate for AI agents: property search, price estimates, market data, commutes.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Analyze a caller-provided Luxembourg residential lease PDF or raw text, persist the full user-scoped analysis, and return a compact risk summary. Do not provide payment-card data, government identifiers, health data, passwords, API keys, or authentication codes.
Raw lease text when a PDF is not available. Do not pass URLs, payment-card data, government identifiers, health data, passwords, API keys, or authentication codes.
Base64-encoded PDF bytes. Do not pass URLs, payment-card data, government identifiers, health data, passwords, API keys, or authentication codes.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Analyze a caller-provided Luxembourg residential lease PDF or raw text, persist the full user-scoped analysis, and return a compact risk summary. Do not provide payment-card data, government identifiers, health data, passwords, API keys, or authentication codes.
| Argument | Type | Description |
|---|---|---|
| text | string | Raw lease text when a PDF is not available. Do not pass URLs, payment-card data, government identifiers, health data, passwords, API keys, or authentication codes. |
| fileName | string | |
| language | string | |
| pdfBase64 | string | Base64-encoded PDF bytes. Do not pass URLs, payment-card data, government identifiers, health data, passwords, API keys, or authentication codes. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"text": {
"type": "string",
"maxLength": 80000,
"description": "Raw lease text when a PDF is not available. Do not pass URLs, payment-card data, government identifiers, health data, passwords, API keys, or authentication codes."
},
"fileName": {
"type": "string",
"maxLength": 160
},
"language": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt"
],
"type": "string",
"default": "fr"
},
"pdfBase64": {
"type": "string",
"description": "Base64-encoded PDF bytes. Do not pass URLs, payment-card data, government identifiers, health data, passwords, API keys, or authentication codes."
}
}
}Compare two to eight listings through one normalized AgentListing v2 response, including known and estimated costs, availability, property facts, official flood/noise checks, station frequency, commute summaries, value context, provenance, freshness, duplicates, constraints, and explicit unknown fields.
| Argument | Type | Description |
|---|---|---|
| ids* | array | Two to eight listing IDs returned by a ChatHome search tool |
| locale | string | Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 8,
"minItems": 2,
"description": "Two to eight listing IDs returned by a ChatHome search tool"
},
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
}
}
}Calculate Luxembourg mortgage affordability and state whether the property-price ceiling includes every acquisition cost or only currently known costs.
| Argument | Type | Description |
|---|---|---|
| marketRate | number | |
| monthlyDebts | number | Existing monthly debt payments |
| residenceUse | string | Residence use; omitted or unknown preserves an unconfirmed Bëllegen position |
| householdType* | string | |
| loanTermYears | integer | |
| residencyType* | string | |
| employmentType* | string | |
| annualNetIncome* | number | User-confirmed annual household net income |
| isFirstTimeBuyer | boolean | Deprecated optional compatibility signal; never proves Bëllegen entitlement |
Commute time estimates from a Luxembourg commune to a major employment hub (Luxembourg City, Kirchberg EU Quarter, or Belval) across four transport modes.
| Argument | Type | Description |
|---|---|---|
| mode* | string | Transport mode |
| commune* | string | Luxembourg commune name or slug to get commute times from, e.g. 'esch-sur-alzette', 'differdange' |
| destination* | string | Commute destination: lux-city (Luxembourg City centre), kirchberg (EU Quarter), or belval (Esch/Belval) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"commune",
"destination",
"mode"
],
"properties": {
"mode": {
"enum": [
"driving",
"transit",
"cycling",
"walking"
],
"type": "string",
"description": "Transport mode"
},
"commune": {
"type": "string",
"minLength": 1,
"description": "Luxembourg commune name or slug to get commute times from, e.g. 'esch-sur-alzette', 'differdange'"
},
"destination": {
"enum": [
"lux-city",
"kirchberg",
"belval"
],
"type": "string",
"description": "Commute destination: lux-city (Luxembourg City centre), kirchberg (EU Quarter), or belval (Esch/Belval)"
}
}
}Poll an MCP agent inquiry conversation for agent replies. Returns the current status and full message thread.
| Argument | Type | Description |
|---|---|---|
| conversationId* | string | The conversation ID returned by submit_inquiry when kind is conversation_created |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"conversationId"
],
"properties": {
"conversationId": {
"type": "string",
"minLength": 1,
"description": "The conversation ID returned by submit_inquiry when kind is conversation_created"
}
}
}Get the full fail-closed listing page: its public record, price history, area trend, family amenities, neighbourhood facts, property passport, parcel dossier, normalized costs, official checks, transport, provenance, unknown fields, a summary line built from its facts, proven features and measured area facts with their sources, our saved buy-vs-rent and investor estimate (listingTools: dated rate and rent, yields before and after vacancy, a known-costs-only example that is never a verdict, completeness flags), URL, and photos.
| Argument | Type | Description |
|---|---|---|
| id* | string | Listing ID |
| locale | string | Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
| includePhotos | boolean | Attach thumbnail photos of the listing as image content blocks (default: true). Set false for a lean text-only response. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Listing ID"
},
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
},
"includePhotos": {
"type": "boolean",
"description": "Attach thumbnail photos of the listing as image content blocks (default: true). Set false for a lean text-only response."
}
}
}Trust-layer view of the full fail-closed listing page, including its public record and page context, normalized costs, official checks, sources, freshness, explicit unknowns, and privacy-safe correction totals. No reporter identities are exposed.
| Argument | Type | Description |
|---|---|---|
| id* | string | Listing ID |
| locale | string | Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Listing ID"
},
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
}
}
}Get bounded, source-backed property context for a commune, with source dates and unknown states.
| Argument | Type | Description |
|---|---|---|
| locale | string | Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
| commune* | string | Luxembourg commune slug or name (e.g. 'luxembourg', 'esch-sur-alzette', 'kirchberg') |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"commune"
],
"properties": {
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
},
"commune": {
"type": "string",
"minLength": 1,
"description": "Luxembourg commune slug or name (e.g. 'luxembourg', 'esch-sur-alzette', 'kirchberg')"
}
}
}AI-powered price estimate for a Luxembourg property. The chathome valuation model is trained and backtested on historical property listing asking prices, not deed-level sales. Returns an estimated price, confidence interval, and comparable listing statistics.
| Argument | Type | Description |
|---|---|---|
| areaSqm* | number | Living area in square metres |
| commune* | string | Luxembourg commune name or slug, e.g. 'luxembourg', 'esch-sur-alzette' |
| bedrooms | integer | Number of bedrooms |
| energyClass | string | Energy performance certificate class, e.g. 'A', 'B', 'C' |
| listingType* | string | Whether the property is for rent or sale |
| propertyType* | string | Property type, e.g. 'apartment', 'house', 'studio', 'penthouse' |
| constructionYear | integer | Year the property was built, e.g. 1995 |
Get every estate agency with active listings in a supported Luxembourg town, including current buy/rent stock and asking-price ranges.
| Argument | Type | Description |
|---|---|---|
| locale | string | Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
| commune* | string | One of the supported Luxembourg town names or slugs, e.g. 'Mersch' or 'esch-sur-alzette' |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"commune"
],
"properties": {
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
},
"commune": {
"type": "string",
"minLength": 1,
"description": "One of the supported Luxembourg town names or slugs, e.g. 'Mersch' or 'esch-sur-alzette'"
}
}
}Render one to eight exact results from a prior property search as an interactive MCP Apps photo carousel. Call a search tool first, then copy its listing IDs and any returned match scores/reasons without alteration. The tool re-reads canonical public listing facts before display.
| Argument | Type | Description |
|---|---|---|
| locale | string | Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
| heading | string | Short user-facing heading grounded in the search request |
| listings* | array | One to eight exact listing IDs from search_vibe, search_rentals, or search_for_sale, in display order |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listings"
],
"properties": {
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
},
"heading": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Short user-facing heading grounded in the search request"
},
"listings": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Exact listing ID copied from a prior search result"
},
"score": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Exact match score returned by search_vibe"
},
"matchReasons": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"maxItems": 3,
"description": "Exact match reasons returned by search_vibe"
}
}
},
"maxItems": 8,
"minItems": 1,
"description": "One to eight exact listing IDs from search_vibe, search_rentals, or search_for_sale, in display order"
}
}
}Search properties for sale across supported Grande Région inventory by location, price, rooms, area, property type, and positive-evidence amenities, with explicit sort and completeness metadata. Every sourced result identifies and links the original agency listing and states its latest catalogue re-sighting time; thumbnails of the top results are attached as image content blocks.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort by relevance, listing date, or asking price |
| limit | number | Number of results to return (max 50, default 20) |
| garden | boolean | Require a source-confirmed garden |
| locale | string | Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
| balcony | boolean | Require a source-confirmed balcony |
| commune | string | Luxembourg commune name or slug |
| minBeds | number | Minimum number of bedrooms |
| elevator | boolean | Require lift/elevator evidence |
Search active Luxembourg rentals by location, rooms, area, property type, positive-evidence amenities, advertised base rent, or a separate strict confirmed monthly-obligation ceiling. The strict ceiling excludes listings when required recurring charges, fees, evidence, or source freshness are incomplete. Returned counts include explicit completeness metadata; every sourced result links the original agency listing and states its latest catalogue re-sighting time.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort the proven result set. price-asc means base rent, not all-in monthly cost. |
| limit | number | Number of results to return (max 50, default 20) |
| garden | boolean | Require a source-confirmed garden |
| locale | string | Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
| balcony | boolean | Require a source-confirmed balcony |
| commune | string | Luxembourg commune name or slug |
| minBeds | number | Minimum number of bedrooms |
| elevator | boolean |
Preferred natural-language ('vibe') property search. Pass the user's request as prose and the engine matches on lifestyle, mood, proximity, and soft preferences via embeddings + LLM reasoning. Healthy runs return source-grounded match reasons and a 0-100 request-fit score (not a probability); degraded runs explicitly omit ranking claims. Every sourced result identifies and links the original agency listing and states its latest catalogue re-sighting time. The response's understanding block states what was understood; wishes in understanding.notChecked are not confirmed for any returned home. If the requested place cannot be resolved safely, it returns no listings plus a machine-readable unanswerable reason instead of substituting unrelated homes.
| Argument | Type | Description |
|---|---|---|
| brief | object | The `session.brief` object from the previous search_vibe response, passed back unchanged to continue that search. Without `followUp` it replays the same search without re-reading the request. |
| limit | number | Number of results to return (max 50, default 20) |
| query* | string | Natural-language description of what the user wants, in their own words — e.g. "quiet 2-bed near Kirchberg with a balcony under €2000" or "bright family house with a garden, short commute to Belval, energy class A". Lifestyle, vibe, proximity, and soft preferences all work here. |
| intent | string | Whether to search rentals or properties for sale (default: "rent") |
| locale | string |
Submit an inquiry about a listing. For chathome-hosted listings creates a conversation thread; for external agency listings returns agency contact details.
| Argument | Type | Description |
|---|---|---|
| message* | string | Inquiry message to send to the listing owner (10–5000 characters) |
| agentName | string | Optional display name for the inquiring agent |
| listingId* | string | The ID of the listing to inquire about |
| contactEmail | string | Optional contact email for the inquiring agent |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listingId",
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 5000,
"minLength": 10,
"description": "Inquiry message to send to the listing owner (10–5000 characters)"
},
"agentName": {
"type": "string",
"maxLength": 100,
"description": "Optional display name for the inquiring agent"
},
"listingId": {
"type": "string",
"minLength": 1,
"description": "The ID of the listing to inquire about"
},
"contactEmail": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Optional contact email for the inquiring agent"
}
}
}| savingsAvailable* | number | Available savings/down payment |
| isPersonalResidence | boolean | Deprecated residence-use compatibility flag; prefer residenceUse |
| maxDebtToIncomeRatio* | number | Explicit housing-payment share of net income, e.g. 0.35 |
| energyClassDiscountPct | number |
| bellegenAktEligibleBuyers | integer | Explicitly confirmed eligible acquirer count |
| bellegenAktCreditAvailable | number | Aggregate unused Bëllegen Akt balance explicitly confirmed for the acquirers |
| floodZoneRateAdjustmentPct | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"annualNetIncome",
"maxDebtToIncomeRatio",
"savingsAvailable",
"householdType",
"employmentType",
"residencyType"
],
"properties": {
"marketRate": {
"type": "number",
"maximum": 15,
"exclusiveMinimum": 0
},
"monthlyDebts": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "Existing monthly debt payments"
},
"residenceUse": {
"enum": [
"unknown",
"primary",
"other"
],
"type": "string",
"description": "Residence use; omitted or unknown preserves an unconfirmed Bëllegen position"
},
"householdType": {
"enum": [
"single",
"couple"
],
"type": "string"
},
"loanTermYears": {
"type": "integer",
"maximum": 35,
"minimum": 5
},
"residencyType": {
"enum": [
"luxembourg",
"cross_border_fr",
"cross_border_be",
"cross_border_de"
],
"type": "string"
},
"employmentType": {
"enum": [
"salaried",
"self_employed",
"civil_servant"
],
"type": "string"
},
"annualNetIncome": {
"type": "number",
"description": "User-confirmed annual household net income",
"exclusiveMinimum": 0
},
"isFirstTimeBuyer": {
"type": "boolean",
"default": false,
"description": "Deprecated optional compatibility signal; never proves Bëllegen entitlement"
},
"savingsAvailable": {
"type": "number",
"minimum": 0,
"description": "Available savings/down payment"
},
"isPersonalResidence": {
"type": "boolean",
"description": "Deprecated residence-use compatibility flag; prefer residenceUse"
},
"maxDebtToIncomeRatio": {
"type": "number",
"maximum": 0.6,
"description": "Explicit housing-payment share of net income, e.g. 0.35",
"exclusiveMinimum": 0
},
"energyClassDiscountPct": {
"type": "number",
"maximum": 2,
"minimum": 0
},
"bellegenAktEligibleBuyers": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Explicitly confirmed eligible acquirer count"
},
"bellegenAktCreditAvailable": {
"type": "number",
"minimum": 0,
"description": "Aggregate unused Bëllegen Akt balance explicitly confirmed for the acquirers"
},
"floodZoneRateAdjustmentPct": {
"type": "number",
"maximum": 3,
"minimum": 0
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"propertyType",
"listingType",
"commune",
"areaSqm"
],
"properties": {
"areaSqm": {
"type": "number",
"description": "Living area in square metres",
"exclusiveMinimum": 0
},
"commune": {
"type": "string",
"minLength": 1,
"description": "Luxembourg commune name or slug, e.g. 'luxembourg', 'esch-sur-alzette'"
},
"bedrooms": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of bedrooms"
},
"energyClass": {
"type": "string",
"description": "Energy performance certificate class, e.g. 'A', 'B', 'C'"
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string",
"description": "Whether the property is for rent or sale"
},
"propertyType": {
"type": "string",
"minLength": 1,
"description": "Property type, e.g. 'apartment', 'house', 'studio', 'penthouse'"
},
"constructionYear": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Year the property was built, e.g. 1995"
}
}
}| maxPrice |
| number |
| Maximum sale price in EUR |
| minPrice | number | Minimum sale price in EUR |
| furnished | boolean | Require furnished evidence |
| maxAreaSqm | number | Maximum area in m² |
| minAreaSqm | number | Minimum area in m² |
| parkingType | string | Require source-backed parking evidence |
| petsAllowed | boolean | Require pets-allowed evidence |
| minBathrooms | number | Minimum number of bathrooms |
| propertyType | string | Property type: apartment, house, villa, etc. |
| includePhotos | boolean | Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"sort": {
"enum": [
"relevance",
"newest",
"price-asc",
"price-desc"
],
"type": "string",
"description": "Sort by relevance, listing date, or asking price"
},
"limit": {
"type": "number",
"maximum": 50,
"minimum": 1,
"description": "Number of results to return (max 50, default 20)"
},
"garden": {
"type": "boolean",
"const": true,
"description": "Require a source-confirmed garden"
},
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
},
"balcony": {
"type": "boolean",
"const": true,
"description": "Require a source-confirmed balcony"
},
"commune": {
"type": "string",
"description": "Luxembourg commune name or slug"
},
"minBeds": {
"type": "number",
"description": "Minimum number of bedrooms"
},
"elevator": {
"type": "boolean",
"const": true,
"description": "Require lift/elevator evidence"
},
"maxPrice": {
"type": "number",
"description": "Maximum sale price in EUR"
},
"minPrice": {
"type": "number",
"description": "Minimum sale price in EUR"
},
"furnished": {
"type": "boolean",
"const": true,
"description": "Require furnished evidence"
},
"maxAreaSqm": {
"type": "number",
"description": "Maximum area in m²"
},
"minAreaSqm": {
"type": "number",
"description": "Minimum area in m²"
},
"parkingType": {
"enum": [
"off_street",
"garage",
"covered"
],
"type": "string",
"description": "Require source-backed parking evidence"
},
"petsAllowed": {
"type": "boolean",
"const": true,
"description": "Require pets-allowed evidence"
},
"minBathrooms": {
"type": "number",
"description": "Minimum number of bathrooms"
},
"propertyType": {
"type": "string",
"description": "Property type: apartment, house, villa, etc."
},
"includePhotos": {
"type": "boolean",
"description": "Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response."
}
}
}| Require positive source evidence of a lift/elevator |
| maxPrice | number | Maximum advertised base monthly rent in EUR, excluding separate charges |
| minPrice | number | Minimum monthly rent in EUR |
| furnished | boolean | Require positive source evidence that the rental is furnished |
| maxAreaSqm | number | Maximum area in m² |
| minAreaSqm | number | Minimum area in m² |
| parkingType | string | Require source-backed parking evidence |
| petsAllowed | boolean | Require positive source evidence that pets are allowed |
| minBathrooms | number | Minimum number of bathrooms |
| propertyType | string | Property type: apartment, house, studio, room, etc. |
| includePhotos | boolean | Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response. |
| maxTotalMonthly | number | Strict maximum confirmed monthly obligation in EUR: advertised rent plus source-confirmed required recurring charges and fees. Listings with missing, estimated, conflicting, or stale cost evidence are excluded. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"sort": {
"enum": [
"relevance",
"newest",
"price-asc",
"price-desc"
],
"type": "string",
"description": "Sort the proven result set. price-asc means base rent, not all-in monthly cost."
},
"limit": {
"type": "number",
"maximum": 50,
"minimum": 1,
"description": "Number of results to return (max 50, default 20)"
},
"garden": {
"type": "boolean",
"const": true,
"description": "Require a source-confirmed garden"
},
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
},
"balcony": {
"type": "boolean",
"const": true,
"description": "Require a source-confirmed balcony"
},
"commune": {
"type": "string",
"description": "Luxembourg commune name or slug"
},
"minBeds": {
"type": "number",
"description": "Minimum number of bedrooms"
},
"elevator": {
"type": "boolean",
"const": true,
"description": "Require positive source evidence of a lift/elevator"
},
"maxPrice": {
"type": "number",
"description": "Maximum advertised base monthly rent in EUR, excluding separate charges"
},
"minPrice": {
"type": "number",
"description": "Minimum monthly rent in EUR"
},
"furnished": {
"type": "boolean",
"const": true,
"description": "Require positive source evidence that the rental is furnished"
},
"maxAreaSqm": {
"type": "number",
"description": "Maximum area in m²"
},
"minAreaSqm": {
"type": "number",
"description": "Minimum area in m²"
},
"parkingType": {
"enum": [
"off_street",
"garage",
"covered"
],
"type": "string",
"description": "Require source-backed parking evidence"
},
"petsAllowed": {
"type": "boolean",
"const": true,
"description": "Require positive source evidence that pets are allowed"
},
"minBathrooms": {
"type": "number",
"description": "Minimum number of bathrooms"
},
"propertyType": {
"type": "string",
"description": "Property type: apartment, house, studio, room, etc."
},
"includePhotos": {
"type": "boolean",
"description": "Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response."
},
"maxTotalMonthly": {
"type": "number",
"description": "Strict maximum confirmed monthly obligation in EUR: advertised rent plus source-confirmed required recurring charges and fees. Listings with missing, estimated, conflicting, or stale cost evidence are excluded."
}
}
}| Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu') |
| followUp | string | A change to the previous search or a question about its results, in the user’s own words — e.g. "cheaper", "like #2 but with a garden", "which one has parking?". Send it with the `brief` from the previous response (`session.brief`) and the same `query`. A question leaves the search unchanged and comes back as `followUp.reply`. |
| includePhotos | boolean | Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response. |
| shownListingIds | array | Ids of the listings you showed the user, in the order shown, so "#2" or "the second one" in `followUp` points at the right home. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"brief": {
"type": "object",
"description": "The `session.brief` object from the previous search_vibe response, passed back unchanged to continue that search. Without `followUp` it replays the same search without re-reading the request.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"limit": {
"type": "number",
"maximum": 50,
"minimum": 1,
"description": "Number of results to return (max 50, default 20)"
},
"query": {
"type": "string",
"minLength": 1,
"description": "Natural-language description of what the user wants, in their own words — e.g. \"quiet 2-bed near Kirchberg with a balcony under €2000\" or \"bright family house with a garden, short commute to Belval, energy class A\". Lifestyle, vibe, proximity, and soft preferences all work here."
},
"intent": {
"enum": [
"rent",
"buy"
],
"type": "string",
"description": "Whether to search rentals or properties for sale (default: \"rent\")"
},
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string",
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')"
},
"followUp": {
"type": "string",
"maxLength": 800,
"minLength": 1,
"description": "A change to the previous search or a question about its results, in the user’s own words — e.g. \"cheaper\", \"like #2 but with a garden\", \"which one has parking?\". Send it with the `brief` from the previous response (`session.brief`) and the same `query`. A question leaves the search unchanged and comes back as `followUp.reply`."
},
"includePhotos": {
"type": "boolean",
"description": "Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response."
},
"shownListingIds": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 10,
"description": "Ids of the listings you showed the user, in the order shown, so \"#2\" or \"the second one\" in `followUp` points at the right home."
}
}
}