{
  "markdown": "# cars-data.com — Car Specs API + MCP server\n\nREST API and remote MCP server over cars-data.com's multilingual vehicle-specs\ndatabase: **102,191 vehicle variants**, **1,300+ models**, **5,299 generations**,\n**180 spec types across 19 categories**, in **19 languages**\n(including Arabic, RTL).\n\n- REST API: `https://api.cars-data.com/v1`\n- MCP server (streamable HTTP): `https://api.cars-data.com/mcp`\n- OpenAPI spec: [`openapi.yaml`](./openapi.yaml)\n- Also distributed as an [Apify Actor](https://apify.com/carsdatacom/car-specs-api) (pay-per-event, no API key needed)\n\n## MCP server\n\nConnect directly from Claude, ChatGPT connectors, Cursor, or Windsurf:\n\n```json\n{\n  \"mcpServers\": {\n    \"cars-data\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.cars-data.com/mcp\"\n    }\n  }\n}\n```\n\nTools exposed:\n\n| Tool | What it does |\n|---|---|\n| `search_cars` | Free-text search across 102,191 variants, 116 brands, 19 languages |\n| `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 |\n| `compare_variants` | Side-by-side localized specs for 2-4 variants |\n| `list_generations` | Generations/facelifts of a model, with production years |\n| `filter_cars` | Structured filter: fuel, body, drive, power/price range, year, EV-only |\n| `get_images` | Image URLs (own CDN) for a vehicle variant |\n\nThe MCP server is unauthenticated for discovery (rate-limited per IP). No signup required to try it.\n\n## REST API\n\nBase URL: `https://api.cars-data.com/v1`. Full reference in [`openapi.yaml`](./openapi.yaml).\n\n```bash\ncurl https://api.cars-data.com/v1/variants/42164/specs?locale=de \\\n  -H \"X-Api-Key: cd_free_...\"\n```\n\n| Endpoint | Description |\n|---|---|\n| `GET /brands`, `/brands/{slug}`, `/brands/{slug}/models` | Catalog: brands and models |\n| `GET /models/{id}/generations` | Generations for a model |\n| `GET /generations/{id}/variants` | Variants for a generation |\n| `GET /variants`, `/variants/{id}` | Filterable variant listing / single variant |\n| `GET /variants/{id}/specs?locale=` | Full localized specs (180 types, 19 languages) |\n| `GET /variants/{id}/images` | Image URLs |\n| `GET /variants/{id}/prices` | Price snapshot (single point-in-time, not a history) |\n| `GET /search?q=` | Free-text search |\n| `GET /compare?ids=` | Side-by-side specs for 2-4 variants |\n| `GET /specs/catalog` | The full spec-type catalog (categories + counts) |\n| `GET /usage` | Self-check current quota usage for your key |\n\n### Get a free API key\n\n```bash\ncurl -X POST https://api.cars-data.com/v1/keys \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"you@example.com\", \"accept_tos\": true}'\n```\n\nFree tier: 1,000 requests/month, 20 req/min.\n\n## Pricing\n\n- **Free** — 1,000 req/month, instant self-serve key, no payment.\n- **Apify** — pay-per-event, billed through the [Apify Store listing](https://apify.com/carsdatacom/car-specs-api), no API key needed.\n- **x402** — per-call USDC payment on Base for agents that want to pay without an account (not yet live — see the project roadmap).\n\nThere is no subscription/Stripe tier — Free and Apify (and, later, x402) are the only paid paths.\n\n## Data & attribution\n\nData comes from cars-data.com's multilingual vehicle-specs database. See\n[cars-data.com/api/terms](https://cars-data.com/api/terms) for the API Terms\nof Service (attribution required on Free tier; no bulk extraction / resale).\n\n## License\n\nThe API and its documentation in this repository are provided as-is. Access\nto the underlying dataset is governed by the [API Terms of Service](https://cars-data.com/api/terms),\nnot an open-source license — this repo documents and hosts the server\nimplementation, not a redistributable dataset.\n",
  "bytes": 3880,
  "sha": "41abc815b2664fae274b8eb30106d123121fc86541ae077ae76922209d26daec",
  "repo_slug": "mariusmmmmm/car-specs-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_cars_data_car_specs_api_4c6e29e1/readme"
}