Search cars for sale
search_vehiclesFind cars for sale in JOY Auto Exchange by make, model, price, year, fuel type, and verification status, with sorting and paging.
Instructions
Discover cars for sale in JOY Auto Exchange; use get_vehicle for detail, compare_vehicles for a shortlist or search_auctions for auction links.
Separate manufacturer and model: make='Toyota', query='Premio', max_price_bdt=3000000 expresses a Premio within 30 lakh. Filters intersect; a single 'Toyota Premio' phrase can miss a listing whose fields store those words separately.
Choose a priced-budget search or POA discovery deliberately. include_unpriced does not cancel numeric price bounds; omit both bounds when unknown-price cars must remain candidates. Asking prices are neither bids nor valuations.
Anonymous live read. Keep filters/sort fixed while paging; empty results are valid and missing prices remain unknown. Verification is inspection evidence, not a warranty. No seller is contacted or car reserved.
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_vehicles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| make | No | Case-insensitive manufacturer prefix, e.g. Toyota. Combine with query='Premio' for that model; omit to include all makes. | |
| page | No | One-based results page, 1 through 500; defaults to 1. Keep filters and sort unchanged when paging. | |
| sort | No | Result order: latest (default: verified first, then newest), price_asc (lowest stated price first), price_desc (highest first), or year_desc (newest model year first). Stable tie-breaks support paging; no valuation is performed. | latest |
| query | No | Case-insensitive phrase within make, model or trim; use query='Premio' with make='Toyota', not one combined 'Toyota Premio' phrase. Known Bangla/Banglish vocabulary is normalized; unsupported words may be dropped. Use known English model words for precision; omit to browse. | |
| max_year | No | Inclusive latest model year, 1950 through 2100. Omit for no upper-year filter; supply a value no less than min_year. | |
| min_year | No | Inclusive earliest model year, 1950 through 2100. Omit for no lower-year filter; supply a value no greater than max_year. | |
| fuel_type | No | Case-insensitive prefix of a public listing's fuel label, e.g. hybrid. Copy a known label where possible; omit to include all fuel types. | |
| page_size | No | Maximum results requested per page, 1 through 20; defaults to 10. total is the matching population, which may exceed this page's item count. | |
| max_price_bdt | No | Inclusive maximum stated asking price in Bangladesh taka, e.g. 3000000 means ৳30 lakh. Omit for no maximum; no less than min_price_bdt. | |
| min_price_bdt | No | Inclusive minimum stated asking price in Bangladesh taka, e.g. 2000000 means ৳20 lakh. Omit for no minimum; no greater than max_price_bdt. | |
| verified_only | No | True requires the storefront's verified flag, approved inspection status and a non-empty inspection ID; false (default) also permits other public listings. Verification is not a vehicle warranty. | |
| include_unpriced | No | True includes price-on-application or otherwise unpriced listings; false (default) excludes them. A missing asking price is unknown, never zero. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||