search_properties
Search current residential, rural and commercial real-estate listings for sale or rent in Portugal. Use this whenever the user wants to find, compare or explore properties — by location, budget, typology, property type, condition or energy rating. Returns price, price per m², typology, areas, neighbourhood, source and a citable listing URL, plus total: the exact number of listings matching the filters, which makes this tool usable to answer 'how many' questions. Listings are aggregated from portals and agency sites and refreshed continuously; each result carries the date it was last checked at the source. Sources publish uneven detail: filtering on an attribute silently excludes listings that omit it, so prefer the broadest filters that answer the question and report total as a floor, not a census.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_properties"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. Use it with `total` to walk through a large result set. | |
| sort | No | Result order. Default `recent` (most recently published first). | |
| limit | No | Results per page (default 10, max 20). | |
| minArea | No | Minimum floor area in m². Matches either the gross or the useful area, whichever the source published. Only matches listings that published an area. | |
| location | No | Location: district, municipality, neighbourhood, town or postal-code prefix (e.g. Lisbon, Cascais, Chiado, 2750). Not a free-text keyword search — words that are not places (e.g. 'sea view') will not match. | |
| priceMax | No | Maximum price, in the market currency. Note: listings advertised 'price on request' have no price and are excluded by either price bound. | |
| priceMin | No | Minimum price, in the market currency. | |
| typology | No | Normalised typology code (T0, T1, T2, T3…), where the number is the count of bedrooms. Used in every market, including the German and Polish ones. Matched exactly; pass an array to match several. The buckets `T0–T1` and `T4+` are also accepted. | |
| condition | No | State of repair, or an array of states. Only matches listings whose source published it. | |
| operation | No | buy = for sale, rent = to let. Defaults to buy; a listing is one or the other, so call twice to cover both. | |
| energyClass | No | Energy certificate class. Selects the whole band the class belongs to: A+/A, B/B-, C, or D-and-below. Only matches listings that carry a certificate. | |
| minBathrooms | No | Minimum number of bathrooms. Only matches listings whose source published a bathroom count. | |
| propertyType | No | Property type, or an array of types. Omit to search all types. `farm` covers rural estates (quintas); `building` is a whole apartment block. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| shown | No | Listings returned on this page. | |
| total | Yes | Exact number of listings in this market matching the filters, across all pages. | |
| market | Yes | ISO country code of this market. | |
| hasMore | Yes | true when further pages are available. | |
| currency | No | ||
| pageSize | No | ||
| operation | No | The operation actually searched (comprar = for sale, arrendar = to let). | |
| properties | Yes |