记忆
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
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
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 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
auto photos
auto listings --make Toyota --year 2024 --price 10000-40000 --state 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 --model Accord --zip 90210 --credit-score 750
auto tco --zip 90210
auto taxes --price 35000 --zip 90210
auto 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 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:
Vehicle intelligence for AI agents — decode any 17-char VIN with a factory-warranty-terms block, MERGED US (NHTSA) + Canada (Transport Canada) recalls, LLM-clustered known issues with ODI citations plus a reliability-aggregates block, and itemized used-car drive-away costs for all 50 US states + DC and all 13 Canadian jurisdictions. Pay-per-call via x402 (USDC on Base); no accounts, no keys. Free /v1/sample/* endpoints return every response shape before you pay.
Autom (autom.dev). Use this skill for ANY Autom request — searching and reading data. Whenever a task involves Autom, use this skill instead of calling the API directly.
Car diagnostics and maintenance assistant. Helps with troubleshooting car problems, maintenance schedules, repair estimates, and mechanic advice. Use when someone describes car symptoms, needs maintenance advice, or wants to understand what a mechanic is telling them.
Streamline auto-body service bookings with Lokuli MCP. Effortlessly find and schedule appointments for auto-body repairs, dents, and painting. Handles requests like 'book auto-body', 'find auto-body near me', or any related service. Reliable, fast, and fully automated to save time and ensure accurat
Use when the user asks what car maintenance is due or overdue, whether a service can wait, what a dealer 'recommended service' actually contains, or to build a maintenance schedule and budget from mileage, vehicle age, and service history. Computes dual-interval status (every N km OR M months, whichever first), applies a severe-service multiplier for city/short-trip/towing driving, projects a 24-month service timeline from annual mileage, and shows typical cost ranges and DIY difficulty so owners can challenge upselling.
基于聚合数据 VIN 查询车辆信息（精准版）API，通过车辆 VIN 码（车架号）查询品牌、车系、车型、排量、排放标准、外形尺寸、轮胎规格、变速器类型、公告号、轴距等详细车辆档案信息。本技能使用无需用户注册聚合数据平台，安装后即可按实际查询付费使用。 VIN 查车辆信息-精准版技能是根据用户提供的 VIN 码，提供车辆基础档案与配置参数的支付宝 AI 付付费技能，基于 A2M（HTTP 402）收单协议。买家通过本 Skill 向卖家服务端发起请求，完成支付后获取相关结果。 调用过程仅上传查询用的 VIN 码至聚合数据服务端，无需提供手机号、身份证等其他个人隐私。适用于用户查询指定 VIN 码对应的车辆品牌车型、动力配置、车身尺寸等档案信息的场景。