cars-data.com — Car Specs API

Compare variants

compare_variants

Read-onlyIdempotent

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`locale`	No	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`	Yes	2 to 4 opaque variant ids from search_cars or filter_cars, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b']

Output Schema

TableJSON Schema

Name	Required	Description
`data`	Yes	One entry per requested variant, in the order asked
`locale`	Yes	Language the response is in
`full_catalogue`	No	Present on demo answers: the paid tool that answers the same question over the full catalogue, with its price

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 16, 2026

addedOutput schema / properties / full_catalogue

Added value: +{
+  "description": "Present on demo answers: the paid tool that answers the same question over the full catalogue, with its price",
+  "type": "string"
+}

Changed3 schema fields changedOct 14, 2026

addedInput schema / properties / locale / description

Added value: +"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."

changedInput schema / properties / variant_ids / description

Previous value: -"opaque variant ids from search_cars"New value: +"2 to 4 opaque variant ids from search_cars or filter_cars, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b']"

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "data": {
+      "description": "One entry per requested variant, in the order asked",
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "specs": {
+            "additionalProperties": {
+              "additionalProperties": {},
+              "properties": {
+                "confidence": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Confidence score 0–1 for this value; null when not scored"
+                },
+                "label": {
+                  "description": "Spec name in the requested language",
+                  "type": "string"
+                },
+                "unit": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Unit of the value (km, kW, l/100km, …); null when unitless"
+                },
+                "value": {
+                  "description": "The value: a string, number or boolean, already localized. Absent when the source holds no value"
+                }
+              },
+              "required": [
+                "label",
+                "unit",
+                "confidence"
+              ],
+              "type": "object"
+            },
+            "description": "Every spec the variant carries, keyed by spec key (e.g. range_wltp_km)",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "variant_id": {
+            "description": "Opaque variant id, e.g. v_1a2b3c4d. Pass it to get_specs / get_images / compare_variants.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "variant_id",
+          "specs"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "locale": {
+      "description": "Language the response is in",
+      "enum": [
+        "en",
+        "ro",
+        "fr",
+        "de",
+        "es",
+        "it",
+        "sr",
+        "hr",
+        "pt",
+        "pl",
+        "cs",
+        "sk",
+        "hu",
+        "no",
+        "sv",
+        "el",
+        "bg",
+        "da",
+        "ar",
+        "tr"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "locale",
+    "data"
+  ],
+  "type": "object"
+}

Changed5 schema fields changedOct 6, 2026

changedInput schema / properties / locale / enum

Previous value: -[
-  "en",
-  "ro",
-  "fr",
-  "de",
-  "es",
-  "it",
-  "sr",
-  "hr",
-  "pt",
-  "pl",
-  "cs",
-  "sk",
-  "hu",
-  "no",
-  "sv",
-  "el",
-  "bg",
-  "da",
-  "ar"
-]New value: +[
+  "en",
+  "ro",
+  "fr",
+  "de",
+  "es",
+  "it",
+  "sr",
+  "hr",
+  "pt",
+  "pl",
+  "cs",
+  "sk",
+  "hu",
+  "no",
+  "sv",
+  "el",
+  "bg",
+  "da",
+  "ar",
+  "tr"
+]

addedInput schema / properties / variant_ids / description
```
Added value: +"opaque variant ids from search_cars"
```
removedInput schema / properties / variant_ids / items / maximum
```
Removed value: -9007199254740991
```
removedInput schema / properties / variant_ids / items / minimum
```
Removed value: --9007199254740991
```
changedInput schema / properties / variant_ids / items / type
```
Previous value: -"integer"New value: +"string"
```

First observedJul 26, 2026

TDQS

Score is being calculated.

All cars-data.com — Car Specs API tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.