Search, compare & filter 103,372 car variants — 224 specs, 20 languages. Free demo, no key; x402.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <your cars-data.com API key> — OPTIONAL. Without it this server answers a fixed 40-car demo (every spec, every photo, 20 languages); a demo key, issued in one click, covers the same 40 cars over REST. Two tools reach the full 103,372-variant catalogue with no key and no account at all, paid per call under x402 v2 on Base (USDC): search_catalogue $0.005 and get_specs_full $0.05. Keys and licensed exports: https://cars-data.com/en/api/for-ai-agents
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
2 to 4 opaque variant ids from search_catalogue or filter_catalogue, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b']
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.
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.
| Argument | Type | Description |
|---|---|---|
| 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. |
| variant_ids* | array | 2 to 4 opaque variant ids from search_catalogue or filter_catalogue, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b'] |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"variant_ids"
],
"properties": {
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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."
},
"variant_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 2,
"description": "2 to 4 opaque variant ids from search_catalogue or filter_catalogue, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b']"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
| variant_ids* | array | 2 to 4 opaque variant ids from search_cars or filter_cars, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b'] |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"variant_ids"
],
"properties": {
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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."
},
"variant_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 2,
"description": "2 to 4 opaque variant ids from search_cars or filter_cars, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b']"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
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.
| Argument | Type | Description |
|---|---|---|
| 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. |
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).
| Argument | Type | Description |
|---|---|---|
| variant_id* | string | Opaque variant id from search_cars or filter_cars, e.g. v_1a2b3c4d |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"variant_id"
],
"properties": {
"variant_id": {
"type": "string",
"description": "Opaque variant id from search_cars or filter_cars, e.g. v_1a2b3c4d"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
| variant_id* | string | Opaque variant id from search_cars or filter_cars, e.g. v_1a2b3c4d |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"variant_id"
],
"properties": {
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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."
},
"variant_id": {
"type": "string",
"description": "Opaque variant id from search_cars or filter_cars, e.g. v_1a2b3c4d"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
| variant_id* | string | Opaque variant id from search_catalogue, e.g. v_1a2b3c4d |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"variant_id"
],
"properties": {
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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."
},
"variant_id": {
"type": "string",
"description": "Opaque variant id from search_catalogue, e.g. v_1a2b3c4d"
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| 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. |
| model_id* | string | Opaque model id from a search_cars or filter_cars result, e.g. m_1a2b3c4d |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"model_id"
],
"properties": {
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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."
},
"model_id": {
"type": "string",
"description": "Opaque model id from a search_cars or filter_cars result, e.g. m_1a2b3c4d"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results, 1–50. Default: 10. |
| query* | string | Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla model s'. |
| 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. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results, 1–50. Default: 10."
},
"query": {
"type": "string",
"description": "Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla model s'."
},
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results, 1–50. Default: 10. |
| query* | string | Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla model s'. |
| 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. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results, 1–50. Default: 10."
},
"query": {
"type": "string",
"minLength": 2,
"description": "Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla model s'."
},
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ev": {
"type": "boolean",
"description": "true = only variants with a traction battery (battery_kwh set: electric and plug-in). Default: false"
},
"body": {
"type": "string",
"description": "Body type, case-insensitive substring of the English label — e.g. suv, sedan, hatchback"
},
"fuel": {
"type": "string",
"description": "Fuel type, case-insensitive substring of the English label — e.g. petrol, diesel, electric, hybrid"
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Production year the generation covers, e.g. 2022. Not applied by the demo set — reported back in ignored_filters."
},
"drive": {
"type": "string",
"description": "Drive layout, substring match — e.g. 'front', 'rear', 'all'. Not applied by the demo set — reported back in ignored_filters."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results, 1–50. Default: 10."
},
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum power, hp"
},
"power_min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Minimum power, hp"
},
"price_max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum new list price, EUR"
}
}
}| power_max | integer | Maximum power, hp |
| power_min | integer | Minimum power, hp |
| price_max | integer | Maximum new list price, EUR |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ev": {
"type": "boolean",
"description": "true = battery-electric variants only. Default: false"
},
"body": {
"type": "string",
"description": "Body type slug, e.g. suv, hatchback, sedan"
},
"fuel": {
"type": "string",
"description": "Fuel slug, e.g. electric, petrol, diesel, hybrid"
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Production year the generation covers, e.g. 2022"
},
"drive": {
"type": "string",
"description": "Drive layout, substring match — front, rear, all"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size, 1–50. Default: 24."
},
"cursor": {
"type": "string",
"description": "next_cursor of the previous page, to continue it"
},
"locale": {
"enum": [
"en",
"ro",
"fr",
"de",
"es",
"it",
"sr",
"hr",
"pt",
"pl",
"cs",
"sk",
"hu",
"no",
"sv",
"el",
"bg",
"da",
"ar",
"tr"
],
"type": "string",
"description": "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": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum power, hp"
},
"power_min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Minimum power, hp"
},
"price_max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Maximum new list price, EUR"
}
}
}