Auto.dev – Automotive Data

Auto.dev

Automotive data for AI 代理s — via MCP 工具s, 命令行工具 commands, SDK methods, or direct API calls.

检测 Your Surface

检查 in this order. Use the first one avAIlable:

• MCP — 检查 if auto_decode is in your avAIlable 工具s. If yes: use auto_* 工具s for everything. Do NOT make raw HTTP calls. To 安装: npx @auto.dev/sdk mcp 安装 (安装s globally and 配置s Claude Code, Claude 桌面, Cursor, Windsurf, VS Code Copilot, 命令行工具ne, Zed).

• 命令行工具 — 运行 auto --version. If 安装ed: 认证 once with auto 记录in (OAuth — no API key needed), then use auto commands. To 安装: npm 安装 -g @auto.dev/sdk or use npx @auto.dev/sdk without 安装ing.

• SDK — 检查 if @auto.dev/sdk is in project dependencies. If yes: use typed SDK methods. See code-patterns.md for all methods. To 安装: npm 安装 @auto.dev/sdk

• Direct API — 检查 for AUTODEV_API_KEY env var. If not 设置: ask the user for it or direct them to https://auto.dev/pricing (free 启动er plan).

MCP 工具s

If MCP 工具s are avAIlable, this is your only section. Use auto_docs to look up parameters and 响应 shapes before calling an unfamiliar 端点.

auto_docs 列出ings # see all 列出ing 过滤器s auto_docs payments # see payment params auto_docs vin-decode # see VIN decode 响应 shape

工具 Description Plan auto_decode Decode a VIN 启动er auto_列出ings 搜索 列出ings with 过滤器s 启动er auto_photos 获取 vehicle photos 启动er 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 扩展 auto_plate Plate to VIN ($0.55/call) 扩展 auto_taxes Taxes and fees 扩展 auto_docs 搜索 bundled API documentation — auto_config_设置 设置 a config value (e.g. raw: true) — auto_config_获取 获取 a config value or 列出 all 设置tings —

API metadata is stripped from MCP 工具 响应s by default. Use auto_config_设置 with key: "raw" and value: "true" to 获取 full 响应s.

If MCP 工具s are avAIlable, skip to 导入ant Rules below.

命令行工具 Quick Reference

安装: npm 安装 -g @auto.dev/sdk (or use npx @auto.dev/sdk without 安装ing) 认证 once: auto 记录in

auto decode auto photos auto 列出ings --make Toyota --year 2024 --price 10000-40000 --状态 CA auto specs auto build auto recalls auto open-recalls auto payments --price 35000 --zip 90210 --down-payment 5000 auto apr --year 2024 --make Honda --模型 Accord --zip 90210 --credit-score 750 auto tco --zip 90210 auto taxes --price 35000 --zip 90210 auto plate <状态> auto usage auto docs [查询] # 搜索 bundled docs auto explore [端点] # browse params and m应用ings

All commands support --json, --yaml, --raw, and --API-key flags.

API metadata is stripped by default — you 获取 清理 vehicle data. Use --raw to see the full API 响应.

auto config 设置 raw true # always show full 响应s auto config 获取 raw # 检查 current value auto config 列出 # show all 设置tings

Full 命令行工具 reference: https://docs.auto.dev/v2/命令行工具-mcp-sdk

If 命令行工具 is avAIlable, skip to 导入ant Rules below.

Direct API Quick Reference

Use these only when MCP and 命令行工具 are unavAIlable.

V2 (base: https://API.auto.dev): Authorization: Bearer {key} or ?APIKey={key} V1 (base: https://auto.dev/API): ?APIkey={key} (查询 string only)

端点 Plan Required Params 获取 /列出ings?过滤器s 启动er See v2-列出ings-API.md 获取 /列出ings/{vin} 启动er — 获取 /vin/{vin} 启动er — 获取 /photos/{vin} 启动er — 获取 /specs/{vin} Growth — 获取 /build/{vin} Growth — ($0.10/call) 获取 /recalls/{vin} Growth — 获取 /tco/{vin} Growth — 获取 /payments/{vin} Growth price, zip 获取 /apr/{vin} Growth year, make, 模型, zip, creditScore 获取 /openrecalls/{vin} 扩展 — 获取 /plate/{状态}/{plate} 扩展 — ($0.55/call) 获取 /taxes/{vin} 扩展 —

V1 supplemental (no V2 equivalent): /API/模型s, /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-列出ings-API.md | v2-vin-APIs.md | v2-plate-API.md | v1-APIs.md

Common Gotchas (All Surfaces)

These parameter names do NOT exist on the Direct API — 代理s hallucinate them frequently:

make= ← use vehicle.make 模型= ← use vehicle.模型 状态= ← use retAIl列出ing.状态 price= ← use retAIl列出ing.price (on /列出ings), or price= (on /payments, /taxes) rows= ← use limit 排序= ← no 排序 parameter exists _order= ← no 排序 parameter exists

MCP and 命令行工具 handle these m应用ings automatically. This only matters for Direct API calls.

Plans & Pricing

See pricing.md for full per-call costs and 升级 links.

Plan Monthly Includes 启动er Free + data fees VIN Decode, 列出ings, Photos (1,000 free calls/mo) Growth $299/mo + data fe