Search UK property listings
search_propertiesSearch live OpenMoov listings for sale or rent across the UK. Input: optional location (town, postcode or area, e.g. "Ashford" or "TN23") and radius_miles, transaction_type (sale|rent, default sale), price range in GBP, bedroom range, property_types (e.g. ["flat","terraced","detached"]), must-have features (garden, parking, garage, newBuild, chainFree, petFriendly), keywords (street or development name), sort (newest, distance, price_asc, price_desc), page (12 results per page). Residential only unless include_commercial is true. Rent prices are per calendar month. Returns total match count, paging info, and for each property: id, address, price (with priceQualifier such as "Guide Price" or "Offers Over" when set), saleMethod, bedrooms, bathrooms, type, newBuild, marketStatus, listedBy (estate_agent or private_owner), a photo imageUrl (render it when your client supports images) and its openmoov.co.uk URL, plus statusAsOf (when the statuses were read, live). If the location cannot be placed, a note says so. Results cover on-market stock only: For Sale / To Let, plus agreed-but-not-completed listings (Sold STC / Under Offer / Let Agreed) which are flagged bookable:false — viewings cannot be booked on those. Use get_property_details with a returned id for the full listing.
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 | ||
| sort | No | "newest" (default without a location), "distance" (default with one), "price_asc" or "price_desc" | |
| features | No | Must-have features: garden, parking, garage, newBuild, chainFree, petFriendly. Matched against the listing's own feature list and description. | |
| keywords | No | Words that must all appear in the listing's indexed address/reference text, e.g. a street, development or building name ("Hornbeam Close"). Not for features — use features. | |
| location | No | Town, area or UK postcode to search around, e.g. "Hythe" or "TN24" | |
| max_price | No | Maximum price in GBP (rent: per month) | |
| min_price | No | Minimum price in GBP (rent: per month) | |
| max_bedrooms | No | ||
| min_bedrooms | No | ||
| radius_miles | No | Search radius in miles around the location (default about 10; max 40) | |
| property_types | No | Property types to include, e.g. ["flat","terraced","semi-detached","detached","bungalow"] | |
| transaction_type | No | "sale" for homes to buy, "rent" for homes to let | sale |
| include_commercial | No | Default false: commercial, leisure and holiday property types (offices, shops, pubs, hotels, caravans, lodges, park homes) are excluded. Set true only when the user asks for them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| page | No | ||
| total | No | ||
| properties | No | ||
| statusAsOf | No | ISO time the listing statuses were read from the live record | |
| totalPages | No |