SkillAgentSearch skills...

sdk

Official Auto.dev SDK, CLI and MCP server: VIN decode, vehicle listings, specs, OEM build data, recalls, payments and taxes

Install / Use

claude mcp add auto-dot-dev -- npx -y github:auto-dot-dev/sdk

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

74/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of sdk

sdk scores 74/100 on our quality scale, 98th of 107 Finance & Accounting skills we index.

Its MCP Server is 10 KB long, well organised into 19 sections with 15 code examples: a thorough specification that gives an agent plenty to work with.

It has 3 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
3/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 29 days ago, so sdk is actively maintained.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

sdk compared with similar skills

All 4 of these similar skills score higher than sdk; compare them before choosing.

SkillScoreStarsUpdatedFormat
sdk (this skill)by auto-dot-dev74329d agoMCP Server
Agent-Reachby Panniantong100112.8k10d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install sdk?
Run claude mcp add auto-dot-dev -- npx -y github:auto-dot-dev/sdk. The install tabs above show the steps for each supported agent.
Which AI agents does sdk work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is sdk safe to use?
It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is sdk still maintained?
The repository was last updated 29 days ago, so sdk is actively maintained.

@auto.dev/sdk

npm license

SDK, CLI, and MCP server for the auto.dev vehicle data APIs — VIN decoding, listings search, specs, recalls, payments, and more.

Quick Start

npx @auto.dev/sdk login
npx @auto.dev/sdk decode 1HGCM82633A004352

Or install globally for the auto shorthand:

npm install -g @auto.dev/sdk
auto login
auto decode 1HGCM82633A004352

auto login opens a browser for OAuth — no API key needed. Your token is stored locally and used by the CLI and MCP server automatically.

Alternatively, set an API key directly:

export AUTODEV_API_KEY=sk_ad_...

Get a free key at auto.dev/pricing.

CLI

auto decode <vin>                   # VIN decode
auto photos <vin>                   # vehicle photos
auto listings --make Toyota --year 2024 --price 10000-40000 --state CA
auto specs <vin>                    # detailed specifications
auto build <vin>                    # OEM build data
auto recalls <vin>                  # safety recalls
auto open-recalls <vin>             # unresolved recalls
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          # total cost of ownership
auto taxes <vin> --price 35000 --zip 90210
auto plate <state> <plate>          # license plate to VIN
auto usage                          # account usage stats
auto docs [query]                   # search bundled API docs
auto explore [endpoint]             # browse params and mappings

All commands support --json, --yaml, --raw, and --api-key <key> flags. Use npx @auto.dev/sdk in place of auto if not installed globally.

API metadata is stripped by default — you get clean vehicle data. Use --raw to see the full API response.

Configuration

auto config set raw true    # always show full responses
auto config get raw         # check current value
auto config list            # show all settings

Settings are stored in ~/.auto-dev/config.json.

MCP Server

Auto.dev exposes its full vehicle data API as native Model Context Protocol tools. Two paths — pick one:

| Path | Best for | Install | | --------------------------------------- | ---------------------------------------------------- | ------------------------ | | Remote — https://mcp.auto.dev/mcp | Hosted clients (Claude Desktop, ChatGPT), zero setup | None — just add the URL | | Local stdio — this SDK | CLI users, low-latency, offline-friendly | npm i -g @auto.dev/sdk |

Both expose the same tools. Remote authenticates via OAuth (one click). Stdio uses auto login or AUTODEV_API_KEY.

Fastest path — auto-install stdio

npx @auto.dev/sdk mcp install

Auto-configures Claude Code, Claude Desktop, and Cursor with the stdio MCP server.

Quickstart by Client

Claude Code

Remote:

claude mcp add -s user -t http auto-dev https://mcp.auto.dev/mcp

Then run /mcp and select Authenticate for auto-dev.

Stdio:

npx @auto.dev/sdk mcp install

Claude Desktop

