AUTO.RIA Used Cars
yevhen-kalyna/autoria-mcp
Exposes AUTO.RIA's used-car REST API for Ukraine's automotive marketplace. You get 30 tools covering search, listing lookups, and paid statistics (AI average pricing, price trends, VIN decoding). The implementation handles AUTO.RIA's numeric ID system for you, resolving human-friendly inputs like brand names and regions to the API's internal codes. Includes seven dictionary resources for browsing categories, colors, and regions, plus tiered caching to preserve API quota on slow-changing reference data. Ships with stdio transport and works out of the box via uvx. Requires a free developers.ria.com API key; paid statistics tools need a separate user ID and fail cleanly when it's missing.
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Jun 9, 2026
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
search_used_carsSearch by brand/model/region/year/price/engine-volume/power/generation/etc.; returns the match `count` + advert ids.
Search by brand/model/region/year/price/engine-volume/power/generation/etc.; returns the match `count` + advert ids.
No parameter schema in public metadata yet.
get_car_detailsCompact details for one advert id: price, year, mileage, structured engine volume/power, labelled body/fuel/gearbox, plus `condition`/`risk`/`verification`/`seller`/`photo` provenance, VIN-if-shown, masked phone, URL.
Compact details for one advert id: price, year, mileage, structured engine volume/power, labelled body/fuel/gearbox, plus `condition`/`risk`/`verification`/`seller`/`photo` provenance, VIN-if-shown, masked phone, URL.
No parameter schema in public metadata yet.
get_car_details_batchDetails for up to 50 advert ids in one call (deduped; a dead id returns a sparse entry).
Details for up to 50 advert ids in one call (deduped; a dead id returns a sparse entry).
No parameter schema in public metadata yet.
lookup_brandsList passenger-car brands, or resolve one brand name to its id.
List passenger-car brands, or resolve one brand name to its id.
No parameter schema in public metadata yet.
lookup_modelsList a brand's models, or resolve one model name to its id.
List a brand's models, or resolve one model name to its id.
No parameter schema in public metadata yet.
lookup_regionsList regions (oblasts), or resolve one region name to its id.
List regions (oblasts), or resolve one region name to its id.
No parameter schema in public metadata yet.
lookup_citiesList a region's cities, or resolve one city name to its id.
List a region's cities, or resolve one city name to its id.
No parameter schema in public metadata yet.
get_average_priceAI average price + comparable listings (by params or `omni_id`).
AI average price + comparable listings (by params or `omni_id`).
No parameter schema in public metadata yet.
get_average_price_over_periodsMonthly average-price time series.
Monthly average-price time series.
No parameter schema in public metadata yet.
get_params_by_vinDecode a VIN / plate / advert id into car-parameter chips.
Decode a VIN / plate / advert id into car-parameter chips.
No parameter schema in public metadata yet.
list_categories
No parameter schema in public metadata yet.
list_all_models
No parameter schema in public metadata yet.
list_models_grouped
No parameter schema in public metadata yet.
list_generations
No parameter schema in public metadata yet.
list_modifications
No parameter schema in public metadata yet.
list_modifications_by_body
No parameter schema in public metadata yet.
list_equipment
No parameter schema in public metadata yet.
list_options
No parameter schema in public metadata yet.
list_options_v2
No parameter schema in public metadata yet.
list_colors
No parameter schema in public metadata yet.
list_countries
No parameter schema in public metadata yet.
list_drive_types
No parameter schema in public metadata yet.
list_fuel_types
No parameter schema in public metadata yet.
list_gearboxes
No parameter schema in public metadata yet.
list_body_styles
No parameter schema in public metadata yet.
list_body_styles_grouped
No parameter schema in public metadata yet.
list_all_body_styles
No parameter schema in public metadata yet.
list_bodies_by_generation
No parameter schema in public metadata yet.
raw_searchRaw V1 search; compact `{count, ids}` by default, `verbose=True` for the full payload.
Raw V1 search; compact `{count, ids}` by default, `verbose=True` for the full payload.
No parameter schema in public metadata yet.
pingZero-quota liveness/diagnostic check.
Zero-quota liveness/diagnostic check.
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
AUTORIA_API_KEY*secretAUTO.RIA developer API key
AUTORIA_USER_IDAUTO.RIA user id (required for paid average-price / VIN tools)
Readme
autoria-mcp
An MCP server that exposes the
AUTO.RIA used-cars REST API (auto.ria.com, via developers.ria.com) to AI
agents — programmatic, agent-friendly access to the Ukrainian used-car market
through the sanctioned API, no scraping.
The full tool surface is live — 30 tools, 7 dictionary resources, and 1 templated resource: curated search/lookup tools (single and batch listing details), paid statistics tools, thin endpoint mirrors, and browsable dictionary resources, all backed by tiered caching and a typed async client.
Features
Details
- Repository
- github.com/yevhen-kalyna/autoria-mcp
- Category
- Search & Web Crawling
- Package
autoria-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
