cars-data.com — Car Specs API

com.cars-dataPublished by cars-data.comOfficial publisherv1.0.4Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableLocation & Lifestyle Data & Analytics

Server details

Identifier: com.cars-data/car-specs-api
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to cars-data.com, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/com.cars-data%2Fcar-specs-api.svg)](https://sourceweft.com/mcp/com.cars-data%2Fcar-specs-api?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Remote MCP server for searching, filtering and comparing car specifications from a large multilingual vehicle database, with a free demo set and paid full-catal

What you can do: Search cars by free text across brands, models and variants, with generation and production years to tell similar names apart. Retrieve full localized specifications for a variant, including engine, performance, EV, safety, dimensions and consumption, with confidence scores and a freshness timestamp. Compare two to four variants side by side. List generations and facelifts of a model with production years. Filter the catalog by fuel, body type, drive layout, power or price range, model year and EV-only. Get image URLs for a variant from the provider's own CDN.
When to use it: Useful when an assistant needs to answer car specification, comparison or shortlisting questions, or to look up vehicle data in one of many languages. The free demo covers a fixed 40-car set, so it suits evaluation and light queries; the full catalog requires a key or per-call payment.
Requirements: A remote streamable HTTP endpoint; no local runtime. Without credentials it answers from a fixed 40-car demo. Full-catalog access needs either an optional Authorization bearer API key (free tier available by email signup) or per-call payment, and network access to the provider.

Before you install

Full-catalog tools are billed per call, and the input describes payment in USDC on Base, which spends real funds; the README also says this payment path is not yet live, so check current status. An API key is sent in the Authorization header. Free-tier terms require attribution and forbid bulk extraction or resale. Demo-only tools return a limited 40-car set, which may be mistaken for full results.

Installation

In SourceWeft

Open cars-data.com — Car Specs API in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.cars-data%2Fcar-specs-api/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "cars-data-com-car-specs-api": {
      "type": "http",
      "url": "https://api.cars-data.com/mcp"
    }
  }
}

README

cars-data.com — Car Specs API + MCP server

REST API and remote MCP server over cars-data.com's multilingual vehicle-specs database: 102,191 vehicle variants, 1,300+ models, 5,299 generations, 180 spec types across 19 categories, in 19 languages (including Arabic, RTL).

REST API: https://api.cars-data.com/v1
MCP server (streamable HTTP): https://api.cars-data.com/mcp
OpenAPI spec: openapi.yaml
Also distributed as an Apify Actor (pay-per-event, no API key needed)

MCP server

Connect directly from Claude, ChatGPT connectors, Cursor, or Windsurf:

json

{  "mcpServers": {    "cars-data": {      "type": "http",      "url": "https://api.cars-data.com/mcp"    }  }}

{  "mcpServers": {    "cars-data": {      "type": "http",      "url": "https://api.cars-data.com/mcp"    }  }}

Tools exposed:

Tool	What it does
`search_cars`	Free-text search across 102,191 variants, 116 brands, 19 languages
`get_specs`	Full localized specs for one variant — 180 spec types across 19 categories (safety, comfort/interior, engine & fuel, performance, EV/hybrid, chassis, exterior, dimensions & weights, WLTP/NEDC consumption, and more), with a confidence score and `last_synced_at` freshness timestamp
`compare_variants`	Side-by-side localized specs for 2-4 variants
`list_generations`	Generations/facelifts of a model, with production years
`filter_cars`	Structured filter: fuel, body, drive, power/price range, year, EV-only
`get_images`	Image URLs (own CDN) for a vehicle variant

The MCP server is unauthenticated for discovery (rate-limited per IP). No signup required to try it.

REST API

Base URL: https://api.cars-data.com/v1. Full reference in openapi.yaml.

Endpoint	Description
`GET /brands`, `/brands/{slug}`, `/brands/{slug}/models`	Catalog: brands and models
`GET /models/{id}/generations`	Generations for a model
`GET /generations/{id}/variants`	Variants for a generation
`GET /variants`, `/variants/{id}`	Filterable variant listing / single variant
`GET /variants/{id}/specs?locale=`	Full localized specs (180 types, 19 languages)
`GET /variants/{id}/images`	Image URLs
`GET /variants/{id}/prices`	Price snapshot (single point-in-time, not a history)
`GET /search?q=`	Free-text search
`GET /compare?ids=`	Side-by-side specs for 2-4 variants
`GET /specs/catalog`	The full spec-type catalog (categories + counts)
`GET /usage`	Self-check current quota usage for your key

Get a free API key

bash

curl -X POST https://api.cars-data.com/v1/keys \  -H "Content-Type: application/json" \  -d '{"email": "[email protected]", "accept_tos": true}'

curl -X POST https://api.cars-data.com/v1/keys \  -H "Content-Type: application/json" \  -d '{"email": "[email protected]", "accept_tos": true}'

Free tier: 1,000 requests/month, 20 req/min.

Pricing

Free — 1,000 req/month, instant self-serve key, no payment.
Apify — pay-per-event, billed through the Apify Store listing, no API key needed.
x402 — per-call USDC payment on Base for agents that want to pay without an account (not yet live — see the project roadmap).

There is no subscription/Stripe tier — Free and Apify (and, later, x402) are the only paid paths.

Data & attribution

Data comes from cars-data.com's multilingual vehicle-specs database. See cars-data.com/api/terms for the API Terms of Service (attribution required on Free tier; no bulk extraction / resale).

License

The API and its documentation in this repository are provided as-is. Access to the underlying dataset is governed by the API Terms of Service, not an open-source license — this repo documents and hosts the server implementation, not a redistributable dataset.

Source: README.md at commit 889ca1e

Tools

search_cars

Search cars

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.

Parameterslimitqueryrequiredlocale

get_specs

Get variant specs

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.

Parameterslocalevariant_idrequired

compare_variants

Compare variants

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.

Parameterslocalevariant_idsrequired

list_generations

List generations of a model

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).

Parameterslocalemodel_idrequired

filter_cars

Filter cars

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.

Parametersevbodyfuelyeardrivelimitlocalepower_maxpower_minprice_max

get_images

Get variant images

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).

Parametersvariant_idrequired

search_catalogue

Search the full catalogue (paid)

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.

Parameterslimitqueryrequiredlocale

get_specs_full

Get full specs, any variant (paid)

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.

Parameterslocalevariant_idrequired

filter_catalogue

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.

Parametersevbodyfuelyeardrivelimitcursorlocalepower_maxpower_minprice_max

compare_full

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.