Menu
Use when working with Auto.dev APIs, vehicle data, VIN decoding, car listings, vehicle photos, specs, recalls, payments, interest rates, taxes, OEM build data, plate-to-VIN, CLI commands, MCP tools, or SDK methods for any automotive data task
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | auto-dev |
| description | Use when working with Auto.dev APIs, vehicle data, VIN decoding, car listings, vehicle photos, specs, recalls, payments, interest rates, taxes, OEM build data, plate-to-VIN, CLI commands, MCP tools, or SDK methods for any automotive data task |
| version | 1.1.3 |
| tags | ["automotive","vehicle-data","vin","listings","api","auto-dev","car-search","recalls","mcp","sdk","cli"] |
| homepage | https://github.com/drivly/auto-dev-skill |
| metadata | {"openclaw":{"env":{"AUTODEV_API_KEY":{"description":"Optional โ only needed for Direct API usage. CLI and MCP use OAuth via `auto login` instead.","required":false,"secret":true}}}} |
Automotive data for AI agents โ via MCP tools, CLI commands, SDK methods, or direct API calls.
Check in this order. Use the first one available:
1. MCP โ Check if auto_decode is in your available tools.
If yes: use auto_* tools for everything. Do NOT make raw HTTP calls.
To install: npx @auto.dev/sdk mcp install (installs globally and configures Claude Code, Claude Desktop, Cursor, Windsurf, VS Code Copilot, Cline, Zed).
2. CLI โ Run auto --version.
If installed: authenticate once with auto login (OAuth โ no API key needed), then use auto commands.
To install: npm install -g @auto.dev/sdk or use npx @auto.dev/sdk <command> without installing.
3. SDK โ Check if @auto.dev/sdk is in project dependencies.
If yes: use typed SDK methods. See code-patterns.md for all methods.
To install: npm install @auto.dev/sdk
4. Direct API โ Check for AUTODEV_API_KEY env var.
If not set: ask the user for it or direct them to https://auto.dev/pricing (free Starter plan).
If MCP tools are available, this is your only section. Use auto_docs to look up
parameters and response shapes before calling an unfamiliar endpoint.
auto_docs listings # see all listing filters
auto_docs payments # see payment params
auto_docs vin-decode # see VIN decode response shape
| Tool | Description | Plan |
|---|---|---|
auto_decode | Decode a VIN | Starter |
auto_listings | Search listings with filters | Starter |
auto_photos | Get vehicle photos | Starter |
auto_specs | Vehicle specifications | Growth |
auto_build | OEM build data ($0.10/call) | Growth |
auto_recalls | Safety recalls | Growth |
auto_payments | Payment calculations | Growth |
auto_apr | Interest rates | Growth |
auto_tco | Total cost of ownership | Growth |
auto_open_recalls | Open/unresolved recalls | Scale |
auto_plate | Plate to VIN ($0.55/call) | Scale |
auto_taxes | Taxes and fees | Scale |
auto_docs | Search bundled API documentation | โ |
auto_config_set | Set a config value (e.g. raw: true) | โ |
auto_config_get | Get a config value or list all settings | โ |
API metadata is stripped from MCP tool responses by default. Use auto_config_set with key: "raw" and value: "true" to get full responses.
If MCP tools are available, skip to Important Rules below.
Install: npm install -g @auto.dev/sdk (or use npx @auto.dev/sdk without installing)
Authenticate once: auto login
auto decode <vin>
auto photos <vin>
auto listings --make Toyota --year 2024 --price 10000-40000 --state CA
auto specs <vin>
auto build <vin>
auto recalls <vin>
auto open-recalls <vin>
auto payments <vin> --price 35000 --zip 90210 --down-payment 5000
auto apr <vin> --year 2024 --make Honda --model Accord --zip 90210 --credit-score 750
auto tco <vin> --zip 90210
auto taxes <vin> --price 35000 --zip 90210
auto plate <state> <plate>
auto usage
auto docs [query] # search bundled docs
auto explore [endpoint] # browse params and mappings
All commands support --json, --yaml, --raw, and --api-key <key> flags.
API metadata is stripped by default โ you get clean vehicle data. Use --raw to see the full API response.
auto config set raw true # always show full responses
auto config get raw # check current value
auto config list # show all settings
Full CLI reference: https://docs.auto.dev/v2/cli-mcp-sdk
If CLI is available, skip to Important Rules below.
Use these only when MCP and CLI are unavailable.
V2 (base: https://api.auto.dev): Authorization: Bearer {key} or ?apiKey={key}
V1 (base: https://auto.dev/api): ?apikey={key} (query string only)
| Endpoint | Plan | Required Params |
|---|---|---|
GET /listings?filters | Starter | See v2-listings-api.md |
GET /listings/{vin} | Starter | โ |
GET /vin/{vin} | Starter | โ |
GET /photos/{vin} | Starter | โ |
GET /specs/{vin} | Growth | โ |
GET /build/{vin} | Growth | โ ($0.10/call) |
GET /recalls/{vin} | Growth | โ |
GET /tco/{vin} | Growth | โ |
GET /payments/{vin} | Growth | price, zip |
GET /apr/{vin} | Growth | year, make, model, zip, creditScore |
GET /openrecalls/{vin} | Scale | โ |
GET /plate/{state}/{plate} | Scale | โ ($0.55/call) |
GET /taxes/{vin} | Scale | โ |
V1 supplemental (no V2 equivalent): /api/models, /api/cities, /api/zip/{zip}, /api/autosuggest/{term}
Before making any Direct API call, read the relevant reference file for full parameter names and examples. Full parameter reference: v2-listings-api.md | v2-vin-apis.md | v2-plate-api.md | v1-apis.md
These parameter names do NOT exist on the Direct API โ agents hallucinate them frequently:
make= โ use vehicle.make
model= โ use vehicle.model
state= โ use retailListing.state
price= โ use retailListing.price (on /listings), or price= (on /payments, /taxes)
rows= โ use limit
sort= โ no sort parameter exists
_order= โ no sort parameter exists
MCP and CLI handle these mappings automatically. This only matters for Direct API calls.
See pricing.md for full per-call costs and upgrade links.
| Plan | Monthly | Includes |
|---|---|---|
| Starter | Free + data fees | VIN Decode, Listings, Photos (1,000 free calls/mo) |
| Growth | $299/mo + data fees | + Specs, Recalls, TCO, Payments, APR, Build |
| Scale | $599/mo + data fees | + Open Recalls, Plate-to-VIN, Taxes & Fees |
All plans charge per-call data fees on every request. Growth/Scale have no cap on volume but data fees still apply.
MCP or CLI: use auto_docs [query] or auto docs [query] for live parameter lookup.
Full reference: https://docs.auto.dev/v2/cli-mcp-sdk
SDK: see code-patterns.md for typed methods and response format.
Direct API: