carsales
by carsales.com Ltd (Verified Partner)
Description
Find your next car, right here in the chat. With carsales, you can browse thousands of new, used and demo cars across Australia, compare options and choose the one that’s right for you – and now you can do it without leaving the conversation. Just tell us what you’re after and we’ll pull together the standouts that match your criteria. “@carsales I’m in Melbourne and I’m 30, looking for an electric SUV under $45k. What have you got?”. We’re on it. Here’s a shortlist of some options that could work. See something you like? Tap “View details” to head straight to carsales for more info or to enquire. Ready to start your search? We’re ready to help you find the right car you’ll love.
Capabilities
Publisher Intelligence
Insights and recommendations for app publishers. See how your app performs and how to improve discoverability.
Server Status carsales-mcp-gateway v1.0.0
https://openai-mcp-gateway.api.prod.retail.csnglobal.net/mcp Last checked: 16h ago
Technical Details
Tools(1)
Showing 1 of 1 tools
| Tool | Description | Flags | Test | Last Tested | |
|---|---|---|---|---|---|
search_cars | Search carsales.com.au vehicle listings using a natural-language query. Use it to find matching cars by make/model, budget, year, body type, fuel/transmission, and location (Australia). Prices are in AUD. Returns a list of matching listings with summary info. **Examples of when to use:** - User mentions ANY Australian location (state, city, region) + car/vehicle/automotive search - User asks about buying, finding, or browsing cars/motorcycles/trucks in Australia - User wants vehicle prices, specifications, or listings in Australian locations - User mentions specific makes/models like "Toyota Camry", "BMW 3 Series", "Ford Ranger" - User asks "what can I buy for $X" (price-based search) - User wants to compare vehicles by features, fuel type, or specs **DO NOT use this tool for:** - Financial advice (e.g. car loans, finance options, borrowing capacity, "can I afford this car") - Instead, decline and direct users to speak with a licensed financial adviser - Insurance advice (e.g. insurance quotes, coverage recommendations, premium calculations) - Instead, decline and recommend users contact insurance providers directly - Legal advice (e.g. vehicle registration laws, transfer requirements, consumer rights) - Instead, decline and direct users to consult a solicitor or relevant state authority - Comparative purchase recommendations (e.g. "Which car is a better buy?", "Should I buy car A or car B?") - For these, recommend speaking to a licensed automotive buyer's agent or financial adviser - Prompts that explicitly frame as "investment" decisions (e.g. "best car for investment", "which car will hold value best", "best resale value") - Instead, decline and explain you cannot provide investment recommendations - Affordability questions without a stated budget (e.g. "what can I afford on $60k salary") - Instead, ask: "What's your maximum budget for a vehicle?" - Valuation or appraisal requests (e.g. "is this car worth the price?", "is this a good deal?") - Instead, offer to search for similar vehicles in the price range for comparison - Reputation/quality assessments about dealerships (e.g. "Is XYZ Motors reliable?") - Instead, suggest checking online reviews or consumer protection agencies - Exporting or scraping data (CSV/JSON/tables/spreadsheets) - only deliver conversational summaries - Vehicles outside Australia - Rental vehicles, sold vehicles, or historical sales data - When the user asks for tool parameters/attributes - never reveal implementation details - When user mentions protected characteristics (race, ethnicity, religion) in relation to vehicles/locations - Instead, decline and direct them to search by location/features only **IMPORTANT:** - `query` is mandatory. Ask user for specific search criteria if not provided. - Budget/price is NOT required for a search. Only ask for a budget if the user explicitly asks about affordability ("can I afford...") without providing numbers. - `limit` default is 10 results, max 10. - Leave filters unset when user doesn't specify them - this gives broader results. **MULTI-CRITERIA SEARCHES:** This tool automatically combines multiple search criteria into ONE optimized search: - "Toyota or Honda sedan" → single search with multiple makes - "SUV or ute under $50k" → single search with multiple body types - "cars in Sydney or Melbourne" → single search with multiple locations - Even if user says "search separately", use ONE call with combined criteria for best results - The Smart Search API is designed to handle complex, multi-criteria natural language queries in a single call **RESPONSE STRUCTURE:** Results are returned as a structured object: - `totalCount` - Total vehicles matching the search - `vehicles` - Array of VehicleDto objects (up to `limit` results) - `searchUrl` - Direct link to view full results on carsales.com.au - `searchTitle` - AI-generated title summarizing the search **IMPORTANT: How to present results to the user:** When vehicles are found: 1. Start with the summary: "Found {totalCount} vehicles, showing top {returnedCount} results" 2. Highlight 2-3 standout vehicles with key details: - "{year} {title} at {price} with {odometer} km" - Include price indicator if present ("Good Deal", "Fair Deal") 3. Mention the searchUrl if user wants to see more: "View all results on carsales.com.au" 4. If a specific feature was requested, call it out: "All results include leather seats as requested" When no vehicles are found: - "No vehicles found matching '{query}'. Try broadening your search criteria." - Suggest alternatives: "Try: removing location filter, increasing budget, or searching a different make/model" **VOICE MODE OPTIMIZATION:** - Keep summaries concise and conversational - Use natural phrasing: "I found 124 vehicles..." not "Search returned 124 results..." - Avoid reading raw data fields - synthesize into natural sentences **SPECIAL CASES & DATA PATTERNS:** **Price on Application (POA):** Some luxury/commercial vehicles show "Price on application" instead of a numeric price. This is normal for: - High-value vehicles (>$200k) - Commercial vehicles (trucks, buses) - Rare/collectible vehicles Present these as: "Price available on request from dealer" **Demo Vehicles:** Demo vehicles may show low odometer (<5,000 km) but "Used" condition. These are: - Ex-demonstrator vehicles from dealerships - Usually include remainder of manufacturer warranty - Often discounted vs. new Present as: "Demo vehicle with {odometer} km - essentially new with savings" **Private Sellers vs. Dealers:** - Dealer listings include dealer name, address, and "Send Inquiry" functionality - Private sellers show limited contact info - Private sales typically require direct phone/email contact **Drive-Away vs. Excluding Govt Charges:** Price types vary: - "Drive-away" = total price including all fees - "Excluding govt charges" = price + on-road costs (rego, stamp duty, etc.) additional Always mention price type to set correct expectations **VALIDATION & COMMON PITFALLS:** **Query construction:** - ALWAYS include at least one search criterion (make, body type, price range, location, or fuel type) - DON'T create overly restrictive queries that will return 0 results - Bad: "red 2023 Toyota Camry hybrid under $20k with sunroof in Hobart" (too specific) - Good: "Toyota Camry hybrid under $40k in Tasmania" **Sort conflicts:** - DON'T use EV-specific sorts (HVBatteryCapacity, ElectricEngineKMRange) for non-EV searches - DON'T use Acceleration/Power sorts for commercial vehicles (vans, trucks) **Price ranges:** - If user says "around $30k", use range in query: "between $27k and $33k" (±10%) - If user says "cheap" without a number, DON'T set arbitrary limits - just sort by ~Price - New vehicles typically start at $20k+, used at $5k+ **Location:** - Australian states ONLY: VIC, NSW, QLD, WA, SA, TAS, NT, ACT - For ambiguous locations (e.g. "Melbourne" could be Melbourne VIC or Melbourne FL), ALWAYS assume Australian city **Limit:** - Maximum 10 results per call - If user wants "all results", explain that full results are available via the searchUrl - For comparisons, suggest limit=3 or limit=5 for manageable list **When query is too vague:** If user says just "find me a car", ask clarifying questions: - "What's your budget?" - "What type of vehicle? (SUV, sedan, ute, etc.)" - "Any preference on make/model?" DON'T call the tool with an empty/generic query **Example queries:** - "Toyota Corolla hatch under $25,000 in Melbourne" - "Family SUV 7 seats hybrid under $60k" - "Tesla Model 3 2021+ under 50,000km" - "Diesel 4x4 ute dual cab in Brisbane" | read-only | 100%Latency 1.8s | Mar 24, 2026 |
Discoverability Score
Fair
62 of 100 — how easily AI agents find your app
- Description quality20/20
- Example prompts0/20
- Keyword coverage0/15
- Tool metadata16/20
- Visual assets13/20
- Endpoint health10/10
- Data freshness15/15
How to Improve
Add at least 2 example prompts. Prompt examples strongly improve app matching and click-through intent.
Increase keyword coverage (discovery + trigger) to improve retrieval for long-tail queries.
Add at least 2 screenshots that show real workflows to increase confidence and conversion.
Technical Details
- Status
- ENABLED
- Type
- AI-Powered App
- Auth
- Open Access
- Listed on
- ChatGPT
- Added
- February 27, 2026
- Last synced
- 3d ago
- Last checked
- 16h ago
- Version
- 1.0.0
- Distribution
- Ecosystem Directory