cars-data.com — Car Specs API

Search cars

search_cars

Read-onlyIdempotent

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.

Input Schema

TableJSON Schema

Name	Required	Description
`limit`	No	Maximum number of results, 1–50. Default: 10.
`query`	Yes	Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla model s'.
`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.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`data`	Yes	Matches, best first; empty when nothing matches
`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"
+}

Changed4 schema fields changedOct 14, 2026

addedInput schema / properties / limit / description

Added value: +"Maximum number of results, 1–50. Default: 10."

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 / query / description

Previous value: -"e.g. 'bmw 3 series' or 'tesla model s'"New value: +"Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla model s'."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "data": {
+      "description": "Matches, best first; empty when nothing matches",
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "battery_kwh": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Traction battery capacity, kWh; null without one"
+          },
+          "body_type_en": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Body type, English label"
+          },
+          "brand": {
+            "type": "string"
+          },
+          "display_name": {
+            "description": "Full variant name",
+            "type": "string"
+          },
+          "fuel_slug": {
+            "description": "Fuel type, English label (e.g. Electric, Petrol)",
+            "type": "string"
+          },
+          "generation": {
+            "description": "Generation name",
+            "type": "string"
+          },
+          "generation_id": {
+            "description": "Opaque generation id — tells same-named variants of different generations apart",
+            "type": "string"
+          },
+          "model": {
+            "type": "string"
+          },
+          "model_id": {
+            "description": "Opaque model id, e.g. m_1a2b3c4d. Pass it to list_generations.",
+            "type": "string"
+          },
+          "power_hp": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Power, hp"
+          },
+          "price_new_eur": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "New list price, EUR"
+          },
+          "variant_id": {
+            "description": "Opaque variant id, e.g. v_1a2b3c4d. Pass it to get_specs / get_images / compare_variants.",
+            "type": "string"
+          },
+          "years": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Production years, e.g. '2019–2024'; an open range '2021–' is still in production"
+          }
+        },
+        "required": [
+          "variant_id",
+          "generation_id",
+          "model_id",
+          "display_name",
+          "brand",
+          "model",
+          "generation",
+          "fuel_slug",
+          "body_type_en",
+          "years",
+          "power_hp",
+          "battery_kwh",
+          "price_new_eur"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "data"
+  ],
+  "type": "object"
+}

Changed1 schema field 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"
+]

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.