Liveness check for the autoria MCP server.

Returns server name, package version, the active transport, and whether an API key is configured. Costs zero API quota and makes no network call. Use it to verify wiring before invoking real tools.

List passenger-car brands, or resolve one brand name to its id.

With no name, returns every brand as {id, name}. With a name, returns the single matching brand (or an error listing close matches).

List a brand's models, or resolve one model name to its id.

brand is required (models are scoped to a brand). With no name, returns every model of that brand; with a name, the single match.

List regions (oblasts), or resolve one region name to its id.

Note: there is no separate "Київ" (Kyiv city) region — only Київська (oblast, id 10). Kyiv city is a city within it: target it with region="Київська", city="Київ" (via lookup_cities / search_used_cars).

List a region's cities, or resolve one city name to its id.

region is required (cities are scoped to a region).

Search AUTO.RIA used-car listings (passenger cars) by friendly inputs.

Resolves brand/model/region/city/fuel/gearbox/body names to AUTO.RIA ids for you, then makes a single search call. Returns the total match count, the current page/page_size, and the matching advert ids (used cars only — the OfferOfTheDay promo is filtered out). To get a specific listing's details and its own auto.ria.com URL, pass an id to get_car_details, or set include_details=true to get them inline.

Notes:

• Mileage is in km (e.g. mileage_to=150000); engine volume is in litres (engine_volume_from=1.9), power in hp (power_hp_from).

• Engine volume is stored imprecisely upstream (a 2.0 may appear as 1.97), so use a band (e.g. 1.9–2.1) rather than an exact value.

• model requires brand; city requires region. To target Kyiv city, use region="Київська", city="Київ" (there is no separate Kyiv region). Filter by generation_id/modification_id (from list_generations / list_modifications) to isolate a specific generation or engine/trim.

• v1 supports a single brand+model block. For multi-brand queries use the raw_search tool.

Example: search_used_cars(brand="Audi", model="A6", body="Універсал", engine_volume_from=1.9, engine_volume_to=2.1, fuel="Дизель", order_by="price_asc").

Get compact details for a single AUTO.RIA advert by its id.

Returns price (USD/UAH/EUR), year, mileage (km), fuel + engine_volume_l

• power_hp, gearbox, drive, body_name, generation, modification, colour, location, the VIN (only if the seller revealed it), the masked phone, and the canonical listing url.

For due diligence it also returns SELLER-DECLARED, UNVERIFIED provenance: condition (1 undamaged … 4 for-parts), the risk block (damaged/for_parts/under_credit/confiscated/imported/needs_customs), VIN/inspection verification, seller trust, photo links, plus is_sold/is_leasing/price_negotiable/exchange_possible and the seller description. Check risk and condition before trusting a listing — mileage_km and prices are claims, not facts. The phone is always masked. To look up many ids at once use get_car_details_batch.

Get compact details for several adverts in one call (up to 50 ids).

The agent-efficiency counterpart to get_car_details: instead of one round-trip per id when ranking a result page, pass the whole id list and get an array back, in the same order, deduplicated. A listing that fails to load comes back as a sparse entry (its url is null) rather than failing the batch. Same fields and caveats as get_car_details (mileage/price are seller-declared and unverified).

Paid. AI average price + comparable listings (point-in-time).

Two modes: pass omni_id (VIN/plate/advert id), OR car parameters by name (brand+model required, plus at least one more filter such as year_from/mileage_to/fuel/engine_volume_from). Names are resolved to ids for you; generation_id/modification_id are optional raw ids. Requires AUTORIA_USER_ID. period ∈ {30, 90, 180, 365}.

The headline avg_price_usd/avg_price_uah is AUTO.RIA's own model-level AI estimate — it is only weakly sensitive to engine_volume/modification, so do NOT read it as an engine-precise fair value. For that, prefer cohort_estimate_usd (the median of the comparable listings), keeping in mind the sample is small. To judge reliability, the response also returns sample_count and the sample's own sample_min_usd/sample_median_usd/ sample_max_usd, plus a price_consistency flag that is avg_below_sample/ avg_above_sample when the headline falls outside its own comparables. status is no_data / insufficient_sample / ok — it is insufficient_sample when fewer than 5 comps are in-cohort or when a tight cohort was requested yet the headline ignored it. Comps are flagged in_cohort and cohort_estimate_usd uses only those (in_cohort_count reports how many). cohort echoes the resolved filters. quota is a LOCAL, advisory, warn-only counter (it can exceed its limit and never blocks) — not AUTO.RIA's enforced budget, so don't hard-gate on it.

Note: facelifts are distinct generation_ids and this endpoint takes a single one — call once per generation to price a whole family.

Example: get_average_price(brand="Peugeot", model="308", fuel="Дизель", engine_volume_from=1.9, engine_volume_to=2.1, year_from=2014, period=365).

Paid. Average-price time series (monthly) for a car or omni_id.

Same inputs and modes as get_average_price; returns graph_data (monthly average price, date as "MM.YY") plus the available period presets. Requires AUTORIA_USER_ID. period ∈ {30, 90, 180, 365}.

Paid. Decode a VIN / plate / advert id into car-parameter chips.

Returns the decoded attributes (category, brand, model, body, fuel, gearbox, drive, colour, year, ...) plus a link to equivalent listings. Only works if the vehicle was ever listed on AUTO.RIA. Requires AUTORIA_USER_ID. An unresolvable id surfaces as a tool error.

List all transport categories (ids + names). Cached 7 days.

List all models across every brand/category (raw). Cached 7 days.

List a brand's models grouped into families (heterogeneous). Cached 7d.

List generations for a model. Cached 7 days.

Raw upstream shape (camelCase: generationId, yearFrom, yearTo). Note yearTo: 0 is a sentinel for "current / still produced", not a literal year.

List modifications (engine/trim variants) for a generation. Cached 7d.

List modifications for a generation restricted to a body type. Cached 7d.

List equipment trims for a modification. Cached 7 days.

List the flat option/equipment vocabulary for a category. Cached 7d.

List the grouped (publishing) options V2 structure for a category. Cached 7d.

List paint colours (ids + names). Cached 7 days.

List manufacturer/origin countries (note the custom 900+ block). Cached 7d.

List drive types for a category (ids are category-specific). Cached 7d.

List fuel types (ids + names; includes MHEV 11 / REEV 12). Cached 7d.

List gearboxes for a category. Cached 7 days.

List body styles for a category (parentId groups them). Cached 7d.

List body styles for a category as groups (array of arrays). Cached 7d.

List all body styles across categories (raw). Cached 7 days.

List body types available for a generation. Cached 7 days.

Run a raw /auto/search with V1 params (power users).

Bypasses the curated name-resolution of search_used_cars; you supply V1 wire params directly (e.g. marka_id[0], category_id, s_yers[0]). Cached briefly (volatile). By default returns the same compact shape as search_used_cars (ids + count); pass verbose=True for the full raw payload (~150 lines of echoed params/metadata).