Carsa

Branch Details

Get information about Carsa branches. Optionally specify branch_name to get details for a specific branch (e.g., Bolton, Southampton, Bradford).

Get Opening Times

Get the opening times for a specific Carsa branch. Returns the next 14 days of opening hours including any holiday closures.

Get Nearest Branch

Find the Carsa branches closest to a customer's UK postcode, ranked by straight-line distance in miles. Also accepts the outcode alone (the area code before the space — e.g. 'SW1A' from 'SW1A 1AA', 'GL1', 'L39'), useful when a voice caller hasn't given the full postcode. Returns the top 5 with branch names, postcodes, and links. Use this when a customer asks 'where's my nearest Carsa?' or wants to pick a branch. The car they're interested in may not be at the closest branch — confirm before assu

Get Available Makes

Get all available car makes in the inventory with counts. Use to find out what makes we have and how many of each are for sale.

Get Available Models

Get all available models for a specific make with counts.

Search Stock

Search car inventory by the car's CASH PRICE and specification. If the customer frames their budget as a monthly payment instead ('around £300 a month'), use 'search_by_monthly_payment' — this tool cannot answer that. ALL parameters are optional - only include parameters you want to filter by. If you don't want to filter by a parameter, simply omit it from your request (don't set it to 0, empty string, or empty array). Model requires make. PRICE: whenever the customer names a single price — whet

Search by Monthly Payment

Search stock by what a car costs PER MONTH on finance, rather than by its price. Use this — not 'search_stock' — whenever the customer frames their budget as a monthly figure ('around £300 a month', 'up to £250 a month', 'what can I get for 300 a month on PCP?'). 'search_stock' filters on the car's cash price and cannot answer that. Everything except the budget is optional, and the ordinary filters (make, model, body_style, fuel_type…) can be combined with it. IMPORTANT: the response marks each

Find Similar Car

Find similar cars to a given VRM. Results are checked against live reservation state, so reserved cars are excluded and the cars returned can be viewed, test driven and bought — safe to offer as 'something similar that's available'. If availability could not be confirmed for every car, the spoken line drops that promise and 'next_steps' says so — follow it and don't promise availability in that case.

Find Vehicle Details

Get comprehensive details for a specific vehicle by its full VRM, including price, mileage, features, service history, and availability. If the VRM isn't found exactly (typo, mis-hear, or only part of the plate), the tool returns a short list of close in-stock candidates to confirm with the customer rather than failing — and for a verified customer, flags any candidate they've already enquired on as the likely match. For browsing by part of a plate, use 'search_stock' with its partial-VRM 'vrm'

Get Car Images

Get all images for a specific vehicle by VRM, grouped by type (exterior, interior, feature, wheel).

Search FAQs

Search Carsa FAQs from Webflow CMS. Returns questions, answers, and deep links. Use simple keyword search with words like 'electric', 'finance', 'warranty', or 'delivery'. If no results found, returns a list of all FAQ categories to help narrow the search.

Get Finance Quote

Get monthly payment quotes for Hire Purchase (HP) and Personal Contract Purchase (PCP) finance options for a vehicle in stock. Automatically fetches vehicle price and details from stock. Returns detailed finance information including monthly payments, APR, total costs, and terms for both HP and PCP options. COMPLIANCE: The response carries the full figures for each product — the monthly payment, the total amount payable (total_amount_payable), the total charge for credit / interest (total_charge

Get Warranty Prices

Get warranty product pricing for a specific car in Carsa stock. **Requires the car's UK registration plate (VRM)** — not a make/model. If the customer hasn't given you the VRM, identify the car first via `search_stock` or `find_vehicle_details` and call this with that VRM. Returns available warranty options with pricing, terms, and coverage details.

Get Active Promotions

List the offers and promotions running across Carsa right now, company-wide. Use this when the customer asks what deals or offers are on, or whether there is anything on at the moment, without naming a specific car — no other tool can answer that, because every other offer lookup is keyed on one car's registration. An empty list does NOT mean there are no offers: it means no company-wide campaign is running, and a specific car may still carry one. Never confirm whether a customer or a car qualif

Find Appointments

Find when the customer can come in for a test drive and what times are open on that day. One call returns both: the bookable horizon (earliest date, latest bookable date, whether the car needs moving with a refundable reservation fee) AND the morning/lunch/afternoon slot suggestions plus the full slot grid for the chosen day. Pass `date` to check a specific day — if that day is unavailable the response falls back to the earliest day's slots and flags `status: not_available_on_requested_date`. Om

Get Quote Link

Generate a personalised Carsa quote link for an in-stock vehicle. Returns URLs the customer can open to view the quote, build the deal, book a test drive, and submit a part-exchange valuation. The quote is prefilled with the verified customer's name, email and phone. REQUIRES a customer-auth session — call this from the /mcp-customer-auth endpoint with a valid bearer token.