Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "get_specs"
Only numbers and dates differ: this server embeds live figures in the definition, so the text moves without the contract changing.
⟨6 unchanged words⟩ variant, in any of 20 languages —224232 spec types covering engine & fuel, performance, ⟨61 unchanged words⟩
Added "compare_full" and "filter_catalogue"; changed the definition of "compare_variants", "filter_cars", "get_images" and 3 more (8 tools before, 10 now)
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.⟨131 unchanged words⟩ :"object"},"type":"array"},"full_catalogue":{"description":"Present on demo answers: the paid tool that answers the same question over the full catalogue, with its price","type":"string"},"locale":{"description":"Language the response is ⟨29 unchanged words⟩
Changed the definition of "compare_variants", "filter_cars", "get_images" and 5 more
before
—after
Compare variants{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"locale":{"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.","enum":["en","ro","fr","de ⟨17 unchanged words⟩ :"string"},"variant_ids":{"description":"2 to 4 opaque variant ids from search_cars or filter_cars, e.g. ['v_1a2b3c4d', 'v_5e6f7a8b']","items":{"type":"string"}, ⟨10 unchanged words⟩
Added "get_specs_full" and "search_catalogue" (6 tools before, 8 now)
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.
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.
Changed the definition of "search_cars"
Only numbers and dates differ: this server embeds live figures in the definition, so the text moves without the contract changing.
Free-text search across 103,099372 vehicle variants,119120 brands, 20 languages. Returns candidate variant_ids to ⟨46 unchanged words⟩
Changed the definition of "search_cars"
⟨28 unchanged words⟩ from different generations can be told apart. Withoutan APIa keythis—answersorfromwith afixed 40-carself-serve demoset,keywhich—isthisalsoanswerswhat
Changed the definition of "search_cars"
⟨38 unchanged words⟩ key this answers from a fixed 40-car demoset;set, which is also what a freereviewedkeyopenscovers; thewholefullcatalogue.catalogue is a licensed export.
Authorization required → not required
Changed the definition of "compare_variants", "filter_cars", "get_images" and 3 more
⟨21 unchanged words⟩ ,"el","bg","da","ar","tr"],"type":"string"},"variant_ids":{"itemsdescription":{"maximumopaque variant ids from search_cars":9007199254740991,"minimumitems":-9007199254740991,{"type":"integerstring"},"maxItems":4,"minItems":2," ⟨6 unchanged words⟩
Authorization not required → required, Bearer
Certificate changed, valid to 2026-12-22
Certificate recorded, valid to 2026-10-24
Authorization not required
First tool surface recorded: 6 tools (server version 1.0.0)
Showing the latest 14 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨7 unchanged words⟩ 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.
⟨179 unchanged words⟩ demo set","type":"boolean"},"full_catalogue":{"description":"Present on demo answers: the paid tool that answers the same question over the full catalogue, with its price","type":"string"},"ignored_filters":{"description":"Filters you passed that ⟨21 unchanged words⟩
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).⟨44 unchanged words⟩ — 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.
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{},"properties":{"full_catalogue":{"description":"Present on demo answers: the paid tool that answers the same question over the full catalogue, with its price","type":"string"},"last_synced_at":{"description":"ISO-8601 time the data ⟨156 unchanged words⟩
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).⟨27 unchanged words⟩ variants from different generations can be told apart.WithoutThis answers from akeyfixed—40-carordemowithset.aForself-servethedemofullkey103,372-variant—cataloguethiscallanswerssearch_cataloguefrom—apaidfixedper40-carcalldemowithset;x402the(USDCfulloncatalogueBase),is$0.005,anolicensedkey,export.no account.
⟨170 unchanged words⟩ type":"object"},"type":"array"},"full_catalogue":{"description":"Present on demo answers: the paid tool that answers the same question over the full catalogue, with its price","type":"string"}},"required":["data"],"type":"object"}
Compare any variants (paid) — 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.
Filter the full catalogue (paid) — 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.
before
—after
{"$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"}before
—after
{"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true}before
—after
Filter cars⟨3 unchanged words⟩ ,"properties":{"body":{"description":"body_slugBody type, case-insensitive substring of the English label — e.g. suv, sedan, hatchback","type":"string"},"drive":{"description":"Drive layout, substring match,— e.g. 'front', 'rear','all''all'. Not applied by the demo set — reported back in ignored_filters.","type":"string"},"ev":{"description":"true = only variants with a traction battery (battery_kwh set: electric and plug-in). Default: false","type":"boolean"},"fuel":{"description":"Fuel type, case-insensitive substring of the English label — e.g. petrol, diesel, electric, hybrid","type":"string"},"limit":{"description":"Maximum number of results, 1–50. Default: 10.","maximum":50,"minimum":1,"type":"integer"},"locale":{"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.","enum":["en","ro","fr","de ⟨16 unchanged words⟩ ,"type":"string"},"power_max":{"description":"Maximum power, hp","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"power_min":{"description":"Minimum power, hp","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"price_max":{"description":"Maximum new list price, EUR","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"year":{"description":"Production year the generation covers, e.g. 2022. Not applied by the demo set — reported back in ignored_filters.","maximum":9007199254740991,"minimum":-9007199254740991,"type": ⟨3 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{},"properties":{"data":{"description":"Matches; 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"},"demo":{"description":"true when answered from the demo set","type":"boolean"},"ignored_filters":{"description":"Filters you passed that the demo set cannot apply — results are NOT narrowed by them","items":{"type":"string"},"type":"array"}},"required":["data"],"type":"object"}before
—after
{"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true}before
—after
Get variant images⟨3 unchanged words⟩ ,"properties":{"variant_id":{"description":"opaqueOpaque variant id from search_cars or filter_cars, e.g. v_1a2b3c4d","type":"string"}},"required": ⟨3 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{},"properties":{"data":{"description":"Images of the variant; empty when it has none","items":{"additionalProperties":{},"properties":{"url":{"description":"Image URL on the cars-data.com CDN","type":"string"},"variant":{"description":"hero = large lead image, card = thumbnail-size","enum":["hero","card"],"type":"string"}},"required":["url","variant"],"type":"object"},"type":"array"}},"required":["data"],"type":"object"}before
—after
{"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true}before
—after
Get variant specs{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"locale":{"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.","enum":["en","ro","fr","de ⟨17 unchanged words⟩ :"string"},"variant_id":{"description":"opaqueOpaque variant id from search_cars or filter_cars, e.g. ⟨7 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{},"properties":{"last_synced_at":{"description":"ISO-8601 time the data was last synced — surface it with the specs","type":"string"},"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"},"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","locale","last_synced_at","specs"],"type":"object"}before
—after
{"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true}before
—after
Get full specs, any variant (paid){"$schema":"http://json-schema.org/draft-07/schema#","properties":{"locale":{"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.","enum":["en","ro","fr","de ⟨17 unchanged words⟩ :"string"},"variant_id":{"description":"opaqueOpaque variant id from search_catalogue, e.g. v_1a2b3c4d"," ⟨6 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{},"properties":{"accel_0_100_s":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"0–100 km/h, seconds"},"battery_kwh":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Traction battery capacity, kWh"},"brand_slug":{"type":"string"},"display_name":{"description":"Full variant name","type":"string"},"last_synced_at":{"description":"ISO-8601 time the data was last synced — surface it with the specs","type":"string"},"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"},"model_slug":{"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"},"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"},"top_speed_kmh":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Top speed, km/h"},"torque_nm":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Torque, Nm"},"variant_id":{"description":"Opaque variant id, e.g. v_1a2b3c4d. Pass it to get_specs / get_images / compare_variants.","type":"string"},"year_from":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"First production year"},"year_to":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Last production year; 0 or null while still in production"}},"required":["variant_id","locale","display_name","brand_slug","model_slug","year_from","year_to","power_hp","battery_kwh","top_speed_kmh","torque_nm","accel_0_100_s","price_new_eur","last_synced_at","specs"],"type":"object"}before
—after
List generations of a model{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"locale":{"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.","enum":["en","ro","fr","de ⟨17 unchanged words⟩ :"string"},"model_id":{"description":"opaqueOpaque model id from a search_cars or filter_cars result, e.g. m_1a2b3c4d","type":"string"}} ⟨4 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{},"properties":{"data":{"description":"Generations of the model","items":{"additionalProperties":{},"properties":{"display_name":{"description":"Generation / facelift name","type":"string"},"generation_id":{"description":"Opaque generation id","type":"string"},"model_id":{"description":"Opaque model id","type":"string"},"years":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Production years, e.g. '2019–2024'; '2021–' is still in production"}},"required":["generation_id","model_id","display_name","years"],"type":"object"},"type":"array"}},"required":["data"],"type":"object"}before
—after
{"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true}before
—after
Search cars{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"limit":{"description":"Maximum number of results, 1–50. Default: 10.","maximum":50,"minimum":1,"type":"integer"},"locale":{"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.","enum":["en","ro","fr","de ⟨17 unchanged words⟩ :"string"},"query":{"description":"Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla models's'.","type":"string"}},"required": ⟨3 unchanged words⟩
before
—after
{"$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"}before
—after
{"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true}before
—after
Search the full catalogue (paid){"$schema":"http://json-schema.org/draft-07/schema#","properties":{"limit":{"description":"Maximum number of results, 1–50. Default: 10.","maximum":50,"minimum":1,"type":"integer"},"locale":{"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.","enum":["en","ro","fr","de ⟨17 unchanged words⟩ :"string"},"query":{"description":"Free text matched against brand, model and variant names, accent- and punctuation-insensitive — e.g. 'bmw 3 series' or 'tesla models's'.","minLength":2,"type":"string"} ⟨4 unchanged words⟩
before
—after
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":{},"properties":{"data":{"description":"Matches, most powerful first","items":{"additionalProperties":{},"properties":{"brand_slug":{"type":"string"},"display_name":{"description":"Full variant name, localized when a translation exists","type":"string"},"generation_id":{"description":"Opaque generation id","type":"string"},"model_slug":{"type":"string"},"variant_id":{"description":"Opaque variant id, e.g. v_1a2b3c4d. Pass it to get_specs_full.","type":"string"},"year_from":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"First production year of the generation"},"year_to":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Last production year; 0 or null while still in production"}},"required":["variant_id","display_name","brand_slug","model_slug","generation_id","year_from","year_to"],"type":"object"},"type":"array"}},"required":["data"],"type":"object"}⟨59 unchanged words⟩ ,"el","bg","da","ar","tr"],"type":"string"},"power_max":{ ⟨29 unchanged words⟩
{"$schema":"http://json-schema.org/draft-07/schema#","properties":{"variant_id":{"maximumdescription":9007199254740991,"minimumopaque variant id from search_cars":-9007199254740991,"type":"integerstring"}},"required":["variant_id"],"type":"object"}
Full localized specs for one vehicle variant, in any of1920 languages —180224 spec types covering engine & fuel, performance, EV/hybrid, safety(30 specs), comfort & interior(47), exterior, chassis, dimensions & weights, consumption ⟨20 unchanged words⟩
⟨21 unchanged words⟩ ,"el","bg","da","ar","tr"],"type":"string"},"variant_id":{"description":"opaque variant id from search_cars or filter_cars","maximum":9007199254740991,"minimume.g. v_1a2b3c4d":-9007199254740991,"type":"integerstring"}},"required":["variant_id"],"type":"object"}
⟨21 unchanged words⟩ ,"el","bg","da","ar","tr"],"type":"string"},"model_id":{"maximumdescription":9007199254740991,"minimumopaque model id, e.g. m_1a2b3c4d":-9007199254740991,"type":"integerstring"}},"required":["model_id"],"type":"object"}
Free-text search across102103,191099 vehicle variants,116119 brands,1920 languages. Returns candidate variant_ids to pass to get_specs/get_images/compare_variants. Each result carries generation_id andyear_from/year_toproduction years so same-named variants from different generations can be told apart. Without an API key this answers from a fixed 40-car demo set; a free reviewed key opens the whole catalogue.
⟨28 unchanged words⟩ ,"el","bg","da","ar","tr"],"type":"string"},"query":{ ⟨15 unchanged words⟩