VIN MCP Server

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 l