Search used cars for sale
search_used_carsSearch live used cars for sale from UK dealers on Autoza, with current asking prices in GBP and mileage in miles. Returns a canonical autoza.co.uk URL, the town or area, and the vehicle type for each result. Searches cars unless vehicle_type asks for vans, motorcycles or other stock. If nothing matches every filter, optional filters are relaxed one at a time and the response lists which ones. A result whose dealer title says SOLD, SALE AGREED or DEPOSIT PAID carries availability_caution; a result with no asking price has price_gbp null, and price_note flags a very low price that may be for parts or accessories rather than a vehicle. Use when someone wants to find, browse or compare actual vehicles currently for sale in the UK.
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_used_cars"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| make | No | Manufacturer, e.g. "BMW", "Ford". Everyday names such as "VW" or "Merc" are understood, and the response says how the name was read (make_interpreted_as). | |
| limit | No | Max results, 1–25. Defaults to 10. | |
| model | No | Model name, e.g. "Focus", "3 Series". | |
| location | No | UK town, city or postcode district, e.g. "Manchester", "Bury", "SK4". A city matches its postcode areas, as its /cars/{city} page does. | |
| max_year | No | ||
| min_year | No | ||
| body_type | No | One of hatchback, saloon, suv, coupe, convertible, estate, mpv, pickup, van. Anything else is refused. For motorbikes, vans or motorhomes use vehicle_type. | |
| fuel_type | No | e.g. "petrol", "diesel", "electric", "hybrid", "plug-in hybrid" (also "PHEV"). A plug-in hybrid is not counted as a hybrid. | |
| max_price | No | Maximum price in GBP. | |
| min_price | No | Minimum price in GBP. | |
| transmission | No | e.g. "manual", "automatic". | |
| vehicle_type | No | Vehicle type. Defaults to "car". Results are filtered on the vehicle type each listing is recorded under. Pass "van", "motorcycle", "motorhome", "truck" or "caravan" for other stock. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _note | Yes | Where the figures come from: Autoza, prices in GBP, distances in miles. | |
| results | Yes | ||
| fuel_note | No | ||
| make_note | No | ||
| model_note | No | ||
| exact_match | Yes | True only when every filter given was understood and applied and something matched. | |
| vehicle_type | Yes | ||
| nothing_found | No | ||
| tell_the_user | No | ||
| body_type_note | No | ||
| filters_relaxed | No | The filters dropped to find any result, in the order they were dropped. | |
| ignored_arguments | No | Arguments that are not part of this tool and were not applied. | |
| available_locations | No | Towns with stock, offered when the location asked for had none. | |
| make_interpreted_as | No |