# OEM Build Data API

> Retrieve complete vehicle details based on the VIN, including make, model, trim, color, options, and specifications.

OEM Build Data returns how a specific vehicle left the factory: trim, series, style, drivetrain, engine, transmission, interior and exterior colors, factory option codes and the options' MSRP. Send GET /build/{vin} with your API key. It is available from the Growth plan at $0.10 per call, or $0.08 on Scale.

## Endpoint

`GET https://api.auto.dev/build/{vin}`

- `vin` (path): 17-character Vehicle Identification Number (letters and digits, excluding I, O, and Q). Format: `[A-HJ-NPR-Z0-9]{17}`.

Authenticate with `Authorization: Bearer <key>`, `?apiKey=<key>` or `X-API-Key: <key>`.

```sh
curl "https://api.auto.dev/build/WP0AF2A99KS165242" \
  -H "Authorization: Bearer $AUTODEV_API_KEY"
```

## What it returns

- Trim, series and style
- Drivetrain, engine and transmission
- Interior and exterior color
- Factory option codes
- Options MSRP
- Match confidence

Response:

```json
{
  "build": {
    "vin": "WP0AF2A99KS165242",
    "year": 2019,
    "make": "Porsche",
    "model": "911",
    "trim": "GT3 RS Coupe",
    "series": "GT3 RS",
    "style": "2D Coupe",
    "drivetrain": "RWD",
    "engine": "4L H-6 gasoline direct injection, DOHC, VarioCam Plus variable valve control, premium unleaded, engine with 520HP",
    "transmission": "PDK 7-speed auto-shift manual",
    "confidence": 0.995,
    "interiorColor": {
      "Black": "#000000"
    },
    "exteriorColor": {
      "GT Silver Metallic": "#A2A2A2"
    },
    "options": {
      "474": "Front Axle Lift System",
      "QR5": "Chrono Package with Preparation For Lap Trigger",
      "U2": "GT Silver Metallic",
      "XDH": "Wheels Painted in Satin Platinum"
    },
    "optionsMsrp": 8950
  }
}
```

## Pricing

- Free: not available on this plan, 5 requests per second
- Growth: $0.10 per call, 10 requests per second
- Scale: $0.08 per call, 50 requests per second

## Use it from an AI agent

Hosted MCP server (recommended): https://mcp.auto.dev/mcp, named `auto-dev`. Sign-in is OAuth on first use, so agents never handle an API key.

- Claude Code: `claude mcp add --transport http auto-dev https://mcp.auto.dev/mcp`. Then run /mcp in Claude Code and choose Authenticate for auto-dev.
- Claude Desktop: In Settings, open Connectors, choose Add Custom Connector, name it auto-dev and paste https://mcp.auto.dev/mcp, then sign in
- Cursor (~/.cursor/mcp.json): `{"mcpServers":{"auto-dev":{"url":"https://mcp.auto.dev/mcp"}}}`. Restart Cursor. Sign-in opens on the first tool call.
- VS Code (.vscode/mcp.json): `{"servers":{"auto-dev":{"type":"http","url":"https://mcp.auto.dev/mcp"}}}`. For Copilot agent mode, VS Code 1.99 or later. Sign-in opens on first use.
- Windsurf (~/.codeium/windsurf/mcp_config.json): `{"mcpServers":{"auto-dev":{"serverUrl":"https://mcp.auto.dev/mcp"}}}`. Restart Windsurf. Sign-in opens on the first tool call.
- Grok Bot: send `Add a custom MCP server called auto-dev at https://mcp.auto.dev/mcp`. Confirm, then choose Authorize and sign in. Type @auto-dev in a chat to use it.
- Muse: send `Connect Auto.dev`. Or open Settings, then Connectors, and choose Connect next to Auto.dev. Sign in when asked.
- ChatGPT and dots: At chatgpt.com/plugins, choose + and Add custom MCP server, paste https://mcp.auto.dev/mcp and choose OAuth, then Create as a plugin. Your dot uses the same plugin

Or install the `auto` CLI, the local MCP server (`auto --mcp`) and the JavaScript SDK in one package:

```sh
npm install -g @auto.dev/sdk
auto login
auto mcp install
```

- Agent skill: `npx skills add drivly/auto-dev-skill`

This API is the `auto_build` MCP tool. From the terminal: `auto build WP0AF2A99KS165242`

## Questions

### What does the OEM Build Data API return?

Trim, series and style, drivetrain, engine and transmission, interior and exterior color, factory option codes, options MSRP, match confidence. Every response is JSON from `https://api.auto.dev/build/{vin}`.

### How much does the OEM Build Data API cost?

OEM Build Data is available from the Growth plan. It costs $0.10 per call on Growth and $0.08 per call on Scale, on top of the plan's subscription.

### How do I call the OEM Build Data API?

Send `GET /build/{vin}` to `api.auto.dev` with your API key as a Bearer token in the `Authorization` header, or as an `apiKey` query parameter. The path takes `vin`, the 17-character Vehicle Identification Number (letters and digits, excluding I, O, and Q).

### What are the rate limits for OEM Build Data?

Rate limits follow your plan: 5 requests per second on Free, 10 on Growth and 50 on Scale. OEM Build Data needs Growth or above.

### Can AI agents use the OEM Build Data API?

Yes. Connect the hosted MCP server, `https://mcp.auto.dev/mcp`, and agents such as Claude Code and Cursor call it as the `auto_build` tool, signing in with OAuth instead of an API key. Or run it locally: `npm install -g @auto.dev/sdk`, then `auto login` and `auto mcp install`.

## Related APIs

- [Global VIN Decode](https://www.auto.dev/vin.md): Decode any VIN to access comprehensive vehicle data and specifications.
- [Plate-to-VIN](https://www.auto.dev/plate-to-vin.md): Decode US license plates to get VIN, year, make, model, and more.
- [Specifications](https://www.auto.dev/specifications.md): Detailed technical specifications, features, and options for any vehicle model.

## References

- Docs: https://docs.auto.dev/v2/products/oem-build-data
- OpenAPI: https://www.auto.dev/openapi.json (JSON), https://www.auto.dev/openapi.yaml (YAML)
- llms.txt: https://www.auto.dev/llms.txt
- Pricing: https://www.auto.dev/pricing
- Sign up: https://www.auto.dev/signin?redirectUrl=%2Fonboarding