Server definition
- Hash
- sha256:d905ad0072b849d26169dea0dc8224e6cd3fdd60b64cc79998ffd2f3e0af4e51
- What it is
- What a remote MCP server returned when asked what it offers: 15 tools
The blob, as servednamed by its sha256
{
"instructions": "chathome MCP server — property search across supported Grande Région inventory, plus Luxembourg market and housing intelligence.\n\nPresenting results to a human (chat assistants — follow this exactly):\n- Do NOT ask the user clarifying questions before the FIRST search. Call search_vibe immediately with the user's own words (default intent \"rent\"; use \"buy\" only when purchase intent is clear). The engine handles vague, partial, and lifestyle queries. Offer refinements only AFTER showing initial results.\n- To refine or ask about shown results, call search_vibe again with the same query, the user's words as followUp, the previous response's session.brief as brief, and the ids you showed as shownListingIds. A question returns followUp.reply and the same results; a change returns new results.\n- Search and detail responses attach thumbnail photos of the top results as image content blocks, each preceded by a text label naming the listing. Display these images to the user next to the matching listing summary — never describe a photo instead of showing it.\n- For every listing you present, include: the title as a clickable link to its \"url\" field (canonical chathome.lu page with full gallery and contact options), the price, location (city/district), beds · baths · areaSqm, and one line from \"description\" or \"matchReasons\".\n- Show roughly the top 5 results in detail and summarise the rest in one line. \"total\" is exactly the number of listing objects returned in this response, not the number of matching homes in the market.\n\nAvailable tools:\n- search_vibe: PREFERRED search — natural-language / \"vibe\" semantic search. Pass the user's request as prose (\"quiet 2-bed near Kirchberg with a balcony under €2000\") and the engine matches on lifestyle, mood, proximity and soft preferences via embeddings + LLM reasoning. A score is a 0-100 request-fit value, not a probability or market percentile. If ranking.status is \"degraded\", no scores/reasons are returned: disclose the note and retry before presenting ranked matches. When understanding.notChecked is non-empty, tell the user those wishes were not checked for any listing. When unanswerable is present, no listings were returned: explain why and ask for what it needs; never substitute unrelated homes. (scope: listings:read)\n- search_rentals: structured rental search by commune, price, beds, etc. (scope: listings:read)\n- search_for_sale: search properties for sale (scope: listings:read)\n- render_listing_cards: after a search, show 1-8 exact matches as an interactive photo carousel. Copy listing IDs and any score/matchReasons exactly from the search result; never invent display facts. (scope: listings:read)\n- get_listing: fetch the full fail-closed listing page, including price history, area trend, family amenities, neighbourhood facts, passport, parcel dossier, costs, property checks and transport. \"pageText\" holds a summary line built from the listing's facts (not the agency's words), the features the agency's page proves, and measured area facts, each with its public-data source and measuring point; quote those sources rather than restating a fact as your own (scope: listings:read)\n- compare_listings: fetch 2-8 listing IDs through one normalized evidence-aware comparison, including costs, property checks and mobility (scope: listings:read)\n- get_listing_truth: trust-layer view of a listing — facts + sources + freshness + which facts are still unknown + a privacy-safe summary of user-reported corrections. Call before acting on a listing to gauge how much to trust the data. (scope: listings:read)\n- get_market_context: get bounded, source-backed property context for a commune (scope: market:read)\n- get_town_agencies: get every agency with live stock in a supported Luxembourg town (scope: market:read)\n- get_price_estimate: AI-powered price estimate for a property (scope: market:read)\n- get_affordability: mortgage affordability simulation using current Luxembourg rates and acquisition costs (scope: market:read)\n- get_commute_times: commute times from a commune to a major employment hub (scope: market:read)\n- analyze_lease: analyze a caller-provided lease PDF or text and persist a user-scoped risk report (scope: documents:write, OAuth user only)\n- submit_inquiry: send an inquiry about a listing; creates a conversation or returns external agency contacts (scope: inquiries:write)\n- get_inquiry_status: poll an MCP agent inquiry conversation for replies (scope: inquiries:read)\n\nAvailable resources:\n- chathome://listing/{id}: read a single listing by ID\n\nAvailable prompts:\n- find-family-home: guided search for family-friendly rentals\n- match-properties: anonymous natural-language search followed by picture cards\n\nAuthenticate each request with an API key via X-API-Key header or Authorization: Bearer <token>.\n\nThe public property journey needs NO account and NO credential: search_vibe, search_rentals, search_for_sale, render_listing_cards, get_listing, compare_listings, and get_market_context. Call these straight away. Anonymous callers have smaller hourly limits, while OAuth or an X-API-Key provides higher limits. Every other tool, and everything that writes or is user-specific (submit_inquiry, analyze_lease, get_inquiry_status), requires authentication and answers 401 without it.\n\nAgent-to-agent flow:\n1. Prefer search_vibe with the user's natural-language request; fall back to search_rentals / search_for_sale for purely structured queries. After choosing the best 1-8 results, call render_listing_cards with the exact IDs and any returned scores/reasons so compatible chat clients show the photo carousel.\n2. Call compare_listings for a normalized shortlist and get_listing for the complete public listing page: its record plus price history, area trend, family amenities, neighbourhood facts, passport, parcel dossier, exact property checks and transport. Use get_market_context / get_commute_times for broader area questions. Call get_listing_truth before relying on a listing.\n3. Call get_price_estimate to validate asking price against the valuation model, or get_affordability to derive a safe budget ceiling. Branch on maxPropertyPriceCostBasis: when it is complete, maxPropertyPrice may be used as a hard search ceiling; when it is known_costs_only, do not use maxPropertyPrice as a hard filter and label comparisons provisional, because quote-required acquisition costs may lower it. A budget the user states directly may still be a hard ceiling. Keep acquisitionCosts.unknownComponents visible.\n4. For lease review, call analyze_lease only with user-provided bytes/text and an OAuth user token. Never send payment-card data, government identifiers, health data, passwords, API keys, or authentication codes.\n5. Call submit_inquiry to contact the listing owner. If the listing is externally managed, agency contact details are returned directly.\n6. Call get_inquiry_status to poll for replies.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"fileName": {
"maxLength": 160,
"type": "string"
},
"language": {
"default": "fr",
"enum": [
"en",
"fr",
"de",
"lu",
"pt"
],
"type": "string"
},
"pdfBase64": {
"description": "Base64-encoded PDF bytes. Do not pass URLs, payment-card data, government identifiers, health data, passwords, API keys, or authentication codes.",
"type": "string"
},
"text": {
"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.",
"maxLength": 80000,
"type": "string"
}
},
"type": "object"
},
"name": "analyze_lease",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"clauses": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"isLease": {
"type": "boolean"
},
"overallRiskScore": {
"type": "number"
},
"persisted": {
"const": true,
"type": "boolean"
},
"severityCounts": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"isLease",
"overallRiskScore",
"severityCounts",
"clauses",
"persisted",
"trust"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ids": {
"description": "Two to eight listing IDs returned by a ChatHome search tool",
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"minItems": 2,
"type": "array"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
}
},
"required": [
"ids"
],
"type": "object"
},
"name": "compare_listings",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"comparisonFields": {
"items": {
"type": "string"
},
"type": "array"
},
"listings": {
"items": {
"additionalProperties": {},
"properties": {
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amenities": {
"additionalProperties": false,
"properties": {
"balcony": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"elevator": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"furnished": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"garden": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"petsAllowed": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"stepFreeAccess": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"wheelchairAccessible": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"furnished",
"elevator",
"parking",
"balcony",
"garden",
"petsAllowed",
"stepFreeAccess",
"wheelchairAccessible"
],
"type": "object"
},
"areaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"availability": {
"additionalProperties": false,
"properties": {
"availableFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"moveInState": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"offerStatus": {
"enum": [
"available",
"under_offer",
"unknown"
],
"type": "string"
}
},
"required": [
"offerStatus",
"availableFrom",
"moveInState"
],
"type": "object"
},
"baths": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"charges": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"const": "EUR",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duplicates": {
"additionalProperties": false,
"properties": {
"confirmedOtherSources": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"confirmedSourceCount": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"confirmedOtherSources",
"confirmedSourceCount"
],
"type": "object"
},
"energyClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"features": {
"items": {
"type": "string"
},
"type": "array"
},
"fieldProvenance": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"source_structured",
"source_text",
"official_dataset",
"calculation",
"manual_review",
"model_extraction",
"model_only",
"unknown"
],
"type": "string"
},
"observedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"publisher": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sourceUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"confirmed",
"estimated",
"thin_sample",
"stale",
"context_only",
"conflicted",
"not_collected",
"source_unavailable",
"suppressed"
],
"type": "string"
}
},
"required": [
"status",
"publisher",
"method",
"sourceUrl",
"observedAt"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"hasSourceCheckedFacts": {
"type": "boolean"
},
"history": {
"additionalProperties": false,
"properties": {
"daysListed": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"firstObservedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"firstObservedBasis": {
"const": "source_listing_date_or_chathome_ingest",
"type": "string"
},
"lastChangedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"priceDropTotalEur": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"firstObservedAt",
"firstObservedBasis",
"daysListed",
"priceDropTotalEur",
"lastChangedAt"
],
"type": "object"
},
"id": {
"type": "string"
},
"imageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string"
},
"location": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"verified",
"unverified",
"contradicted",
"unknown"
],
"type": "string"
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"precision": {
"enum": [
"exact_address",
"street",
"district",
"commune_only",
"unknown"
],
"type": "string"
}
},
"required": [
"city",
"district",
"address",
"postalCode",
"precision",
"confidence"
],
"type": "object"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"match": {
"additionalProperties": false,
"properties": {
"allRequiredConstraintsSatisfied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"requiredConstraints": {
"items": {
"additionalProperties": false,
"properties": {
"actual": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"matched",
"not_matched",
"not_verified",
"not_applied"
],
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"status",
"target",
"actual"
],
"type": "object"
},
"type": "array"
},
"resultKind": {
"anyOf": [
{
"enum": [
"strict_match",
"partial_match",
"relaxed_alternative"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"allRequiredConstraintsSatisfied",
"resultKind",
"requiredConstraints",
"reasons"
],
"type": "object"
},
"matchReasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"officialScreening": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"photoUrls": {
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pricePerSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"property": {
"additionalProperties": false,
"properties": {
"airConditioning": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"colocation": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"completionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"constructionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasFloorplan": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"heatingEnergy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"heatingType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"landAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"privateRoomAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rentByOwner": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"rooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"totalFloors": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"rooms",
"floor",
"totalFloors",
"constructionYear",
"completionYear",
"landAreaSqm",
"privateRoomAreaSqm",
"condition",
"heatingType",
"heatingEnergy",
"airConditioning",
"hasFloorplan",
"rentByOwner",
"colocation"
],
"type": "object"
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyFee": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"agencyFeeBasis": {
"anyOf": [
{
"enum": [
"tenant_share",
"total_commission",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
]
},
"baseMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chargesIncluded": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"chargesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"deposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"depositExceedsMaximum": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"depositMaximum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotalIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"estimatedUtilitiesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"exactUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"firstChargeAdvance": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"heatingMayBeDoubleCounted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"indicativeInsuranceMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownMonthlyLowerBound": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"mandatoryRecurringFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryRecurringFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"monthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"monthlyTotalStatus": {
"anyOf": [
{
"enum": [
"known",
"unknown_charges",
"conflicting_charges",
"invalid_price",
"unknown_mandatory_recurring_fees"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportedDeposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unknownComponents": {
"items": {
"type": "string"
},
"type": "array"
},
"upfrontCostIsExact": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"upfrontCostIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"baseMonthly",
"chargesMonthly",
"chargesIncluded",
"monthlyTotal",
"monthlyTotalStatus",
"knownMonthlyLowerBound",
"estimatedMonthlyTotal",
"estimatedMonthlyTotalIsLowerBound",
"estimatedUtilitiesMonthly",
"indicativeInsuranceMonthly",
"heatingMayBeDoubleCounted",
"firstChargeAdvance",
"reportedDeposit",
"deposit",
"depositMaximum",
"depositExceedsMaximum",
"agencyFee",
"agencyFeeBasis",
"mandatoryRecurringFees",
"mandatoryRecurringFeeTotal",
"mandatoryMoveInFees",
"mandatoryMoveInFeeTotal",
"knownUpfrontCost",
"exactUpfrontCost",
"upfrontCostIsLowerBound",
"upfrontCostIsExact",
"unknownComponents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"schemaVersion": {
"const": "agent-listing.v2",
"type": "string"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"source": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyConfirmedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"agencyListingId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lastSeenAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"listingUrl": {
"format": "uri",
"type": "string"
},
"status": {
"enum": [
"active",
"under_offer",
"unknown"
],
"type": "string"
},
"statusBasis": {
"enum": [
"source_catalog_seen",
"listing_record_active"
],
"type": "string"
},
"type": {
"const": "original_agency_listing",
"type": "string"
}
},
"required": [
"type",
"agencyName",
"listingUrl",
"agencyListingId",
"lastSeenAt",
"status",
"statusBasis",
"agencyConfirmedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"const": "active",
"type": "string"
},
"title": {
"type": "string"
},
"transport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"unknown": {
"description": "Why each missingFields entry is unknown. not_in_search_result means get_listing may know it.",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"reason": {
"enum": [
"not_stated",
"not_proven",
"conflicted",
"not_in_search_result"
],
"type": "string"
}
},
"required": [
"field",
"reason"
],
"type": "object"
},
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
},
"valueContext": {
"additionalProperties": false,
"properties": {
"fairPrice": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"marketContext": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceIntegrity": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceIntegrity",
"fairPrice",
"marketContext"
],
"type": "object"
}
},
"required": [
"schemaVersion",
"id",
"url",
"title",
"status",
"price",
"currency",
"listingType",
"propertyType",
"city",
"district",
"country",
"beds",
"baths",
"areaSqm",
"energyClass",
"imageUrl",
"agencyName",
"source",
"rent",
"availability",
"property",
"location",
"history",
"duplicates",
"amenities",
"fieldProvenance",
"officialScreening",
"propertyChecks",
"transport",
"valueContext",
"missingFields",
"match",
"latitude",
"longitude"
],
"type": "object"
},
"maxItems": 8,
"minItems": 0,
"type": "array"
},
"notFoundIds": {
"items": {
"type": "string"
},
"type": "array"
},
"schemaVersion": {
"const": "listing-comparison.v1",
"type": "string"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"schemaVersion",
"listings",
"notFoundIds",
"comparisonFields",
"trust"
],
"type": "object"
}
},
{
"description": "Calculate Luxembourg mortgage affordability and state whether the property-price ceiling includes every acquisition cost or only currently known costs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"annualNetIncome": {
"description": "User-confirmed annual household net income",
"exclusiveMinimum": 0,
"type": "number"
},
"bellegenAktCreditAvailable": {
"description": "Aggregate unused Bëllegen Akt balance explicitly confirmed for the acquirers",
"minimum": 0,
"type": "number"
},
"bellegenAktEligibleBuyers": {
"description": "Explicitly confirmed eligible acquirer count",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"employmentType": {
"enum": [
"salaried",
"self_employed",
"civil_servant"
],
"type": "string"
},
"energyClassDiscountPct": {
"maximum": 2,
"minimum": 0,
"type": "number"
},
"floodZoneRateAdjustmentPct": {
"maximum": 3,
"minimum": 0,
"type": "number"
},
"householdType": {
"enum": [
"single",
"couple"
],
"type": "string"
},
"isFirstTimeBuyer": {
"default": false,
"description": "Deprecated optional compatibility signal; never proves Bëllegen entitlement",
"type": "boolean"
},
"isPersonalResidence": {
"description": "Deprecated residence-use compatibility flag; prefer residenceUse",
"type": "boolean"
},
"loanTermYears": {
"maximum": 35,
"minimum": 5,
"type": "integer"
},
"marketRate": {
"exclusiveMinimum": 0,
"maximum": 15,
"type": "number"
},
"maxDebtToIncomeRatio": {
"description": "Explicit housing-payment share of net income, e.g. 0.35",
"exclusiveMinimum": 0,
"maximum": 0.6,
"type": "number"
},
"monthlyDebts": {
"default": 0,
"description": "Existing monthly debt payments",
"minimum": 0,
"type": "number"
},
"residenceUse": {
"description": "Residence use; omitted or unknown preserves an unconfirmed Bëllegen position",
"enum": [
"unknown",
"primary",
"other"
],
"type": "string"
},
"residencyType": {
"enum": [
"luxembourg",
"cross_border_fr",
"cross_border_be",
"cross_border_de"
],
"type": "string"
},
"savingsAvailable": {
"description": "Available savings/down payment",
"minimum": 0,
"type": "number"
}
},
"required": [
"annualNetIncome",
"maxDebtToIncomeRatio",
"savingsAvailable",
"householdType",
"employmentType",
"residencyType"
],
"type": "object"
},
"name": "get_affordability",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"confidence": {
"type": "string"
},
"freshness": {
"type": "string"
},
"maxPropertyPrice": {
"type": "number"
},
"maxPropertyPriceCostBasis": {
"enum": [
"complete",
"known_costs_only"
],
"type": "string"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"maxPropertyPrice",
"maxPropertyPriceCostBasis",
"confidence",
"freshness",
"trust"
],
"type": "object"
}
},
{
"description": "Commute time estimates from a Luxembourg commune to a major employment hub (Luxembourg City, Kirchberg EU Quarter, or Belval) across four transport modes.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"commune": {
"description": "Luxembourg commune name or slug to get commute times from, e.g. 'esch-sur-alzette', 'differdange'",
"minLength": 1,
"type": "string"
},
"destination": {
"description": "Commute destination: lux-city (Luxembourg City centre), kirchberg (EU Quarter), or belval (Esch/Belval)",
"enum": [
"lux-city",
"kirchberg",
"belval"
],
"type": "string"
},
"mode": {
"description": "Transport mode",
"enum": [
"driving",
"transit",
"cycling",
"walking"
],
"type": "string"
}
},
"required": [
"commune",
"destination",
"mode"
],
"type": "object"
},
"name": "get_commute_times",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"commune": {
"type": "string"
},
"destination": {
"type": "string"
},
"distanceKm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"minutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mode": {
"type": "string"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"stale": {
"type": "boolean"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"commune",
"destination",
"mode",
"minutes",
"distanceKm",
"source",
"stale",
"trust"
],
"type": "object"
}
},
{
"description": "Poll an MCP agent inquiry conversation for agent replies. Returns the current status and full message thread.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"conversationId": {
"description": "The conversation ID returned by submit_inquiry when kind is conversation_created",
"minLength": 1,
"type": "string"
}
},
"required": [
"conversationId"
],
"type": "object"
},
"name": "get_inquiry_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"conversationId": {
"type": "string"
},
"messages": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"status": {
"enum": [
"replied",
"awaiting_reply"
],
"type": "string"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"conversationId",
"status",
"messages",
"trust"
],
"type": "object"
}
},
{
"description": "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, URL, and photos.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"description": "Listing ID",
"minLength": 1,
"type": "string"
},
"includePhotos": {
"description": "Attach thumbnail photos of the listing as image content blocks (default: true). Set false for a lean text-only response.",
"type": "boolean"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_listing",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"listing": {
"additionalProperties": {},
"properties": {
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amenities": {
"additionalProperties": false,
"properties": {
"balcony": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"elevator": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"furnished": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"garden": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"petsAllowed": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"stepFreeAccess": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"wheelchairAccessible": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"furnished",
"elevator",
"parking",
"balcony",
"garden",
"petsAllowed",
"stepFreeAccess",
"wheelchairAccessible"
],
"type": "object"
},
"areaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"availability": {
"additionalProperties": false,
"properties": {
"availableFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"moveInState": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"offerStatus": {
"enum": [
"available",
"under_offer",
"unknown"
],
"type": "string"
}
},
"required": [
"offerStatus",
"availableFrom",
"moveInState"
],
"type": "object"
},
"baths": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"charges": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"const": "EUR",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duplicates": {
"additionalProperties": false,
"properties": {
"confirmedOtherSources": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"confirmedSourceCount": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"confirmedOtherSources",
"confirmedSourceCount"
],
"type": "object"
},
"energyClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"features": {
"items": {
"type": "string"
},
"type": "array"
},
"fieldProvenance": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"source_structured",
"source_text",
"official_dataset",
"calculation",
"manual_review",
"model_extraction",
"model_only",
"unknown"
],
"type": "string"
},
"observedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"publisher": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sourceUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"confirmed",
"estimated",
"thin_sample",
"stale",
"context_only",
"conflicted",
"not_collected",
"source_unavailable",
"suppressed"
],
"type": "string"
}
},
"required": [
"status",
"publisher",
"method",
"sourceUrl",
"observedAt"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"hasSourceCheckedFacts": {
"type": "boolean"
},
"history": {
"additionalProperties": false,
"properties": {
"daysListed": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"firstObservedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"firstObservedBasis": {
"const": "source_listing_date_or_chathome_ingest",
"type": "string"
},
"lastChangedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"priceDropTotalEur": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"firstObservedAt",
"firstObservedBasis",
"daysListed",
"priceDropTotalEur",
"lastChangedAt"
],
"type": "object"
},
"id": {
"type": "string"
},
"imageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string"
},
"location": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"verified",
"unverified",
"contradicted",
"unknown"
],
"type": "string"
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"precision": {
"enum": [
"exact_address",
"street",
"district",
"commune_only",
"unknown"
],
"type": "string"
}
},
"required": [
"city",
"district",
"address",
"postalCode",
"precision",
"confidence"
],
"type": "object"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"match": {
"additionalProperties": false,
"properties": {
"allRequiredConstraintsSatisfied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"requiredConstraints": {
"items": {
"additionalProperties": false,
"properties": {
"actual": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"matched",
"not_matched",
"not_verified",
"not_applied"
],
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"status",
"target",
"actual"
],
"type": "object"
},
"type": "array"
},
"resultKind": {
"anyOf": [
{
"enum": [
"strict_match",
"partial_match",
"relaxed_alternative"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"allRequiredConstraintsSatisfied",
"resultKind",
"requiredConstraints",
"reasons"
],
"type": "object"
},
"matchReasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"officialScreening": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"photoUrls": {
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pricePerSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"property": {
"additionalProperties": false,
"properties": {
"airConditioning": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"colocation": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"completionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"constructionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasFloorplan": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"heatingEnergy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"heatingType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"landAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"privateRoomAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rentByOwner": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"rooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"totalFloors": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"rooms",
"floor",
"totalFloors",
"constructionYear",
"completionYear",
"landAreaSqm",
"privateRoomAreaSqm",
"condition",
"heatingType",
"heatingEnergy",
"airConditioning",
"hasFloorplan",
"rentByOwner",
"colocation"
],
"type": "object"
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyFee": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"agencyFeeBasis": {
"anyOf": [
{
"enum": [
"tenant_share",
"total_commission",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
]
},
"baseMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chargesIncluded": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"chargesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"deposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"depositExceedsMaximum": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"depositMaximum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotalIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"estimatedUtilitiesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"exactUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"firstChargeAdvance": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"heatingMayBeDoubleCounted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"indicativeInsuranceMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownMonthlyLowerBound": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"mandatoryRecurringFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryRecurringFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"monthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"monthlyTotalStatus": {
"anyOf": [
{
"enum": [
"known",
"unknown_charges",
"conflicting_charges",
"invalid_price",
"unknown_mandatory_recurring_fees"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportedDeposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unknownComponents": {
"items": {
"type": "string"
},
"type": "array"
},
"upfrontCostIsExact": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"upfrontCostIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"baseMonthly",
"chargesMonthly",
"chargesIncluded",
"monthlyTotal",
"monthlyTotalStatus",
"knownMonthlyLowerBound",
"estimatedMonthlyTotal",
"estimatedMonthlyTotalIsLowerBound",
"estimatedUtilitiesMonthly",
"indicativeInsuranceMonthly",
"heatingMayBeDoubleCounted",
"firstChargeAdvance",
"reportedDeposit",
"deposit",
"depositMaximum",
"depositExceedsMaximum",
"agencyFee",
"agencyFeeBasis",
"mandatoryRecurringFees",
"mandatoryRecurringFeeTotal",
"mandatoryMoveInFees",
"mandatoryMoveInFeeTotal",
"knownUpfrontCost",
"exactUpfrontCost",
"upfrontCostIsLowerBound",
"upfrontCostIsExact",
"unknownComponents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"schemaVersion": {
"const": "agent-listing.v2",
"type": "string"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"source": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyConfirmedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"agencyListingId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lastSeenAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"listingUrl": {
"format": "uri",
"type": "string"
},
"status": {
"enum": [
"active",
"under_offer",
"unknown"
],
"type": "string"
},
"statusBasis": {
"enum": [
"source_catalog_seen",
"listing_record_active"
],
"type": "string"
},
"type": {
"const": "original_agency_listing",
"type": "string"
}
},
"required": [
"type",
"agencyName",
"listingUrl",
"agencyListingId",
"lastSeenAt",
"status",
"statusBasis",
"agencyConfirmedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"const": "active",
"type": "string"
},
"title": {
"type": "string"
},
"transport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"unknown": {
"description": "Why each missingFields entry is unknown. not_in_search_result means get_listing may know it.",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"reason": {
"enum": [
"not_stated",
"not_proven",
"conflicted",
"not_in_search_result"
],
"type": "string"
}
},
"required": [
"field",
"reason"
],
"type": "object"
},
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
},
"valueContext": {
"additionalProperties": false,
"properties": {
"fairPrice": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"marketContext": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceIntegrity": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceIntegrity",
"fairPrice",
"marketContext"
],
"type": "object"
}
},
"required": [
"schemaVersion",
"id",
"url",
"title",
"status",
"price",
"currency",
"listingType",
"propertyType",
"city",
"district",
"country",
"beds",
"baths",
"areaSqm",
"energyClass",
"imageUrl",
"agencyName",
"source",
"rent",
"availability",
"property",
"location",
"history",
"duplicates",
"amenities",
"fieldProvenance",
"officialScreening",
"propertyChecks",
"transport",
"valueContext",
"missingFields",
"match",
"latitude",
"longitude"
],
"type": "object"
},
"listingPage": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"listingPageContext": {
"additionalProperties": false,
"properties": {
"commuteSummary": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"countryEvidence": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"familyAmenities": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"neighborhoodFacts": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"parcelDossier": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"passport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceEvolution": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceHistory": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"transitSummary": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceHistory",
"priceEvolution",
"familyAmenities",
"neighborhoodFacts",
"countryEvidence",
"transitSummary",
"commuteSummary",
"passport",
"propertyChecks",
"parcelDossier"
],
"type": "object"
},
"pageText": {
"additionalProperties": false,
"properties": {
"areaFacts": {
"items": {
"additionalProperties": false,
"properties": {
"distanceMeters": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floodLevel": {
"anyOf": [
{
"enum": [
"low",
"moderate",
"high",
"very_high"
],
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"enum": [
"nearest_transit_stop",
"nearest_rail_station",
"nearest_school",
"flood_zone",
"road_noise",
"rail_noise",
"aircraft_noise"
],
"type": "string"
},
"inFloodZone": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"label": {
"type": "string"
},
"measuredAt": {
"type": "string"
},
"measuredFrom": {
"enum": [
"address",
"block",
"street",
"district"
],
"type": "string"
},
"measuredFromLabel": {
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"noiseLdenDb": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"source": {
"enum": [
"public_transport_timetables",
"school_registers",
"official_flood_maps",
"official_noise_maps"
],
"type": "string"
},
"sourceLabel": {
"type": "string"
},
"text": {
"type": "string"
},
"walkingMinutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"label",
"text",
"walkingMinutes",
"distanceMeters",
"name",
"inFloodZone",
"floodLevel",
"noiseLdenDb",
"source",
"sourceLabel",
"measuredFrom",
"measuredFromLabel",
"measuredAt"
],
"type": "object"
},
"type": "array"
},
"locale": {
"enum": [
"en",
"fr",
"de",
"lu",
"pt"
],
"type": "string"
},
"provenFeatures": {
"items": {
"additionalProperties": false,
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"source": {
"const": "agency_listing_page",
"type": "string"
}
},
"required": [
"key",
"label",
"source"
],
"type": "object"
},
"type": "array"
},
"schemaVersion": {
"const": "listing-page-text.v1",
"type": "string"
},
"summary": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyWords": {
"const": false,
"type": "boolean"
},
"basis": {
"const": "listing_facts_and_public_data",
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"text",
"basis",
"agencyWords"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"schemaVersion",
"locale",
"summary",
"provenFeatures",
"areaFacts"
],
"type": "object"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"listing",
"listingPage",
"listingPageContext",
"pageText",
"trust"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"description": "Listing ID",
"minLength": 1,
"type": "string"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_listing_truth",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"corrections": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"listing": {
"additionalProperties": {},
"properties": {
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amenities": {
"additionalProperties": false,
"properties": {
"balcony": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"elevator": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"furnished": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"garden": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"petsAllowed": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"stepFreeAccess": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"wheelchairAccessible": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"furnished",
"elevator",
"parking",
"balcony",
"garden",
"petsAllowed",
"stepFreeAccess",
"wheelchairAccessible"
],
"type": "object"
},
"areaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"availability": {
"additionalProperties": false,
"properties": {
"availableFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"moveInState": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"offerStatus": {
"enum": [
"available",
"under_offer",
"unknown"
],
"type": "string"
}
},
"required": [
"offerStatus",
"availableFrom",
"moveInState"
],
"type": "object"
},
"baths": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"charges": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"const": "EUR",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duplicates": {
"additionalProperties": false,
"properties": {
"confirmedOtherSources": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"confirmedSourceCount": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"confirmedOtherSources",
"confirmedSourceCount"
],
"type": "object"
},
"energyClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"features": {
"items": {
"type": "string"
},
"type": "array"
},
"fieldProvenance": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"source_structured",
"source_text",
"official_dataset",
"calculation",
"manual_review",
"model_extraction",
"model_only",
"unknown"
],
"type": "string"
},
"observedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"publisher": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sourceUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"confirmed",
"estimated",
"thin_sample",
"stale",
"context_only",
"conflicted",
"not_collected",
"source_unavailable",
"suppressed"
],
"type": "string"
}
},
"required": [
"status",
"publisher",
"method",
"sourceUrl",
"observedAt"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"hasSourceCheckedFacts": {
"type": "boolean"
},
"history": {
"additionalProperties": false,
"properties": {
"daysListed": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"firstObservedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"firstObservedBasis": {
"const": "source_listing_date_or_chathome_ingest",
"type": "string"
},
"lastChangedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"priceDropTotalEur": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"firstObservedAt",
"firstObservedBasis",
"daysListed",
"priceDropTotalEur",
"lastChangedAt"
],
"type": "object"
},
"id": {
"type": "string"
},
"imageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string"
},
"location": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"verified",
"unverified",
"contradicted",
"unknown"
],
"type": "string"
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"precision": {
"enum": [
"exact_address",
"street",
"district",
"commune_only",
"unknown"
],
"type": "string"
}
},
"required": [
"city",
"district",
"address",
"postalCode",
"precision",
"confidence"
],
"type": "object"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"match": {
"additionalProperties": false,
"properties": {
"allRequiredConstraintsSatisfied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"requiredConstraints": {
"items": {
"additionalProperties": false,
"properties": {
"actual": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"matched",
"not_matched",
"not_verified",
"not_applied"
],
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"status",
"target",
"actual"
],
"type": "object"
},
"type": "array"
},
"resultKind": {
"anyOf": [
{
"enum": [
"strict_match",
"partial_match",
"relaxed_alternative"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"allRequiredConstraintsSatisfied",
"resultKind",
"requiredConstraints",
"reasons"
],
"type": "object"
},
"matchReasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"officialScreening": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"photoUrls": {
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pricePerSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"property": {
"additionalProperties": false,
"properties": {
"airConditioning": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"colocation": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"completionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"constructionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasFloorplan": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"heatingEnergy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"heatingType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"landAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"privateRoomAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rentByOwner": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"rooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"totalFloors": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"rooms",
"floor",
"totalFloors",
"constructionYear",
"completionYear",
"landAreaSqm",
"privateRoomAreaSqm",
"condition",
"heatingType",
"heatingEnergy",
"airConditioning",
"hasFloorplan",
"rentByOwner",
"colocation"
],
"type": "object"
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyFee": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"agencyFeeBasis": {
"anyOf": [
{
"enum": [
"tenant_share",
"total_commission",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
]
},
"baseMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chargesIncluded": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"chargesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"deposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"depositExceedsMaximum": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"depositMaximum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotalIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"estimatedUtilitiesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"exactUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"firstChargeAdvance": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"heatingMayBeDoubleCounted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"indicativeInsuranceMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownMonthlyLowerBound": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"mandatoryRecurringFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryRecurringFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"monthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"monthlyTotalStatus": {
"anyOf": [
{
"enum": [
"known",
"unknown_charges",
"conflicting_charges",
"invalid_price",
"unknown_mandatory_recurring_fees"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportedDeposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unknownComponents": {
"items": {
"type": "string"
},
"type": "array"
},
"upfrontCostIsExact": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"upfrontCostIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"baseMonthly",
"chargesMonthly",
"chargesIncluded",
"monthlyTotal",
"monthlyTotalStatus",
"knownMonthlyLowerBound",
"estimatedMonthlyTotal",
"estimatedMonthlyTotalIsLowerBound",
"estimatedUtilitiesMonthly",
"indicativeInsuranceMonthly",
"heatingMayBeDoubleCounted",
"firstChargeAdvance",
"reportedDeposit",
"deposit",
"depositMaximum",
"depositExceedsMaximum",
"agencyFee",
"agencyFeeBasis",
"mandatoryRecurringFees",
"mandatoryRecurringFeeTotal",
"mandatoryMoveInFees",
"mandatoryMoveInFeeTotal",
"knownUpfrontCost",
"exactUpfrontCost",
"upfrontCostIsLowerBound",
"upfrontCostIsExact",
"unknownComponents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"schemaVersion": {
"const": "agent-listing.v2",
"type": "string"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"source": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyConfirmedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"agencyListingId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lastSeenAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"listingUrl": {
"format": "uri",
"type": "string"
},
"status": {
"enum": [
"active",
"under_offer",
"unknown"
],
"type": "string"
},
"statusBasis": {
"enum": [
"source_catalog_seen",
"listing_record_active"
],
"type": "string"
},
"type": {
"const": "original_agency_listing",
"type": "string"
}
},
"required": [
"type",
"agencyName",
"listingUrl",
"agencyListingId",
"lastSeenAt",
"status",
"statusBasis",
"agencyConfirmedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"const": "active",
"type": "string"
},
"title": {
"type": "string"
},
"transport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"unknown": {
"description": "Why each missingFields entry is unknown. not_in_search_result means get_listing may know it.",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"reason": {
"enum": [
"not_stated",
"not_proven",
"conflicted",
"not_in_search_result"
],
"type": "string"
}
},
"required": [
"field",
"reason"
],
"type": "object"
},
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
},
"valueContext": {
"additionalProperties": false,
"properties": {
"fairPrice": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"marketContext": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceIntegrity": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceIntegrity",
"fairPrice",
"marketContext"
],
"type": "object"
}
},
"required": [
"schemaVersion",
"id",
"url",
"title",
"status",
"price",
"currency",
"listingType",
"propertyType",
"city",
"district",
"country",
"beds",
"baths",
"areaSqm",
"energyClass",
"imageUrl",
"agencyName",
"source",
"rent",
"availability",
"property",
"location",
"history",
"duplicates",
"amenities",
"fieldProvenance",
"officialScreening",
"propertyChecks",
"transport",
"valueContext",
"missingFields",
"match",
"latitude",
"longitude"
],
"type": "object"
},
"listingPage": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"listingPageContext": {
"additionalProperties": false,
"properties": {
"commuteSummary": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"countryEvidence": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"familyAmenities": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"neighborhoodFacts": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"parcelDossier": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"passport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceEvolution": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceHistory": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"transitSummary": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceHistory",
"priceEvolution",
"familyAmenities",
"neighborhoodFacts",
"countryEvidence",
"transitSummary",
"commuteSummary",
"passport",
"propertyChecks",
"parcelDossier"
],
"type": "object"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"listing",
"listingPage",
"listingPageContext",
"corrections",
"trust"
],
"type": "object"
}
},
{
"description": "Get bounded, source-backed property context for a commune, with source dates and unknown states.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"commune": {
"description": "Luxembourg commune slug or name (e.g. 'luxembourg', 'esch-sur-alzette', 'kirchberg')",
"minLength": 1,
"type": "string"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
}
},
"required": [
"commune"
],
"type": "object"
},
"name": "get_market_context",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"commune": {
"type": "string"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"commune",
"trust"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"areaSqm": {
"description": "Living area in square metres",
"exclusiveMinimum": 0,
"type": "number"
},
"bedrooms": {
"description": "Number of bedrooms",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"commune": {
"description": "Luxembourg commune name or slug, e.g. 'luxembourg', 'esch-sur-alzette'",
"minLength": 1,
"type": "string"
},
"constructionYear": {
"description": "Year the property was built, e.g. 1995",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"energyClass": {
"description": "Energy performance certificate class, e.g. 'A', 'B', 'C'",
"type": "string"
},
"listingType": {
"description": "Whether the property is for rent or sale",
"enum": [
"rent",
"sale"
],
"type": "string"
},
"propertyType": {
"description": "Property type, e.g. 'apartment', 'house', 'studio', 'penthouse'",
"minLength": 1,
"type": "string"
}
},
"required": [
"propertyType",
"listingType",
"commune",
"areaSqm"
],
"type": "object"
},
"name": "get_price_estimate",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"areaSqm": {
"type": "number"
},
"commune": {
"type": "string"
},
"estimatedPrice": {
"type": "number"
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string"
},
"propertyType": {
"type": "string"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"propertyType",
"listingType",
"commune",
"areaSqm",
"trust"
],
"type": "object"
}
},
{
"description": "Get every estate agency with active listings in a supported Luxembourg town, including current buy/rent stock and asking-price ranges.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"commune": {
"description": "One of the supported Luxembourg town names or slugs, e.g. 'Mersch' or 'esch-sur-alzette'",
"minLength": 1,
"type": "string"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
}
},
"required": [
"commune"
],
"type": "object"
},
"name": "get_town_agencies",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"activeListings": {
"type": "number"
},
"agencies": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"agencyCount": {
"type": "number"
},
"buyListings": {
"type": "number"
},
"commune": {
"type": "string"
},
"communeSlug": {
"type": "string"
},
"localityId": {
"type": "string"
},
"measuredAt": {
"type": "string"
},
"pageUrl": {
"type": "string"
},
"rentListings": {
"type": "number"
},
"source": {
"type": "string"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
},
"unclassifiedListings": {
"type": "number"
}
},
"required": [
"commune",
"communeSlug",
"localityId",
"measuredAt",
"source",
"activeListings",
"buyListings",
"rentListings",
"unclassifiedListings",
"agencyCount",
"agencies",
"pageUrl",
"trust"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"heading": {
"description": "Short user-facing heading grounded in the search request",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"listings": {
"description": "One to eight exact listing IDs from search_vibe, search_rentals, or search_for_sale, in display order",
"items": {
"properties": {
"id": {
"description": "Exact listing ID copied from a prior search result",
"minLength": 1,
"type": "string"
},
"matchReasons": {
"description": "Exact match reasons returned by search_vibe",
"items": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"score": {
"description": "Exact match score returned by search_vibe",
"maximum": 100,
"minimum": 0,
"type": "number"
}
},
"required": [
"id"
],
"type": "object"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
}
},
"required": [
"listings"
],
"type": "object"
},
"name": "render_listing_cards",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"countKind": {
"const": "returned",
"type": "string"
},
"excludedUnprovenCount": {
"description": "Upstream rows omitted because public facts could not prove every requested hard filter.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"followUp": {
"additionalProperties": false,
"properties": {
"outcome": {
"enum": [
"applied",
"answered"
],
"type": "string"
},
"reply": {
"type": "string"
}
},
"required": [
"outcome"
],
"type": "object"
},
"hasMore": {
"type": "boolean"
},
"listings": {
"items": {
"additionalProperties": {},
"properties": {
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amenities": {
"additionalProperties": false,
"properties": {
"balcony": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"elevator": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"furnished": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"garden": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"petsAllowed": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"stepFreeAccess": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"wheelchairAccessible": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"furnished",
"elevator",
"parking",
"balcony",
"garden",
"petsAllowed",
"stepFreeAccess",
"wheelchairAccessible"
],
"type": "object"
},
"areaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"availability": {
"additionalProperties": false,
"properties": {
"availableFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"moveInState": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"offerStatus": {
"enum": [
"available",
"under_offer",
"unknown"
],
"type": "string"
}
},
"required": [
"offerStatus",
"availableFrom",
"moveInState"
],
"type": "object"
},
"baths": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"charges": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"const": "EUR",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duplicates": {
"additionalProperties": false,
"properties": {
"confirmedOtherSources": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"confirmedSourceCount": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"confirmedOtherSources",
"confirmedSourceCount"
],
"type": "object"
},
"energyClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"features": {
"items": {
"type": "string"
},
"type": "array"
},
"fieldProvenance": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"source_structured",
"source_text",
"official_dataset",
"calculation",
"manual_review",
"model_extraction",
"model_only",
"unknown"
],
"type": "string"
},
"observedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"publisher": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sourceUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"confirmed",
"estimated",
"thin_sample",
"stale",
"context_only",
"conflicted",
"not_collected",
"source_unavailable",
"suppressed"
],
"type": "string"
}
},
"required": [
"status",
"publisher",
"method",
"sourceUrl",
"observedAt"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"hasSourceCheckedFacts": {
"type": "boolean"
},
"history": {
"additionalProperties": false,
"properties": {
"daysListed": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"firstObservedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"firstObservedBasis": {
"const": "source_listing_date_or_chathome_ingest",
"type": "string"
},
"lastChangedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"priceDropTotalEur": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"firstObservedAt",
"firstObservedBasis",
"daysListed",
"priceDropTotalEur",
"lastChangedAt"
],
"type": "object"
},
"id": {
"type": "string"
},
"imageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string"
},
"location": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"verified",
"unverified",
"contradicted",
"unknown"
],
"type": "string"
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"precision": {
"enum": [
"exact_address",
"street",
"district",
"commune_only",
"unknown"
],
"type": "string"
}
},
"required": [
"city",
"district",
"address",
"postalCode",
"precision",
"confidence"
],
"type": "object"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"match": {
"additionalProperties": false,
"properties": {
"allRequiredConstraintsSatisfied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"requiredConstraints": {
"items": {
"additionalProperties": false,
"properties": {
"actual": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"matched",
"not_matched",
"not_verified",
"not_applied"
],
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"status",
"target",
"actual"
],
"type": "object"
},
"type": "array"
},
"resultKind": {
"anyOf": [
{
"enum": [
"strict_match",
"partial_match",
"relaxed_alternative"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"allRequiredConstraintsSatisfied",
"resultKind",
"requiredConstraints",
"reasons"
],
"type": "object"
},
"matchReasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"officialScreening": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"photoUrls": {
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pricePerSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"property": {
"additionalProperties": false,
"properties": {
"airConditioning": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"colocation": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"completionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"constructionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasFloorplan": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"heatingEnergy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"heatingType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"landAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"privateRoomAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rentByOwner": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"rooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"totalFloors": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"rooms",
"floor",
"totalFloors",
"constructionYear",
"completionYear",
"landAreaSqm",
"privateRoomAreaSqm",
"condition",
"heatingType",
"heatingEnergy",
"airConditioning",
"hasFloorplan",
"rentByOwner",
"colocation"
],
"type": "object"
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyFee": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"agencyFeeBasis": {
"anyOf": [
{
"enum": [
"tenant_share",
"total_commission",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
]
},
"baseMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chargesIncluded": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"chargesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"deposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"depositExceedsMaximum": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"depositMaximum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotalIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"estimatedUtilitiesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"exactUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"firstChargeAdvance": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"heatingMayBeDoubleCounted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"indicativeInsuranceMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownMonthlyLowerBound": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"mandatoryRecurringFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryRecurringFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"monthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"monthlyTotalStatus": {
"anyOf": [
{
"enum": [
"known",
"unknown_charges",
"conflicting_charges",
"invalid_price",
"unknown_mandatory_recurring_fees"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportedDeposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unknownComponents": {
"items": {
"type": "string"
},
"type": "array"
},
"upfrontCostIsExact": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"upfrontCostIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"baseMonthly",
"chargesMonthly",
"chargesIncluded",
"monthlyTotal",
"monthlyTotalStatus",
"knownMonthlyLowerBound",
"estimatedMonthlyTotal",
"estimatedMonthlyTotalIsLowerBound",
"estimatedUtilitiesMonthly",
"indicativeInsuranceMonthly",
"heatingMayBeDoubleCounted",
"firstChargeAdvance",
"reportedDeposit",
"deposit",
"depositMaximum",
"depositExceedsMaximum",
"agencyFee",
"agencyFeeBasis",
"mandatoryRecurringFees",
"mandatoryRecurringFeeTotal",
"mandatoryMoveInFees",
"mandatoryMoveInFeeTotal",
"knownUpfrontCost",
"exactUpfrontCost",
"upfrontCostIsLowerBound",
"upfrontCostIsExact",
"unknownComponents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"schemaVersion": {
"const": "agent-listing.v2",
"type": "string"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"source": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyConfirmedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"agencyListingId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lastSeenAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"listingUrl": {
"format": "uri",
"type": "string"
},
"status": {
"enum": [
"active",
"under_offer",
"unknown"
],
"type": "string"
},
"statusBasis": {
"enum": [
"source_catalog_seen",
"listing_record_active"
],
"type": "string"
},
"type": {
"const": "original_agency_listing",
"type": "string"
}
},
"required": [
"type",
"agencyName",
"listingUrl",
"agencyListingId",
"lastSeenAt",
"status",
"statusBasis",
"agencyConfirmedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"const": "active",
"type": "string"
},
"title": {
"type": "string"
},
"transport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"unknown": {
"description": "Why each missingFields entry is unknown. not_in_search_result means get_listing may know it.",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"reason": {
"enum": [
"not_stated",
"not_proven",
"conflicted",
"not_in_search_result"
],
"type": "string"
}
},
"required": [
"field",
"reason"
],
"type": "object"
},
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
},
"valueContext": {
"additionalProperties": false,
"properties": {
"fairPrice": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"marketContext": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceIntegrity": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceIntegrity",
"fairPrice",
"marketContext"
],
"type": "object"
}
},
"required": [
"schemaVersion",
"id",
"url",
"title",
"status",
"price",
"currency",
"listingType",
"propertyType",
"city",
"district",
"country",
"beds",
"baths",
"areaSqm",
"energyClass",
"imageUrl",
"agencyName",
"source",
"rent",
"availability",
"property",
"location",
"history",
"duplicates",
"amenities",
"fieldProvenance",
"officialScreening",
"propertyChecks",
"transport",
"valueContext",
"missingFields",
"match",
"latitude",
"longitude"
],
"type": "object"
},
"type": "array"
},
"marketMatchingUpperBound": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"matchingCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"matchingCountKind": {
"enum": [
"exact",
"lower_bound",
"unavailable"
],
"type": "string"
},
"nextCursor": {
"type": "null"
},
"note": {
"type": "string"
},
"ranking": {
"additionalProperties": false,
"properties": {
"planFingerprint": {
"type": "string"
},
"probability": {
"const": false,
"type": "boolean"
},
"scoreKind": {
"const": "request_fit",
"type": "string"
},
"status": {
"enum": [
"available",
"degraded"
],
"type": "string"
}
},
"required": [
"status",
"scoreKind",
"probability"
],
"type": "object"
},
"returnedCount": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"searchExhaustive": {
"type": "boolean"
},
"session": {
"additionalProperties": false,
"properties": {
"brief": {
"additionalProperties": {},
"properties": {},
"type": "object"
}
},
"required": [
"brief"
],
"type": "object"
},
"source": {
"type": "string"
},
"total": {
"description": "Exact number of listing objects returned in this response; not the number of matches in the market.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
},
"understanding": {
"additionalProperties": false,
"description": "What the engine understood from the request. notChecked lists wishes no returned home is confirmed to have.",
"properties": {
"checked": {
"items": {
"additionalProperties": false,
"properties": {
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"meaning": {
"type": "string"
},
"needId": {
"type": "string"
},
"operator": {
"type": "string"
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"value": {
"anyOf": [
{
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
{
"type": "null"
}
]
}
},
"required": [
"meaning",
"needId",
"operator",
"value",
"unit",
"force"
],
"type": "object"
},
"type": "array"
},
"commutes": {
"items": {
"additionalProperties": false,
"properties": {
"destination": {
"type": "string"
},
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"maxMinutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mode": {
"anyOf": [
{
"enum": [
"transit",
"drive",
"walk",
"bike"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"destination",
"mode",
"maxMinutes",
"force"
],
"type": "object"
},
"type": "array"
},
"excludedPropertyTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"notChecked": {
"items": {
"additionalProperties": false,
"properties": {
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"meaning": {
"type": "string"
},
"reason": {
"enum": [
"no_listing_fact",
"fact_not_collected_yet"
],
"type": "string"
}
},
"required": [
"meaning",
"force",
"reason"
],
"type": "object"
},
"type": "array"
},
"offer": {
"enum": [
"whole",
"room",
"either"
],
"type": "string"
},
"places": {
"items": {
"additionalProperties": false,
"properties": {
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"radiusKm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"role": {
"enum": [
"live",
"work",
"near",
"avoid"
],
"type": "string"
}
},
"required": [
"name",
"role",
"kind",
"country",
"radiusKm",
"force"
],
"type": "object"
},
"type": "array"
},
"propertyTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"transaction": {
"anyOf": [
{
"enum": [
"buy",
"rent"
],
"type": "string"
},
{
"type": "null"
}
]
},
"understood": {
"type": "string"
}
},
"required": [
"understood",
"transaction",
"propertyTypes",
"excludedPropertyTypes",
"offer",
"places",
"commutes",
"checked",
"notChecked"
],
"type": "object"
}
},
"required": [
"listings",
"total"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"balcony": {
"const": true,
"description": "Require a source-confirmed balcony",
"type": "boolean"
},
"commune": {
"description": "Luxembourg commune name or slug",
"type": "string"
},
"elevator": {
"const": true,
"description": "Require lift/elevator evidence",
"type": "boolean"
},
"furnished": {
"const": true,
"description": "Require furnished evidence",
"type": "boolean"
},
"garden": {
"const": true,
"description": "Require a source-confirmed garden",
"type": "boolean"
},
"includePhotos": {
"description": "Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response.",
"type": "boolean"
},
"limit": {
"description": "Number of results to return (max 50, default 20)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
},
"maxAreaSqm": {
"description": "Maximum area in m²",
"type": "number"
},
"maxPrice": {
"description": "Maximum sale price in EUR",
"type": "number"
},
"minAreaSqm": {
"description": "Minimum area in m²",
"type": "number"
},
"minBathrooms": {
"description": "Minimum number of bathrooms",
"type": "number"
},
"minBeds": {
"description": "Minimum number of bedrooms",
"type": "number"
},
"minPrice": {
"description": "Minimum sale price in EUR",
"type": "number"
},
"parkingType": {
"description": "Require source-backed parking evidence",
"enum": [
"off_street",
"garage",
"covered"
],
"type": "string"
},
"petsAllowed": {
"const": true,
"description": "Require pets-allowed evidence",
"type": "boolean"
},
"propertyType": {
"description": "Property type: apartment, house, villa, etc.",
"type": "string"
},
"sort": {
"description": "Sort by relevance, listing date, or asking price",
"enum": [
"relevance",
"newest",
"price-asc",
"price-desc"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_for_sale",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"countKind": {
"const": "returned",
"type": "string"
},
"excludedUnprovenCount": {
"description": "Upstream rows omitted because public facts could not prove every requested hard filter.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"followUp": {
"additionalProperties": false,
"properties": {
"outcome": {
"enum": [
"applied",
"answered"
],
"type": "string"
},
"reply": {
"type": "string"
}
},
"required": [
"outcome"
],
"type": "object"
},
"hasMore": {
"type": "boolean"
},
"listings": {
"items": {
"additionalProperties": {},
"properties": {
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amenities": {
"additionalProperties": false,
"properties": {
"balcony": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"elevator": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"furnished": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"garden": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"petsAllowed": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"stepFreeAccess": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"wheelchairAccessible": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"furnished",
"elevator",
"parking",
"balcony",
"garden",
"petsAllowed",
"stepFreeAccess",
"wheelchairAccessible"
],
"type": "object"
},
"areaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"availability": {
"additionalProperties": false,
"properties": {
"availableFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"moveInState": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"offerStatus": {
"enum": [
"available",
"under_offer",
"unknown"
],
"type": "string"
}
},
"required": [
"offerStatus",
"availableFrom",
"moveInState"
],
"type": "object"
},
"baths": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"charges": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"const": "EUR",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duplicates": {
"additionalProperties": false,
"properties": {
"confirmedOtherSources": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"confirmedSourceCount": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"confirmedOtherSources",
"confirmedSourceCount"
],
"type": "object"
},
"energyClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"features": {
"items": {
"type": "string"
},
"type": "array"
},
"fieldProvenance": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"source_structured",
"source_text",
"official_dataset",
"calculation",
"manual_review",
"model_extraction",
"model_only",
"unknown"
],
"type": "string"
},
"observedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"publisher": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sourceUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"confirmed",
"estimated",
"thin_sample",
"stale",
"context_only",
"conflicted",
"not_collected",
"source_unavailable",
"suppressed"
],
"type": "string"
}
},
"required": [
"status",
"publisher",
"method",
"sourceUrl",
"observedAt"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"hasSourceCheckedFacts": {
"type": "boolean"
},
"history": {
"additionalProperties": false,
"properties": {
"daysListed": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"firstObservedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"firstObservedBasis": {
"const": "source_listing_date_or_chathome_ingest",
"type": "string"
},
"lastChangedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"priceDropTotalEur": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"firstObservedAt",
"firstObservedBasis",
"daysListed",
"priceDropTotalEur",
"lastChangedAt"
],
"type": "object"
},
"id": {
"type": "string"
},
"imageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string"
},
"location": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"verified",
"unverified",
"contradicted",
"unknown"
],
"type": "string"
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"precision": {
"enum": [
"exact_address",
"street",
"district",
"commune_only",
"unknown"
],
"type": "string"
}
},
"required": [
"city",
"district",
"address",
"postalCode",
"precision",
"confidence"
],
"type": "object"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"match": {
"additionalProperties": false,
"properties": {
"allRequiredConstraintsSatisfied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"requiredConstraints": {
"items": {
"additionalProperties": false,
"properties": {
"actual": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"matched",
"not_matched",
"not_verified",
"not_applied"
],
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"status",
"target",
"actual"
],
"type": "object"
},
"type": "array"
},
"resultKind": {
"anyOf": [
{
"enum": [
"strict_match",
"partial_match",
"relaxed_alternative"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"allRequiredConstraintsSatisfied",
"resultKind",
"requiredConstraints",
"reasons"
],
"type": "object"
},
"matchReasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"officialScreening": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"photoUrls": {
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pricePerSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"property": {
"additionalProperties": false,
"properties": {
"airConditioning": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"colocation": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"completionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"constructionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasFloorplan": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"heatingEnergy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"heatingType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"landAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"privateRoomAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rentByOwner": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"rooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"totalFloors": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"rooms",
"floor",
"totalFloors",
"constructionYear",
"completionYear",
"landAreaSqm",
"privateRoomAreaSqm",
"condition",
"heatingType",
"heatingEnergy",
"airConditioning",
"hasFloorplan",
"rentByOwner",
"colocation"
],
"type": "object"
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyFee": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"agencyFeeBasis": {
"anyOf": [
{
"enum": [
"tenant_share",
"total_commission",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
]
},
"baseMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chargesIncluded": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"chargesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"deposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"depositExceedsMaximum": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"depositMaximum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotalIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"estimatedUtilitiesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"exactUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"firstChargeAdvance": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"heatingMayBeDoubleCounted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"indicativeInsuranceMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownMonthlyLowerBound": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"mandatoryRecurringFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryRecurringFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"monthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"monthlyTotalStatus": {
"anyOf": [
{
"enum": [
"known",
"unknown_charges",
"conflicting_charges",
"invalid_price",
"unknown_mandatory_recurring_fees"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportedDeposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unknownComponents": {
"items": {
"type": "string"
},
"type": "array"
},
"upfrontCostIsExact": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"upfrontCostIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"baseMonthly",
"chargesMonthly",
"chargesIncluded",
"monthlyTotal",
"monthlyTotalStatus",
"knownMonthlyLowerBound",
"estimatedMonthlyTotal",
"estimatedMonthlyTotalIsLowerBound",
"estimatedUtilitiesMonthly",
"indicativeInsuranceMonthly",
"heatingMayBeDoubleCounted",
"firstChargeAdvance",
"reportedDeposit",
"deposit",
"depositMaximum",
"depositExceedsMaximum",
"agencyFee",
"agencyFeeBasis",
"mandatoryRecurringFees",
"mandatoryRecurringFeeTotal",
"mandatoryMoveInFees",
"mandatoryMoveInFeeTotal",
"knownUpfrontCost",
"exactUpfrontCost",
"upfrontCostIsLowerBound",
"upfrontCostIsExact",
"unknownComponents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"schemaVersion": {
"const": "agent-listing.v2",
"type": "string"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"source": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyConfirmedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"agencyListingId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lastSeenAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"listingUrl": {
"format": "uri",
"type": "string"
},
"status": {
"enum": [
"active",
"under_offer",
"unknown"
],
"type": "string"
},
"statusBasis": {
"enum": [
"source_catalog_seen",
"listing_record_active"
],
"type": "string"
},
"type": {
"const": "original_agency_listing",
"type": "string"
}
},
"required": [
"type",
"agencyName",
"listingUrl",
"agencyListingId",
"lastSeenAt",
"status",
"statusBasis",
"agencyConfirmedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"const": "active",
"type": "string"
},
"title": {
"type": "string"
},
"transport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"unknown": {
"description": "Why each missingFields entry is unknown. not_in_search_result means get_listing may know it.",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"reason": {
"enum": [
"not_stated",
"not_proven",
"conflicted",
"not_in_search_result"
],
"type": "string"
}
},
"required": [
"field",
"reason"
],
"type": "object"
},
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
},
"valueContext": {
"additionalProperties": false,
"properties": {
"fairPrice": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"marketContext": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceIntegrity": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceIntegrity",
"fairPrice",
"marketContext"
],
"type": "object"
}
},
"required": [
"schemaVersion",
"id",
"url",
"title",
"status",
"price",
"currency",
"listingType",
"propertyType",
"city",
"district",
"country",
"beds",
"baths",
"areaSqm",
"energyClass",
"imageUrl",
"agencyName",
"source",
"rent",
"availability",
"property",
"location",
"history",
"duplicates",
"amenities",
"fieldProvenance",
"officialScreening",
"propertyChecks",
"transport",
"valueContext",
"missingFields",
"match",
"latitude",
"longitude"
],
"type": "object"
},
"type": "array"
},
"marketMatchingUpperBound": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"matchingCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"matchingCountKind": {
"enum": [
"exact",
"lower_bound",
"unavailable"
],
"type": "string"
},
"nextCursor": {
"type": "null"
},
"note": {
"type": "string"
},
"ranking": {
"additionalProperties": false,
"properties": {
"planFingerprint": {
"type": "string"
},
"probability": {
"const": false,
"type": "boolean"
},
"scoreKind": {
"const": "request_fit",
"type": "string"
},
"status": {
"enum": [
"available",
"degraded"
],
"type": "string"
}
},
"required": [
"status",
"scoreKind",
"probability"
],
"type": "object"
},
"returnedCount": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"searchExhaustive": {
"type": "boolean"
},
"session": {
"additionalProperties": false,
"properties": {
"brief": {
"additionalProperties": {},
"properties": {},
"type": "object"
}
},
"required": [
"brief"
],
"type": "object"
},
"source": {
"type": "string"
},
"total": {
"description": "Exact number of listing objects returned in this response; not the number of matches in the market.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
},
"understanding": {
"additionalProperties": false,
"description": "What the engine understood from the request. notChecked lists wishes no returned home is confirmed to have.",
"properties": {
"checked": {
"items": {
"additionalProperties": false,
"properties": {
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"meaning": {
"type": "string"
},
"needId": {
"type": "string"
},
"operator": {
"type": "string"
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"value": {
"anyOf": [
{
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
{
"type": "null"
}
]
}
},
"required": [
"meaning",
"needId",
"operator",
"value",
"unit",
"force"
],
"type": "object"
},
"type": "array"
},
"commutes": {
"items": {
"additionalProperties": false,
"properties": {
"destination": {
"type": "string"
},
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"maxMinutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mode": {
"anyOf": [
{
"enum": [
"transit",
"drive",
"walk",
"bike"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"destination",
"mode",
"maxMinutes",
"force"
],
"type": "object"
},
"type": "array"
},
"excludedPropertyTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"notChecked": {
"items": {
"additionalProperties": false,
"properties": {
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"meaning": {
"type": "string"
},
"reason": {
"enum": [
"no_listing_fact",
"fact_not_collected_yet"
],
"type": "string"
}
},
"required": [
"meaning",
"force",
"reason"
],
"type": "object"
},
"type": "array"
},
"offer": {
"enum": [
"whole",
"room",
"either"
],
"type": "string"
},
"places": {
"items": {
"additionalProperties": false,
"properties": {
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"radiusKm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"role": {
"enum": [
"live",
"work",
"near",
"avoid"
],
"type": "string"
}
},
"required": [
"name",
"role",
"kind",
"country",
"radiusKm",
"force"
],
"type": "object"
},
"type": "array"
},
"propertyTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"transaction": {
"anyOf": [
{
"enum": [
"buy",
"rent"
],
"type": "string"
},
{
"type": "null"
}
]
},
"understood": {
"type": "string"
}
},
"required": [
"understood",
"transaction",
"propertyTypes",
"excludedPropertyTypes",
"offer",
"places",
"commutes",
"checked",
"notChecked"
],
"type": "object"
}
},
"required": [
"listings",
"total"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"balcony": {
"const": true,
"description": "Require a source-confirmed balcony",
"type": "boolean"
},
"commune": {
"description": "Luxembourg commune name or slug",
"type": "string"
},
"elevator": {
"const": true,
"description": "Require positive source evidence of a lift/elevator",
"type": "boolean"
},
"furnished": {
"const": true,
"description": "Require positive source evidence that the rental is furnished",
"type": "boolean"
},
"garden": {
"const": true,
"description": "Require a source-confirmed garden",
"type": "boolean"
},
"includePhotos": {
"description": "Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response.",
"type": "boolean"
},
"limit": {
"description": "Number of results to return (max 50, default 20)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
},
"maxAreaSqm": {
"description": "Maximum area in m²",
"type": "number"
},
"maxPrice": {
"description": "Maximum advertised base monthly rent in EUR, excluding separate charges",
"type": "number"
},
"maxTotalMonthly": {
"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.",
"type": "number"
},
"minAreaSqm": {
"description": "Minimum area in m²",
"type": "number"
},
"minBathrooms": {
"description": "Minimum number of bathrooms",
"type": "number"
},
"minBeds": {
"description": "Minimum number of bedrooms",
"type": "number"
},
"minPrice": {
"description": "Minimum monthly rent in EUR",
"type": "number"
},
"parkingType": {
"description": "Require source-backed parking evidence",
"enum": [
"off_street",
"garage",
"covered"
],
"type": "string"
},
"petsAllowed": {
"const": true,
"description": "Require positive source evidence that pets are allowed",
"type": "boolean"
},
"propertyType": {
"description": "Property type: apartment, house, studio, room, etc.",
"type": "string"
},
"sort": {
"description": "Sort the proven result set. price-asc means base rent, not all-in monthly cost.",
"enum": [
"relevance",
"newest",
"price-asc",
"price-desc"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_rentals",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"countKind": {
"const": "returned",
"type": "string"
},
"excludedUnprovenCount": {
"description": "Upstream rows omitted because public facts could not prove every requested hard filter.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"followUp": {
"additionalProperties": false,
"properties": {
"outcome": {
"enum": [
"applied",
"answered"
],
"type": "string"
},
"reply": {
"type": "string"
}
},
"required": [
"outcome"
],
"type": "object"
},
"hasMore": {
"type": "boolean"
},
"listings": {
"items": {
"additionalProperties": {},
"properties": {
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amenities": {
"additionalProperties": false,
"properties": {
"balcony": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"elevator": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"furnished": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"garden": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"petsAllowed": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"stepFreeAccess": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"wheelchairAccessible": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"furnished",
"elevator",
"parking",
"balcony",
"garden",
"petsAllowed",
"stepFreeAccess",
"wheelchairAccessible"
],
"type": "object"
},
"areaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"availability": {
"additionalProperties": false,
"properties": {
"availableFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"moveInState": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"offerStatus": {
"enum": [
"available",
"under_offer",
"unknown"
],
"type": "string"
}
},
"required": [
"offerStatus",
"availableFrom",
"moveInState"
],
"type": "object"
},
"baths": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"charges": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"const": "EUR",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duplicates": {
"additionalProperties": false,
"properties": {
"confirmedOtherSources": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"confirmedSourceCount": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"confirmedOtherSources",
"confirmedSourceCount"
],
"type": "object"
},
"energyClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"features": {
"items": {
"type": "string"
},
"type": "array"
},
"fieldProvenance": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"source_structured",
"source_text",
"official_dataset",
"calculation",
"manual_review",
"model_extraction",
"model_only",
"unknown"
],
"type": "string"
},
"observedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"publisher": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sourceUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"confirmed",
"estimated",
"thin_sample",
"stale",
"context_only",
"conflicted",
"not_collected",
"source_unavailable",
"suppressed"
],
"type": "string"
}
},
"required": [
"status",
"publisher",
"method",
"sourceUrl",
"observedAt"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"hasSourceCheckedFacts": {
"type": "boolean"
},
"history": {
"additionalProperties": false,
"properties": {
"daysListed": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"firstObservedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"firstObservedBasis": {
"const": "source_listing_date_or_chathome_ingest",
"type": "string"
},
"lastChangedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"priceDropTotalEur": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"firstObservedAt",
"firstObservedBasis",
"daysListed",
"priceDropTotalEur",
"lastChangedAt"
],
"type": "object"
},
"id": {
"type": "string"
},
"imageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string"
},
"location": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"verified",
"unverified",
"contradicted",
"unknown"
],
"type": "string"
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"precision": {
"enum": [
"exact_address",
"street",
"district",
"commune_only",
"unknown"
],
"type": "string"
}
},
"required": [
"city",
"district",
"address",
"postalCode",
"precision",
"confidence"
],
"type": "object"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"match": {
"additionalProperties": false,
"properties": {
"allRequiredConstraintsSatisfied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"requiredConstraints": {
"items": {
"additionalProperties": false,
"properties": {
"actual": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"matched",
"not_matched",
"not_verified",
"not_applied"
],
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"status",
"target",
"actual"
],
"type": "object"
},
"type": "array"
},
"resultKind": {
"anyOf": [
{
"enum": [
"strict_match",
"partial_match",
"relaxed_alternative"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"allRequiredConstraintsSatisfied",
"resultKind",
"requiredConstraints",
"reasons"
],
"type": "object"
},
"matchReasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"officialScreening": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"photoUrls": {
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pricePerSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"property": {
"additionalProperties": false,
"properties": {
"airConditioning": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"colocation": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"completionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"constructionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasFloorplan": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"heatingEnergy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"heatingType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"landAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"privateRoomAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rentByOwner": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"rooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"totalFloors": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"rooms",
"floor",
"totalFloors",
"constructionYear",
"completionYear",
"landAreaSqm",
"privateRoomAreaSqm",
"condition",
"heatingType",
"heatingEnergy",
"airConditioning",
"hasFloorplan",
"rentByOwner",
"colocation"
],
"type": "object"
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyFee": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"agencyFeeBasis": {
"anyOf": [
{
"enum": [
"tenant_share",
"total_commission",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
]
},
"baseMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chargesIncluded": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"chargesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"deposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"depositExceedsMaximum": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"depositMaximum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotalIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"estimatedUtilitiesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"exactUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"firstChargeAdvance": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"heatingMayBeDoubleCounted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"indicativeInsuranceMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownMonthlyLowerBound": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"mandatoryRecurringFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryRecurringFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"monthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"monthlyTotalStatus": {
"anyOf": [
{
"enum": [
"known",
"unknown_charges",
"conflicting_charges",
"invalid_price",
"unknown_mandatory_recurring_fees"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportedDeposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unknownComponents": {
"items": {
"type": "string"
},
"type": "array"
},
"upfrontCostIsExact": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"upfrontCostIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"baseMonthly",
"chargesMonthly",
"chargesIncluded",
"monthlyTotal",
"monthlyTotalStatus",
"knownMonthlyLowerBound",
"estimatedMonthlyTotal",
"estimatedMonthlyTotalIsLowerBound",
"estimatedUtilitiesMonthly",
"indicativeInsuranceMonthly",
"heatingMayBeDoubleCounted",
"firstChargeAdvance",
"reportedDeposit",
"deposit",
"depositMaximum",
"depositExceedsMaximum",
"agencyFee",
"agencyFeeBasis",
"mandatoryRecurringFees",
"mandatoryRecurringFeeTotal",
"mandatoryMoveInFees",
"mandatoryMoveInFeeTotal",
"knownUpfrontCost",
"exactUpfrontCost",
"upfrontCostIsLowerBound",
"upfrontCostIsExact",
"unknownComponents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"schemaVersion": {
"const": "agent-listing.v2",
"type": "string"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"source": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyConfirmedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"agencyListingId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lastSeenAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"listingUrl": {
"format": "uri",
"type": "string"
},
"status": {
"enum": [
"active",
"under_offer",
"unknown"
],
"type": "string"
},
"statusBasis": {
"enum": [
"source_catalog_seen",
"listing_record_active"
],
"type": "string"
},
"type": {
"const": "original_agency_listing",
"type": "string"
}
},
"required": [
"type",
"agencyName",
"listingUrl",
"agencyListingId",
"lastSeenAt",
"status",
"statusBasis",
"agencyConfirmedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"const": "active",
"type": "string"
},
"title": {
"type": "string"
},
"transport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"unknown": {
"description": "Why each missingFields entry is unknown. not_in_search_result means get_listing may know it.",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"reason": {
"enum": [
"not_stated",
"not_proven",
"conflicted",
"not_in_search_result"
],
"type": "string"
}
},
"required": [
"field",
"reason"
],
"type": "object"
},
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
},
"valueContext": {
"additionalProperties": false,
"properties": {
"fairPrice": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"marketContext": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceIntegrity": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceIntegrity",
"fairPrice",
"marketContext"
],
"type": "object"
}
},
"required": [
"schemaVersion",
"id",
"url",
"title",
"status",
"price",
"currency",
"listingType",
"propertyType",
"city",
"district",
"country",
"beds",
"baths",
"areaSqm",
"energyClass",
"imageUrl",
"agencyName",
"source",
"rent",
"availability",
"property",
"location",
"history",
"duplicates",
"amenities",
"fieldProvenance",
"officialScreening",
"propertyChecks",
"transport",
"valueContext",
"missingFields",
"match",
"latitude",
"longitude"
],
"type": "object"
},
"type": "array"
},
"marketMatchingUpperBound": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"matchingCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"matchingCountKind": {
"enum": [
"exact",
"lower_bound",
"unavailable"
],
"type": "string"
},
"nextCursor": {
"type": "null"
},
"note": {
"type": "string"
},
"ranking": {
"additionalProperties": false,
"properties": {
"planFingerprint": {
"type": "string"
},
"probability": {
"const": false,
"type": "boolean"
},
"scoreKind": {
"const": "request_fit",
"type": "string"
},
"status": {
"enum": [
"available",
"degraded"
],
"type": "string"
}
},
"required": [
"status",
"scoreKind",
"probability"
],
"type": "object"
},
"returnedCount": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"searchExhaustive": {
"type": "boolean"
},
"session": {
"additionalProperties": false,
"properties": {
"brief": {
"additionalProperties": {},
"properties": {},
"type": "object"
}
},
"required": [
"brief"
],
"type": "object"
},
"source": {
"type": "string"
},
"total": {
"description": "Exact number of listing objects returned in this response; not the number of matches in the market.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
},
"understanding": {
"additionalProperties": false,
"description": "What the engine understood from the request. notChecked lists wishes no returned home is confirmed to have.",
"properties": {
"checked": {
"items": {
"additionalProperties": false,
"properties": {
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"meaning": {
"type": "string"
},
"needId": {
"type": "string"
},
"operator": {
"type": "string"
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"value": {
"anyOf": [
{
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
{
"type": "null"
}
]
}
},
"required": [
"meaning",
"needId",
"operator",
"value",
"unit",
"force"
],
"type": "object"
},
"type": "array"
},
"commutes": {
"items": {
"additionalProperties": false,
"properties": {
"destination": {
"type": "string"
},
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"maxMinutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mode": {
"anyOf": [
{
"enum": [
"transit",
"drive",
"walk",
"bike"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"destination",
"mode",
"maxMinutes",
"force"
],
"type": "object"
},
"type": "array"
},
"excludedPropertyTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"notChecked": {
"items": {
"additionalProperties": false,
"properties": {
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"meaning": {
"type": "string"
},
"reason": {
"enum": [
"no_listing_fact",
"fact_not_collected_yet"
],
"type": "string"
}
},
"required": [
"meaning",
"force",
"reason"
],
"type": "object"
},
"type": "array"
},
"offer": {
"enum": [
"whole",
"room",
"either"
],
"type": "string"
},
"places": {
"items": {
"additionalProperties": false,
"properties": {
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"radiusKm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"role": {
"enum": [
"live",
"work",
"near",
"avoid"
],
"type": "string"
}
},
"required": [
"name",
"role",
"kind",
"country",
"radiusKm",
"force"
],
"type": "object"
},
"type": "array"
},
"propertyTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"transaction": {
"anyOf": [
{
"enum": [
"buy",
"rent"
],
"type": "string"
},
{
"type": "null"
}
]
},
"understood": {
"type": "string"
}
},
"required": [
"understood",
"transaction",
"propertyTypes",
"excludedPropertyTypes",
"offer",
"places",
"commutes",
"checked",
"notChecked"
],
"type": "object"
}
},
"required": [
"listings",
"total"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"brief": {
"additionalProperties": {},
"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"
},
"type": "object"
},
"followUp": {
"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`.",
"maxLength": 800,
"minLength": 1,
"type": "string"
},
"includePhotos": {
"description": "Attach thumbnail photos of the top results as image content blocks (default: true). Set false for a lean text-only response.",
"type": "boolean"
},
"intent": {
"description": "Whether to search rentals or properties for sale (default: \"rent\")",
"enum": [
"rent",
"buy"
],
"type": "string"
},
"limit": {
"description": "Number of results to return (max 50, default 20)",
"maximum": 50,
"minimum": 1,
"type": "number"
},
"locale": {
"description": "Response locale: en, fr, de, lu (Luxembourgish), pt (default: en; 'lb' is a deprecated alias for 'lu')",
"enum": [
"en",
"fr",
"de",
"lu",
"pt",
"lb"
],
"type": "string"
},
"query": {
"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.",
"minLength": 1,
"type": "string"
},
"shownListingIds": {
"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.",
"items": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"maxItems": 10,
"type": "array"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_vibe",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"countKind": {
"const": "returned",
"type": "string"
},
"excludedUnprovenCount": {
"description": "Upstream rows omitted because public facts could not prove every requested hard filter.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"followUp": {
"additionalProperties": false,
"properties": {
"outcome": {
"enum": [
"applied",
"answered"
],
"type": "string"
},
"reply": {
"type": "string"
}
},
"required": [
"outcome"
],
"type": "object"
},
"hasMore": {
"type": "boolean"
},
"listings": {
"items": {
"additionalProperties": {},
"properties": {
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amenities": {
"additionalProperties": false,
"properties": {
"balcony": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"elevator": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"furnished": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"garden": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"parking": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"petsAllowed": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"stepFreeAccess": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"wheelchairAccessible": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"furnished",
"elevator",
"parking",
"balcony",
"garden",
"petsAllowed",
"stepFreeAccess",
"wheelchairAccessible"
],
"type": "object"
},
"areaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"availability": {
"additionalProperties": false,
"properties": {
"availableFrom": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"moveInState": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"offerStatus": {
"enum": [
"available",
"under_offer",
"unknown"
],
"type": "string"
}
},
"required": [
"offerStatus",
"availableFrom",
"moveInState"
],
"type": "object"
},
"baths": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"beds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"charges": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"const": "EUR",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duplicates": {
"additionalProperties": false,
"properties": {
"confirmedOtherSources": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"confirmedSourceCount": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"confirmedOtherSources",
"confirmedSourceCount"
],
"type": "object"
},
"energyClass": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"features": {
"items": {
"type": "string"
},
"type": "array"
},
"fieldProvenance": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"source_structured",
"source_text",
"official_dataset",
"calculation",
"manual_review",
"model_extraction",
"model_only",
"unknown"
],
"type": "string"
},
"observedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"publisher": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sourceUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"confirmed",
"estimated",
"thin_sample",
"stale",
"context_only",
"conflicted",
"not_collected",
"source_unavailable",
"suppressed"
],
"type": "string"
}
},
"required": [
"status",
"publisher",
"method",
"sourceUrl",
"observedAt"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"hasSourceCheckedFacts": {
"type": "boolean"
},
"history": {
"additionalProperties": false,
"properties": {
"daysListed": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"firstObservedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"firstObservedBasis": {
"const": "source_listing_date_or_chathome_ingest",
"type": "string"
},
"lastChangedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"priceDropTotalEur": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"firstObservedAt",
"firstObservedBasis",
"daysListed",
"priceDropTotalEur",
"lastChangedAt"
],
"type": "object"
},
"id": {
"type": "string"
},
"imageUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"listingType": {
"enum": [
"rent",
"sale"
],
"type": "string"
},
"location": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confidence": {
"enum": [
"verified",
"unverified",
"contradicted",
"unknown"
],
"type": "string"
},
"district": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"postalCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"precision": {
"enum": [
"exact_address",
"street",
"district",
"commune_only",
"unknown"
],
"type": "string"
}
},
"required": [
"city",
"district",
"address",
"postalCode",
"precision",
"confidence"
],
"type": "object"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"match": {
"additionalProperties": false,
"properties": {
"allRequiredConstraintsSatisfied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"requiredConstraints": {
"items": {
"additionalProperties": false,
"properties": {
"actual": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"matched",
"not_matched",
"not_verified",
"not_applied"
],
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"status",
"target",
"actual"
],
"type": "object"
},
"type": "array"
},
"resultKind": {
"anyOf": [
{
"enum": [
"strict_match",
"partial_match",
"relaxed_alternative"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"allRequiredConstraintsSatisfied",
"resultKind",
"requiredConstraints",
"reasons"
],
"type": "object"
},
"matchReasons": {
"items": {
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"officialScreening": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"photoUrls": {
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"pricePerSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"property": {
"additionalProperties": false,
"properties": {
"airConditioning": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"colocation": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"completionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"condition": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"constructionYear": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasFloorplan": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"heatingEnergy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"heatingType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"landAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"privateRoomAreaSqm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"rentByOwner": {
"anyOf": [
{
"const": true,
"type": "boolean"
},
{
"type": "null"
}
]
},
"rooms": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"totalFloors": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"rooms",
"floor",
"totalFloors",
"constructionYear",
"completionYear",
"landAreaSqm",
"privateRoomAreaSqm",
"condition",
"heatingType",
"heatingEnergy",
"airConditioning",
"hasFloorplan",
"rentByOwner",
"colocation"
],
"type": "object"
},
"propertyChecks": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"propertyType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyFee": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"agencyFeeBasis": {
"anyOf": [
{
"enum": [
"tenant_share",
"total_commission",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
]
},
"baseMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"chargesIncluded": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"chargesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"deposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"depositExceedsMaximum": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"depositMaximum": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"estimatedMonthlyTotalIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"estimatedUtilitiesMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"exactUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"firstChargeAdvance": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"heatingMayBeDoubleCounted": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"indicativeInsuranceMonthly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownMonthlyLowerBound": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"knownUpfrontCost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryMoveInFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"mandatoryRecurringFeeTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mandatoryRecurringFees": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"monthlyTotal": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"monthlyTotalStatus": {
"anyOf": [
{
"enum": [
"known",
"unknown_charges",
"conflicting_charges",
"invalid_price",
"unknown_mandatory_recurring_fees"
],
"type": "string"
},
{
"type": "null"
}
]
},
"reportedDeposit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unknownComponents": {
"items": {
"type": "string"
},
"type": "array"
},
"upfrontCostIsExact": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"upfrontCostIsLowerBound": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
}
},
"required": [
"baseMonthly",
"chargesMonthly",
"chargesIncluded",
"monthlyTotal",
"monthlyTotalStatus",
"knownMonthlyLowerBound",
"estimatedMonthlyTotal",
"estimatedMonthlyTotalIsLowerBound",
"estimatedUtilitiesMonthly",
"indicativeInsuranceMonthly",
"heatingMayBeDoubleCounted",
"firstChargeAdvance",
"reportedDeposit",
"deposit",
"depositMaximum",
"depositExceedsMaximum",
"agencyFee",
"agencyFeeBasis",
"mandatoryRecurringFees",
"mandatoryRecurringFeeTotal",
"mandatoryMoveInFees",
"mandatoryMoveInFeeTotal",
"knownUpfrontCost",
"exactUpfrontCost",
"upfrontCostIsLowerBound",
"upfrontCostIsExact",
"unknownComponents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"schemaVersion": {
"const": "agent-listing.v2",
"type": "string"
},
"score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"source": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agencyConfirmedAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"agencyListingId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"agencyName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lastSeenAt": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"listingUrl": {
"format": "uri",
"type": "string"
},
"status": {
"enum": [
"active",
"under_offer",
"unknown"
],
"type": "string"
},
"statusBasis": {
"enum": [
"source_catalog_seen",
"listing_record_active"
],
"type": "string"
},
"type": {
"const": "original_agency_listing",
"type": "string"
}
},
"required": [
"type",
"agencyName",
"listingUrl",
"agencyListingId",
"lastSeenAt",
"status",
"statusBasis",
"agencyConfirmedAt"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"const": "active",
"type": "string"
},
"title": {
"type": "string"
},
"transport": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"unknown": {
"description": "Why each missingFields entry is unknown. not_in_search_result means get_listing may know it.",
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"reason": {
"enum": [
"not_stated",
"not_proven",
"conflicted",
"not_in_search_result"
],
"type": "string"
}
},
"required": [
"field",
"reason"
],
"type": "object"
},
"type": "array"
},
"url": {
"format": "uri",
"type": "string"
},
"valueContext": {
"additionalProperties": false,
"properties": {
"fairPrice": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"marketContext": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"priceIntegrity": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"priceIntegrity",
"fairPrice",
"marketContext"
],
"type": "object"
}
},
"required": [
"schemaVersion",
"id",
"url",
"title",
"status",
"price",
"currency",
"listingType",
"propertyType",
"city",
"district",
"country",
"beds",
"baths",
"areaSqm",
"energyClass",
"imageUrl",
"agencyName",
"source",
"rent",
"availability",
"property",
"location",
"history",
"duplicates",
"amenities",
"fieldProvenance",
"officialScreening",
"propertyChecks",
"transport",
"valueContext",
"missingFields",
"match",
"latitude",
"longitude"
],
"type": "object"
},
"type": "array"
},
"marketMatchingUpperBound": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"matchingCount": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"matchingCountKind": {
"enum": [
"exact",
"lower_bound",
"unavailable"
],
"type": "string"
},
"nextCursor": {
"type": "null"
},
"note": {
"type": "string"
},
"ranking": {
"additionalProperties": false,
"properties": {
"planFingerprint": {
"type": "string"
},
"probability": {
"const": false,
"type": "boolean"
},
"scoreKind": {
"const": "request_fit",
"type": "string"
},
"status": {
"enum": [
"available",
"degraded"
],
"type": "string"
}
},
"required": [
"status",
"scoreKind",
"probability"
],
"type": "object"
},
"returnedCount": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"searchExhaustive": {
"type": "boolean"
},
"session": {
"additionalProperties": false,
"properties": {
"brief": {
"additionalProperties": {},
"properties": {},
"type": "object"
}
},
"required": [
"brief"
],
"type": "object"
},
"source": {
"type": "string"
},
"total": {
"description": "Exact number of listing objects returned in this response; not the number of matches in the market.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
},
"understanding": {
"additionalProperties": false,
"description": "What the engine understood from the request. notChecked lists wishes no returned home is confirmed to have.",
"properties": {
"checked": {
"items": {
"additionalProperties": false,
"properties": {
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"meaning": {
"type": "string"
},
"needId": {
"type": "string"
},
"operator": {
"type": "string"
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"value": {
"anyOf": [
{
"anyOf": [
{
"type": "number"
},
{
"type": "string"
}
]
},
{
"type": "null"
}
]
}
},
"required": [
"meaning",
"needId",
"operator",
"value",
"unit",
"force"
],
"type": "object"
},
"type": "array"
},
"commutes": {
"items": {
"additionalProperties": false,
"properties": {
"destination": {
"type": "string"
},
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"maxMinutes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"mode": {
"anyOf": [
{
"enum": [
"transit",
"drive",
"walk",
"bike"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"destination",
"mode",
"maxMinutes",
"force"
],
"type": "object"
},
"type": "array"
},
"excludedPropertyTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"notChecked": {
"items": {
"additionalProperties": false,
"properties": {
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"meaning": {
"type": "string"
},
"reason": {
"enum": [
"no_listing_fact",
"fact_not_collected_yet"
],
"type": "string"
}
},
"required": [
"meaning",
"force",
"reason"
],
"type": "object"
},
"type": "array"
},
"offer": {
"enum": [
"whole",
"room",
"either"
],
"type": "string"
},
"places": {
"items": {
"additionalProperties": false,
"properties": {
"country": {
"anyOf": [
{
"enum": [
"LU",
"FR",
"BE",
"DE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"force": {
"enum": [
"must",
"should",
"nice"
],
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"radiusKm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"role": {
"enum": [
"live",
"work",
"near",
"avoid"
],
"type": "string"
}
},
"required": [
"name",
"role",
"kind",
"country",
"radiusKm",
"force"
],
"type": "object"
},
"type": "array"
},
"propertyTypes": {
"items": {
"type": "string"
},
"type": "array"
},
"transaction": {
"anyOf": [
{
"enum": [
"buy",
"rent"
],
"type": "string"
},
{
"type": "null"
}
]
},
"understood": {
"type": "string"
}
},
"required": [
"understood",
"transaction",
"propertyTypes",
"excludedPropertyTypes",
"offer",
"places",
"commutes",
"checked",
"notChecked"
],
"type": "object"
}
},
"required": [
"listings",
"total"
],
"type": "object"
}
},
{
"description": "Submit an inquiry about a listing. For chathome-hosted listings creates a conversation thread; for external agency listings returns agency contact details.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"agentName": {
"description": "Optional display name for the inquiring agent",
"maxLength": 100,
"type": "string"
},
"contactEmail": {
"description": "Optional contact email for the inquiring agent",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"listingId": {
"description": "The ID of the listing to inquire about",
"minLength": 1,
"type": "string"
},
"message": {
"description": "Inquiry message to send to the listing owner (10–5000 characters)",
"maxLength": 5000,
"minLength": 10,
"type": "string"
}
},
"required": [
"listingId",
"message"
],
"type": "object"
},
"name": "submit_inquiry",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {},
"properties": {
"conversationId": {
"type": "string"
},
"kind": {
"enum": [
"conversation_created",
"external_agency"
],
"type": "string"
},
"listingId": {
"type": "string"
},
"trust": {
"additionalProperties": {},
"properties": {
"confidence": {
"enum": [
"low",
"medium",
"high",
"unknown"
],
"type": "string"
},
"fallback": {
"type": "boolean"
},
"freshness": {
"enum": [
"fresh",
"recent",
"stale",
"unknown"
],
"type": "string"
},
"generatedAt": {
"type": "string"
},
"missingFields": {
"items": {
"type": "string"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"sources",
"confidence",
"freshness"
],
"type": "object"
}
},
"required": [
"kind",
"trust"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:d905ad0072b849d26169dea0dc8224e6cd3fdd60b64cc79998ffd2f3e0af4e51 | sha256sum