English Français العربية

io.github.Carwhere/vin-mcp

Registre officiel E-commerce

Decode any US-market VIN, check NHTSA recalls, and look up verified buyer-paid car prices. Free.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package carwhere-vin-mcp
Claude Code 
claude mcp add vin-mcp -- npx -y carwhere-vin-mcp@0.1.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vin-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "carwhere-vin-mcp@0.1.3"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. carwhere-vin-mcp
  2. What it does
  3. Install
  4. Data sources
  5. Citation
  6. Commercial disclosure
  7. Configuration
  8. Development
  9. License

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. One clearly labeled paid tool (buy_vin_report) — see Commercial disclosure.

What it does

ToolReturns
decode_vinYear, make, model, trim, engine, transmission, plant from NHTSA vPIC + CarWhere buyer pricing + open recalls + AI insight
check_recallsOpen NHTSA safety recalls by VIN or year/make/model
get_pricingVerified buyer-transaction pricing for any year/make/model (optionally state)
validate_vin_check_digitOffline ISO 3779 / 49 CFR §565.15 checksum validator
buy_vin_reportSecure Stripe checkout link for the $9.99 CarWhere Full VIN Report (window sticker, MSRP & options, recall scan, market price)
about_carwhereServer description and data sources

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}

Commercial disclosure

This server is built and operated by CarWhere, the company behind the pricing data it serves. Plainly stated:

  • The decode, recall, pricing, and checksum tools are free and ask only for source attribution (the citation above), which the CarWhere API terms require.
  • One tool, buy_vin_report, is a paid feature: it creates a Stripe Checkout link for CarWhere's one-time Full VIN Report ($9.99, or $19.99 for a 3-VIN comparison). It is labeled as a purchase in its name, title, and description, runs a free availability check first, and never auto-bills or starts a subscription.
  • Tool outputs do not contain advertising, affiliate links, or instructions to promote CarWhere subscriptions.

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/carwhere/vin-mcp.git
cd vin-mcp
npm install
npm run build
npm run dev   # tsx src/cli.ts (stdio mode)

License

MIT

Questions fréquentes

Qu'est-ce que io.github.Carwhere/vin-mcp ?

Decode any US-market VIN, check NHTSA recalls, and look up verified buyer-paid car prices. Free.

Comment installer io.github.Carwhere/vin-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add vin-mcp -- npx -y carwhere-vin-mcp@0.1.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.Carwhere/vin-mcp ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.Carwhere/vin-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.Carwhere/vin-mcp ?

Il est publié par carwhere. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.