VIN MCP

Free VIN decoder for humans and AI. No API keys. No accounts. No limits.

mcp.vin -- Try it now

What It Does

Enter a 17-character VIN and get a comprehensive vehicle report by aggregating six free data sources into a single response:

Additionally, VIN validation (checksum, WMI country/manufacturer decode, model year) is computed locally with zero API calls.

Quick Start -- Connect via MCP

Smithery (one command)

npx -y @smithery/cli install @keptlive/vin-mcp --client claude

Claude Code (stdio)

Add to your .mcp.json:

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

Or if you have the repo cloned locally:

{
  "mcpServers": {
    "vin": {
      "command": "node",
      "args": ["/path/to/vin-mcp/server.mjs"]
    }
  }
}

Claude Desktop / claude.ai (HTTP)

Use the hosted MCP endpoint:

https://mcp.vin/mcp

Add to your Claude Desktop config:

{
  "mcpServers": {
    "vin": {
      "url": "https://mcp.vin/mcp"
    }
  }
}

MCP Tools

REST API

All endpoints are available at https://mcp.vin or on your self-hosted instance.

Rate limits: 30 requests/minute per IP for most endpoints, 60/minute for validation and photos, 5/minute for batch.

Example:

curl https://mcp.vin/api/vin/1HGCM82633A004352

Direct VIN URLs also work -- visit https://mcp.vin/1HGCM82633A004352 to see the web report.

Self-Hosting

git clone https://github.com/keptlive/vin-mcp.git
cd vin-mcp
npm install
node server.mjs --http --port 3200

The server starts in HTTP mode with:

• Web frontend at http://localhost:3200

• REST API at http://localhost:3200/api/vin/{vin}

• MCP endpoint at http://localhost:3200/mcp

For stdio mode (Claude Code integration without a web server):

node server.mjs

How VINs Work

A VIN (Vehicle Identification Number) is a 17-character code assigned to every vehicle manufactured since 1981. Each position encodes specific information:

1 H G C M 8 2 6 3 3 A 0 0 4 3 5 2
|_____| |___| | | | |_| |_________|
  WMI    VDS  | | | |yr  Sequential
              | | | plant
              | | check digit
              | vehicle attributes
              manufacturer ID

• Positions 1-3 (WMI): World Manufacturer Identifier -- country and manufacturer

• Positions 4-8 (VDS): Vehicle Descriptor Section -- model, body, engine, transmission

• Position 9: Check digit -- validates the VIN using a weighted algorithm

• Position 10: Model year code (A-Y, 1-9 on a 30-year cycle)

• Position 11: Assembly plant

• Positions 12-17: Sequential production number

The letters I, O, and Q are never used in VINs to avoid confusion with 1, 0, and 9.

Tech Stack

• Runtime: Node.js 18+

• Server: Express 5

• MCP SDK: @modelcontextprotocol/sdk with stdio and Streamable HTTP transports

• Frontend: Vanilla HTML, CSS, and JavaScript

• Caching: In-memory LRU with TTL (1h for decodes, 6h for recalls, 24h for ratings and fuel data)

• External dependencies: Zero API keys required -- all data sources are free public APIs

License

MIT

Built for mcp.vin