Remote: Settings → Connectors → Add Custom Connector

  • Name: auto-dev
  • URL: https://mcp.auto.dev/mcp

Stdio: npx @auto.dev/sdk mcp install (auto-configures claude_desktop_config.json). Restart Claude Desktop.

Cursor

Remote: Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "auto-dev": {
      "url": "https://mcp.auto.dev/mcp"
    }
  }
}

Stdio: npx @auto.dev/sdk mcp install.

Windsurf

Remote: Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "auto-dev": {
      "serverUrl": "https://mcp.auto.dev/mcp"
    }
  }
}

Stdio: npx @auto.dev/sdk mcp install.

VS Code Copilot

Remote: Add to .vscode/mcp.json (workspace) or user settings:

{
  "servers": {
    "auto-dev": {
      "type": "http",
      "url": "https://mcp.auto.dev/mcp"
    }
  }
}

Requires VS Code 1.99+ with Copilot Agent mode.

Full setup guide: docs.auto.dev/v2/mcp-quickstart — covers more clients and troubleshooting.

Available MCP Tools

| Tool | Description | Plan | | ------------------- | --------------------------------------- | ------ | | auto_decode | Decode a VIN | Free | | auto_photos | Vehicle photos | Free | | auto_listings | Search listings with filters | Free | | auto_specs | Vehicle specifications | Growth | | auto_build | OEM build data | 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 | License plate to VIN | 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 | — |

SDK

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

const auto = new AutoDev({ apiKey: process.env.AUTODEV_API_KEY })
// API metadata is stripped by default. Pass raw: true to get full responses:
// const auto = new AutoDev({ apiKey: process.env.AUTODEV_API_KEY, raw: true })

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

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

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

// Total cost of ownership
const tco = await auto.tco('1HGCM82633A004352', { zip: '90210' })

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

All methods return:

{
  data: T,            // endpoint-specific response
  meta: {
    requestId: string,
    tier: string,
    usage?: { remaining: number }
  }
}

SDK Methods

| Method | Tier | Description | | ---------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | | decode(vin) | Free | Decode VIN — make, model, year, trim | | photos(vin) | Free | Vehicle photos | | listings(filters?) | Free | Search listings with filters | | specs(vin) | Growth | Detailed vehicle specifications | | build(vin) | Growth | OEM build and trim data; a 207 partial answer (build: null, vehicle, catalog, reason) when no record builds the VIN, see isPartialBuild | | recalls(vin) | Growth | Safety recalls | | payments(vin, opts?) | Growth | Monthly payment calculations | | apr(vin, opts?) | Growth | Interest rates by credit profile | | tco(vin, opts?) | Growth | Total cost of ownership | | openRecalls(vin) | Scale | Open/unresolved recalls | | plate(state, plate) | Scale | License plate to VIN | | taxes(vin, opts?) | Scale | Taxes and fees | | usage() | — | Account usage statistics |

Subpath Exports

import { AutoDev } from '@auto.dev/sdk' // SDK client
import { createMcpServer } from '@auto.dev/sdk/mcp' // MCP server
import { AutoDevClient } from '@auto.dev/sdk/core' // low-level client

Plans & Pricing

| Plan | Monthly | Endpoints | | ---------- | ------------------- | ------------------------------------------- | | Free | $0, no card | Decode, Listings, Photos | | Growth | $299/mo + data fees | + Specs, Build, Recalls, Payments, APR, TCO | | Scale | $599/mo + data fees | + Open Recalls, Plate-to-VIN, Taxes & Fees |

Free includes 1,000 API calls/month as a hard cap — requests stop at the limit and there are no data fees. Growth and Scale bill all API calls. See auto.dev/pricing for per-call data costs.

Documentation

Full docs at docs.auto.dev

License

MIT

Related Skills

View on GitHub
GitHub Stars3
CategoryFinance
Updated29d ago
Forks1

Languages

TypeScript

Trust signals

80/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 low