cars-data.com — Car Specs API

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Search, compare & filter 103,372 car variants — 224 specs, 20 languages. Free demo, no key; x402.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "cars-data.com — Car Specs API": {
      "url": "https://api.cars-data.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• search_cars read-only

  Free-text search across 103,372 vehicle variants, 120 brands, 20 languages. Returns candidate variant_ids to pass to get_specs/get_images/compare_variants. Each result carries generation_id and production years so same-named variants from different generations can be told apart. This answers from a fixed 40-car demo set. For the full 103,372-variant catalogue call search_catalogue — paid per call with x402 (USDC on Base), $0.005, no key, no account.

  Parameters:

  • query (required) — string — Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla model s'.
  • limit — integer — Maximum number of results, 1–50. Default: 10.
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_specs read-only

  Full localized specs for one vehicle variant, in any of 20 languages — 232 spec types covering engine & fuel, performance, EV/hybrid, safety, comfort & interior, exterior, chassis, dimensions & weights, consumption (WLTP/NEDC). Each spec carries a confidence score; the response carries last_synced_at — surface both so you don't overstate certainty. This answers from a fixed 40-car demo set. For the full 103,372-variant catalogue call get_specs_full — paid per call with x402 (USDC on Base), $0.05, no key, no account.

  Parameters:

  • variant_id (required) — string — Opaque variant id from search_cars or filter_cars, e.g. v_1a2b3c4d
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• compare_variants read-only

  Side-by-side localized specs for 2-4 vehicle variants. This answers from a fixed 40-car demo set. For the full 103,372-variant catalogue call compare_full — paid per call with x402 (USDC on Base), $0.1, no key, no account.

  Parameters:

  • variant_ids (required) — array — 2 to 4 opaque variant ids from search_cars or filter_cars, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b']
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• list_generations read-only

  Generations/facelifts of a model, with production years. This answers from a fixed 40-car demo set. Full catalogue: pay per request with x402, no key (GET /v1/variants/{id}/specs $0.05, /v1/search $0.005, /v1/variants $0.005, /v1/compare $0.1, USDC on Base); the Apify Actor, billed per event by Apify (https://apify.com/carsdatacom/car-specs-api); or the whole database as a licensed export (https://cars-data.com/en/api).

  Parameters:

  • model_id (required) — string — Opaque model id from a search_cars or filter_cars result, e.g. m_1a2b3c4d
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• filter_cars read-only

  Structured catalog filter: fuel type, body type, drive layout, power/price range, model year, EV-only. This answers from a fixed 40-car demo set. For the full 103,372-variant catalogue call filter_catalogue — paid per call with x402 (USDC on Base), $0.005, no key, no account.

  Parameters:

  • ev — boolean — true = only variants with a traction battery (battery_kwh set: electric and plug-in). Default: false
  • body — string — Body type, case-insensitive substring of the English label — e.g. suv, sedan, hatchback
  • fuel — string — Fuel type, case-insensitive substring of the English label — e.g. petrol, diesel, electric, hybrid
  • year — integer — Production year the generation covers, e.g. 2022. Not applied by the demo set — reported back in ignored_filters.
  • drive — string — Drive layout, substring match — e.g. 'front', 'rear', 'all'. Not applied by the demo set — reported back in ignored_filters.
  • limit — integer — Maximum number of results, 1–50. Default: 10.
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.
  • power_max — integer — Maximum power, hp
  • power_min — integer — Minimum power, hp
  • price_max — integer — Maximum new list price, EUR

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_images read-only

  Image URLs (own CDN, no attribution burden) for a vehicle variant. This answers from a fixed 40-car demo set. Full catalogue: pay per request with x402, no key (GET /v1/variants/{id}/specs $0.05, /v1/search $0.005, /v1/variants $0.005, /v1/compare $0.1, USDC on Base); the Apify Actor, billed per event by Apify (https://apify.com/carsdatacom/car-specs-api); or the whole database as a licensed export (https://cars-data.com/en/api).

  Parameters:

  • variant_id (required) — string — Opaque variant id from search_cars or filter_cars, e.g. v_1a2b3c4d

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• search_catalogue read-only

  Search all 103,372 variants (not only the 40-car demo). Returns opaque variant_ids for get_specs_full. Paid per call with x402 (USDC) — $0.005.

  Parameters:

  • query (required) — string — Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla model s'.
  • limit — integer — Maximum number of results, 1–50. Default: 10.
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• get_specs_full read-only

  Full localized specs for ANY variant in the catalogue, in 20 languages. Paid per call with x402 (USDC) — $0.05. Not charged when the id is unknown.

  Parameters:

  • variant_id (required) — string — Opaque variant id from search_catalogue, e.g. v_1a2b3c4d
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• filter_catalogue read-only

  Structured filter over all 103,372 variants (not only the 40-car demo): fuel, body, drive layout, power/price range, model year, EV-only. Keyset-paginated; returns opaque variant_ids for get_specs_full / compare_full. Paid per call with x402 (USDC) — $0.005.

  Parameters:

  • ev — boolean — true = battery-electric variants only. Default: false
  • body — string — Body type slug, e.g. suv, hatchback, sedan
  • fuel — string — Fuel slug, e.g. electric, petrol, diesel, hybrid
  • year — integer — Production year the generation covers, e.g. 2022
  • drive — string — Drive layout, substring match — front, rear, all
  • limit — integer — Page size, 1–50. Default: 24.
  • cursor — string — next_cursor of the previous page, to continue it
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.
  • power_max — integer — Maximum power, hp
  • power_min — integer — Minimum power, hp
  • price_max — integer — Maximum new list price, EUR

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• compare_full read-only

  Side-by-side localized specs for 2-4 variants from ANYWHERE in the 103,372-variant catalogue, in 20 languages. Paid per call with x402 (USDC) — $0.1 flat for the call. Not charged when an id is unknown.

  Parameters:

  • variant_ids (required) — array — 2 to 4 opaque variant ids from search_catalogue or filter_catalogue, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b']
  • locale — string — Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.