Install

Install globally and configure your AI tools in one command:

npx @auto.dev/sdk mcp install

This installs the auto CLI globally and auto-configures the MCP server in Claude Code, Claude Desktop, and Cursor.

Or install the CLI only:

npm install -g @auto.dev/sdk

Then configure MCP separately if needed:

auto mcp install

CLI

Authenticate

auto login

Opens your browser for OAuth login. No API key needed for CLI usage after login.

Commands

Examples

Decode a VIN:

auto decode 1HGCM82633A004352

Search listings with filters:

auto listings --make Toyota --year 2024 --price 10000-40000 --state CA

Calculate payments:

auto payments 1HGCM82633A004352 --price 35000 --zip 90210 --down-payment 5000

Get interest rates:

auto apr 1HGCM82633A004352 --year 2024 --make Honda --model Accord --zip 90210 --credit-score 750

Output as JSON:

auto decode 1HGCM82633A004352 --json

Discover APIs

Use explore to browse available endpoints, view parameters, and see how shorthand params map to the actual API:

auto explore

Inspect a specific endpoint's parameters:

auto explore listings

This shows each parameter with its shorthand name, whether it's required or optional, and the real API parameter name it maps to (e.g. make → vehicle.make).

Search Documentation

Browse bundled API documentation right from your terminal:

auto docs

View documentation for a specific endpoint:

auto docs listings

You can use either the shorthand name (recalls) or the full doc name (vehicle-recalls) — both work.

MCP Server

The MCP (Model Context Protocol) server lets AI assistants like Claude access auto.dev APIs directly. If you used npx @auto.dev/sdk mcp install above, it's already configured.

Supported Clients

• Claude Code — ~/.claude.json
• Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor — ~/.cursor/mcp.json

Manual Configuration

If you prefer to configure manually, add to your MCP client config:

{
  "mcpServers": {
    "auto-dev": {
      "command": "auto",
      "args": ["--mcp"]
    }
  }
}

Available Tools

Every CLI command above is available as an MCP tool, prefixed with auto_ (e.g. auto_decode, auto_listings, auto_payments). The auto_docs tool gives AI agents access to the full API documentation — agents can search by endpoint name or keyword to understand parameters, response formats, and usage patterns.

Check Status

auto mcp status

SDK

Install

npm install @auto.dev/sdk

Initialize

import { AutoDev } from '@auto.dev/sdk'

const auto = new AutoDev({ apiKey: 'YOUR_API_KEY' })

Methods

// Decode a VIN
const vehicle = await auto.decode('1HGCM82633A004352')

// Get photos
const photos = await auto.photos('1HGCM82633A004352')

// Search listings
const listings = await auto.listings({
  'vehicle.make': 'Toyota',
  'vehicle.year': '2024',
  'retailListing.price': '10000-40000',
})

// Get specs
const specs = await auto.specs('1HGCM82633A004352')

// Calculate payments
const payments = await auto.payments('1HGCM82633A004352', {
  price: 35000,
  zip: '90210',
  downPayment: 5000,
})

// Get interest rates
const apr = await auto.apr('1HGCM82633A004352', {
  year: 2024,
  make: 'Honda',
  model: 'Accord',
  zip: '90210',
  creditScore: '750',
})

// Total cost of ownership
const tco = await auto.tco('1HGCM82633A004352')

// Plate to VIN
const plate = await auto.plate('CA', 'ABC1234')

// Taxes and fees
const taxes = await auto.taxes('1HGCM82633A004352', { zip: '90210' })

// Account usage
const usage = await auto.usage()

Response Format

All methods return:

{
  data: T,          // Response data
  meta: {
    requestId: string,
    tier: string,
    usage?: { remaining: number }
  }
}