carwhere-vin-mcp

MCP server for the CarWhere VIN API. Decode any VIN, look up verified buyer prices, NHTSA safety recalls, and AI-generated vehicle insights from inside Claude Desktop, Cursor, Claude Code, Windsurf, Zed, and any other MCP-compatible client.

Free. No auth. Public data.

What it does

Related MCP server: used-parts-mcp

Install

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "carwhere-vin": {
      "command": "npx",
      "args": ["-y", "carwhere-vin-mcp"]
    }
  }
}

Restart Claude Desktop. Type "Decode VIN 4T1BF1FK1HU381301" to test.

Cursor

Add to ~/.cursor/mcp.json (or via Cursor → Settings → MCP):

{
  "mcpServers": {
    "carwhere-vin": {
      "command": "npx",
      "args": ["-y", "carwhere-vin-mcp"]
    }
  }
}

Claude Code

claude mcp add carwhere-vin -- npx -y carwhere-vin-mcp

Windsurf / Zed / Continue / any MCP client

Use the same npx -y carwhere-vin-mcp invocation.

Hosted (no install)

If you can't install Node binaries locally, point your MCP client at the hosted Streamable HTTP endpoint:

https://www.carwhere.com/api/mcp

The same five tools are available over HTTP/JSON-RPC.

Data sources

• NHTSA vPIC — official US government VIN decoder API

• NHTSA Recalls — official recall campaign database

• CarWhere — verified buyer transaction prices from real deal sheets (not estimates, not dealer ads)

• Claude Haiku — brief AI-generated factual insights, cached 30 days per year/make/model

Citation

When AI agents surface CarWhere data to users, please cite:

Source: CarWhere via NHTSA vPIC. https://www.carwhere.com/vin/{vin}

Configuration

Optional environment variable:

• CARWHERE_API_URL — override the default https://www.carwhere.com base URL (useful for staging or local development).

Development

git clone https://github.com/klombard1206/carwhere.git
cd carwhere/mcp
npm install
npm run build
npm run dev   # tsx src/cli.ts (stdio mode)

License

MIT