# MotorsDynamic Developers > Vehicle data API read straight from dealer websites: listings, price history, OEM incentives and market prices for 9.4 million vehicles on 20,497 US dealer sites, refreshed every 48 hours. Free key with 1,000 calls a month. Base URL `https://api.motorsdynamic.com/api/v2`. Every page below has a Markdown version at the same URL plus `.md`. The whole API as one OpenAPI 3.1 document: https://developers.motorsdynamic.com/openapi.json ## When to use MotorsDynamic - You need what a dealer is advertising right now for a VIN: price, fees, photos, status, and how the price moved. - You need current OEM incentives or the market price range for a make and model. - You are building a car shopping agent and want tools instead of scraping dealer sites. ## Connect it as tools (MCP) Hosted MCP server, Streamable HTTP, OAuth sign-in with an email code (no API key in the agent): `https://gateway.automotivemcp.ai/vehicle-data/mcp` - Claude Code: `claude mcp add --transport http motorsdynamic https://gateway.automotivemcp.ai/vehicle-data/mcp` - Cursor (`~/.cursor/mcp.json`): `{"mcpServers":{"motorsdynamic":{"url":"https://gateway.automotivemcp.ai/vehicle-data/mcp"}}}` - VS Code (`.vscode/mcp.json`): `{"servers":{"motorsdynamic":{"type":"http","url":"https://gateway.automotivemcp.ai/vehicle-data/mcp"}}}` - Claude, ChatGPT, Grok: add a custom connector with the URL above. - Setup pages: [Claude](https://developers.motorsdynamic.com/docs/mcp/claude.md), [Claude Code](https://developers.motorsdynamic.com/docs/mcp/claude-code.md), [ChatGPT](https://developers.motorsdynamic.com/docs/mcp/chatgpt.md), [Cursor](https://developers.motorsdynamic.com/docs/mcp/cursor.md), [VS Code](https://developers.motorsdynamic.com/docs/mcp/vscode.md), [Grok](https://developers.motorsdynamic.com/docs/mcp/grok.md) ## Call it over HTTPS - Auth: `x-api-key: md_dev_...` (or `Authorization: Bearer`, or `?apiKey=`). Get a key at https://developers.motorsdynamic.com/signin - Errors: `{ "error": "", "message": "..." }`. Only 2xx responses are billed. - Plans: Free 1,000 calls a month at 5 requests a second; Growth $299 a month at 10 a second; Scale $599 a month at 50 a second; Enterprise by contract. ## Docs - [Quickstart](https://developers.motorsdynamic.com/docs/quickstart.md): From no account to a live response in about a minute. - [Authentication](https://developers.motorsdynamic.com/docs/authentication.md): One key, three ways to send it. - [Plans and rate limits](https://developers.motorsdynamic.com/docs/rate-limits.md): What each plan includes and how limits are reported. - [Errors](https://developers.motorsdynamic.com/docs/errors.md): One error shape, a short list of codes. - [MCP server](https://developers.motorsdynamic.com/docs/mcp.md): Vehicle data as tools for Claude, ChatGPT, Cursor, VS Code and Grok. ## APIs - [VIN decode](https://developers.motorsdynamic.com/docs/decode-vin.md): Decode a VIN. `GET https://api.motorsdynamic.com/api/v2/vin/{vin}`. Included on Free, then $0.0025 per call on Growth. - [Listings for a VIN](https://developers.motorsdynamic.com/docs/vin-listings.md): Where a VIN is listed, and at what advertised price. `GET https://api.motorsdynamic.com/api/v2/listings/{vin}`. Included on Free, then $0.0015 per call on Growth. - [Photos](https://developers.motorsdynamic.com/docs/vin-photos.md): Photos of a VIN. `GET https://api.motorsdynamic.com/api/v2/photos/{vin}`. Included on Free, then $0.0009 per call on Growth. - [Specifications](https://developers.motorsdynamic.com/docs/vin-specs.md): Specifications of a VIN. `GET https://api.motorsdynamic.com/api/v2/specs/{vin}`. Included on Free, then $0.0015 per call on Growth. - [Listing and price history](https://developers.motorsdynamic.com/docs/vin-history.md): Listing and price timeline of a VIN. `GET https://api.motorsdynamic.com/api/v2/history/{vin}`. Included on Free, then $0.0015 per call on Growth. - [Vehicle history](https://developers.motorsdynamic.com/docs/vehicle-timeline.md): Every listing, price change and removal recorded for a VIN, oldest first. `GET https://api.motorsdynamic.com/api/v2/vehicles/{vin}/timeline`. Included on Free, then $0.0015 per call on Growth. - [Fuel economy](https://developers.motorsdynamic.com/docs/vin-fuel.md): Fuel economy, range and emissions of a VIN. `GET https://api.motorsdynamic.com/api/v2/fuel/{vin}`. Included on Free, then $0.0015 per call on Growth. - [Owner complaints](https://developers.motorsdynamic.com/docs/vin-complaints.md): Owner complaints for the model year, make and model of a VIN. `GET https://api.motorsdynamic.com/api/v2/complaints/{vin}`. Included on Free, then $0.005 per call on Growth. - [Recalls](https://developers.motorsdynamic.com/docs/vin-recalls.md): Recall campaigns for the model year, make and model of a VIN. `GET https://api.motorsdynamic.com/api/v2/recalls/{vin}`. Included on Free, then $0.005 per call on Growth. - [Safety ratings](https://developers.motorsdynamic.com/docs/vin-safety.md): NHTSA safety ratings for a VIN. `GET https://api.motorsdynamic.com/api/v2/safety/{vin}`. Included on Free, then $0.005 per call on Growth. - [Market prices](https://developers.motorsdynamic.com/docs/market-prices.md): The price range of current dealer inventory for a make and model. `GET https://api.motorsdynamic.com/api/v2/market/prices`. Growth and up, $0.005 per call. - [OEM incentives](https://developers.motorsdynamic.com/docs/offers.md): Current OEM incentives with full terms: APR, lease and cash offers by make and model. `GET https://api.motorsdynamic.com/api/v2/offers`. Growth and up, $0.005 per call. - [Window sticker](https://developers.motorsdynamic.com/docs/vin-build.md): Window sticker (Monroney label) of a VIN. `GET https://api.motorsdynamic.com/api/v2/build/{vin}`. Growth and up, $0.08 per call. - [Interest rates](https://developers.motorsdynamic.com/docs/vin-apr.md): Market APR for a VIN by credit tier. `GET https://api.motorsdynamic.com/api/v2/apr/{vin}`. Growth and up, $0.005 per call. - [Payments](https://developers.motorsdynamic.com/docs/vin-payments.md): Loan and lease payment estimates for a VIN. `GET https://api.motorsdynamic.com/api/v2/payments/{vin}`. Growth and up, $0.005 per call. - [Taxes and fees](https://developers.motorsdynamic.com/docs/vin-taxes.md): Sales tax and fees on a VIN for a ZIP. `GET https://api.motorsdynamic.com/api/v2/taxes/{vin}`. Growth and up, $0.005 per call. - [Total cost of ownership](https://developers.motorsdynamic.com/docs/vin-tco.md): Five-year cost of ownership of a VIN. `GET https://api.motorsdynamic.com/api/v2/tco/{vin}`. Growth and up, $0.05 per call. - [Open recalls](https://developers.motorsdynamic.com/docs/vin-open-recalls.md): Recall status of this exact car, as its manufacturer reports it. `GET https://api.motorsdynamic.com/api/v2/openrecalls/{vin}`. Scale and up, $0.03 per call. ## Enterprise APIs - [Collection runs](https://developers.motorsdynamic.com/docs/runs.md): Collection run history of a site. `GET https://api.motorsdynamic.com/api/v2/runs`. - [Dealer inventory](https://developers.motorsdynamic.com/docs/inventory.md): Current listings of one site. `GET https://api.motorsdynamic.com/api/v2/dealers/{domainId}/inventory`. - [Dealer specials](https://developers.motorsdynamic.com/docs/specials.md): Dealer-site specials with stable ids. `GET https://api.motorsdynamic.com/api/v2/specials`. - [Dealers](https://developers.motorsdynamic.com/docs/dealers.md): Sites (rooftops) the caller is entitled to. `GET https://api.motorsdynamic.com/api/v2/dealers`. - [Inventory change feed](https://developers.motorsdynamic.com/docs/changes.md): Change feed of one site. `GET https://api.motorsdynamic.com/api/v2/dealers/{domainId}/changes`. - [New units and in-transit](https://developers.motorsdynamic.com/docs/new-units.md): New cars of one store, with in-stock or in-transit status. `GET https://api.motorsdynamic.com/api/v2/dealers/{domainId}/new-units`. - [Refresh specials](https://developers.motorsdynamic.com/docs/refresh-target.md): Customer-triggered crawl of one collection kind. `POST https://api.motorsdynamic.com/api/v2/targets/{domainId}/refresh`. - [Register a dealer](https://developers.motorsdynamic.com/docs/register-dealer.md): Register a site for an agency. `POST https://api.motorsdynamic.com/api/v2/dealers`. - [Register specials targets](https://developers.motorsdynamic.com/docs/register-targets.md): Register sites for a collection kind (dealer-site specials). `POST https://api.motorsdynamic.com/api/v2/targets`. - [Remove a specials target](https://developers.motorsdynamic.com/docs/delete-target.md): Stop collecting a kind for the caller's agency. `DELETE https://api.motorsdynamic.com/api/v2/targets/{domainId}`. - [Request a recrawl](https://developers.motorsdynamic.com/docs/recrawl-dealer.md): Ask for a targeted follow-up crawl. `POST https://api.motorsdynamic.com/api/v2/dealers/{domainId}/recrawl`. - [Special history](https://developers.motorsdynamic.com/docs/special-history.md): One special's change log. `GET https://api.motorsdynamic.com/api/v2/specials/{specialId}/history`. - [Specials change feed](https://developers.motorsdynamic.com/docs/specials-history.md): A site's specials change feed. `GET https://api.motorsdynamic.com/api/v2/specials/history`. ## Optional - [Everything on one page](https://developers.motorsdynamic.com/llms-full.txt) - [Pricing](https://developers.motorsdynamic.com/pricing.md) - [Documentation index](https://developers.motorsdynamic.com/docs.md)