Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

VIN MCP

von keptliveVersion 1.7.0i★ 1iLäuft in der CloudOffizielle Website ↗
Name in der Registryio.github.keptlive/vin-mcp

So installierst du es

Was es kann

Free VIN decoder: NHTSA specs, recalls, complaints, safety ratings, EPA fuel economy. No API key.

Originaltext des Herstellers

  • Verbindung Läuft in der Cloud
  • Konto oder Schlüssel Kein Schlüssel nötig
  • Kategorie Sonstiges

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit4/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert24/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte VIN MCP. Folge https://mcp.popnx.com/i/keptlive-vin-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.vin) · ✓ Befehle geprüft am 17. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameVIN MCP
    Remote MCP server URL · Adressehttps://mcp.vin/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsVIN MCP

  4. Ausprobieren

    Nutze VIN MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es VIN MCP nutzt, oder ein Werkzeug von VIN MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameVIN MCP
    Connection · Adressehttps://mcp.vin/mcp
  3. VIN MCP im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen VIN MCP aus deinen Plugins wählen

  4. Ausprobieren

    Nutze VIN MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es VIN MCP nutzt, oder ein Werkzeug von VIN MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user vin https://mcp.vin/mcp
  3. /mcp in Claude Code eingeben

    VIN MCP sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze VIN MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es VIN MCP nutzt, oder ein Werkzeug von VIN MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze VIN MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es VIN MCP nutzt, oder ein Werkzeug von VIN MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze VIN MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es VIN MCP nutzt, oder ein Werkzeug von VIN MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.vin/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die VIN MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user vin https://mcp.vin/mcp

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "vin": {
      "type": "http",
      "url": "https://mcp.vin/mcp"
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.7.0
Kategoriei
Sonstiges
In der Registry veröffentlichti
16. Nov. 2026
Code zuletzt geänderti
19. Nov. 2026
Zuletzt geprüft
17. Nov. 2026
Entwickler
keptlive
Website
mcp.vin
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 17. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • decode_vin

    Decode a VIN and return a vehicle report: specs, recalls, a complaint summary with the most recent complaints, safety ratings, fuel economy, and photo URLs.

  • validate_vin

    Quickly validate a VIN without calling any external APIs.

  • lookup_recalls

    Look up recalls for a vehicle. Provide either a VIN or make/model/year.

  • batch_decode

    Decode multiple VINs at once (up to 50).

  • explore_capabilities

    Discover supported features and explicit coverage gaps.

  • vin_recall_status

    VIN-specific manufacturer-reported open and completed recall status. Tesla and Ford open/completed states; GM completed/closed states with explicit repair dates where supplied; Honda active safety recalls; Nissan positive open safety recalls; Mopar positive open records matched t

  • vehicle_catalog

    Browse EPA year, make, model and configuration menus. Not sale listings.

  • epa_vehicle

    Get an explicitly selected EPA test configuration; not an exact VIN match.

  • vehicle_emissions

    Get EPA emissions for an explicit EPA vehicle ID.

  • fuel_price_assumptions

    EPA fuel-price assumptions, not local station prices.

  • owner_reported_mpg

    Voluntary owner-reported MPG for an EPA configuration, including sample size and limitations.

  • defect_investigations

    Search NHTSA model-year defect investigations with retained source variants and snapshot dates.

  • auto_loan_benchmarks

    Dated Federal Reserve new-car loan benchmark snapshot, not personalized or live loan rates.

  • vehicle_dimensions

    Canadian model-variant dimensions in cm and kg. Not VIN-specific.

  • manufacturer_communications

    Search indexed NHTSA communications, with source coverage. Bulletins are not recalls.

  • compare_vehicles

    Compare 2–4 distinct VINs without treating missing data as zero or counts as safety rankings.

  • ownership_scenario

    Calculate fixed-rate payments and optional ownership costs from explicit assumptions; not lender or tax quotes.

  • list_saved_vins

    List VINs saved by a user. Requires a user_token from /api/auth/login.

  • save_vin

    Save a VIN to a user's collection with an optional label.

  • remove_saved_vin

    Remove a VIN from the user's saved collection.

  • get_output_preferences

    Get the user's VIN report output preferences.

  • update_output_preferences

    Update which sections appear in VIN reports.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto keptlive bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 442 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 22 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/keptlive-vin-mcp.svg)](https://mcp.popnx.com/en/servers/keptlive-vin-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 86 % der anderen 20868 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 92 % der anderen 20868 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 20868 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist VIN MCP sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (1.7.0) kam vor 4 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

von koala73Weit verbreitet★ 90.934Aktualisiert vor 4 Tagen

Läuft in der Cloud✓ vom Dienst · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

von openstatusHQWeit verbreitet★ 9276Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

von JanDeDobbeleerWeit verbreitet★ 23.772 Sterne des ganzen ReposAktualisiert vor 31 Tagen

Läuft in der Cloud✓ vom Dienst · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

von Klavis-AIWachsend★ 5824Aktualisiert vor 14 Monaten

Läuft in der CloudRepo archiviert✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

von jitsucomWeit verbreitet★ 5136Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · jitsu.com
Im Vergleich mit ähnlichen
Dieser
VIN MCP
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen5/54/44/44/41/44/4
LizenzMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

VIN MCP

Free VIN decoder for humans and AI. No API keys or accounts required for public vehicle lookups. Rate limits apply.

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:

SourceData Provided
NHTSA vPICMake, model, year, trim, body class, engine specs, transmission, drive type, weight, plant info, 140+ decoded fields
NHTSA RecallsModel-year recall campaigns with component, summary, consequence, and remedy; not VIN repair status
NHTSA ComplaintsConsumer complaints with crash, fire, injury, and death statistics
NHTSA Safety RatingsNCAP star ratings for overall, frontal, side, and rollover crash tests
EPA Fuel EconomyCity/highway/combined MPG, annual fuel cost, CO2 emissions, EV range and charge time
IMAGIN.studioStock vehicle photos from multiple angles

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


Quick Start -- Connect via MCP

Remote HTTP (nothing to install, no API key)

Use the hosted MCP endpoint:

https://mcp.vin/mcp

Add to your MCP client config:

{

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


Smithery (one command)
npx -y @smithery/cli install @keptlive/vin-mcp --client claude
Claude Code (stdio)

Add to your .mcp.json:

{

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

Or if you have the repo cloned locally:

{

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

MCP Tools

The 22 tools are organized into three groups. The live directory at /api/tools and MCP tools/list come from the same registry. See service organization for extension and testing guidance.

GroupTools
Vehicle reportsdecode_vin, validate_vin, lookup_recalls, batch_decode
Research and analysisexplore_capabilities, vin_recall_status, vehicle_catalog, epa_vehicle, vehicle_emissions, fuel_price_assumptions, owner_reported_mpg, defect_investigations, auto_loan_benchmarks, vehicle_dimensions, manufacturer_communications, compare_vehicles, ownership_scenario
Saved vehicles and preferenceslist_saved_vins, save_vin, remove_saved_vin, get_output_preferences, update_output_preferences

Account tools require the user's website login token. Public lookup tools require no API key. Source coverage and unknown values are part of the returned data.

ToolDescriptionInput
decode_vinFull VIN decode with specs, recalls, complaints, safety ratings, fuel economy, and photos{ vin: string }
validate_vinQuick local validation -- checksum, WMI country/manufacturer, model year. No external API calls{ vin: string }
lookup_recallsLook up recalls by VIN or by make/model/year{ vin?: string, make?: string, model?: string, year?: number }
batch_decodeDecode up to 50 VINs in a single request via NHTSA batch API{ vins: string[] }

REST API

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

MethodEndpointDescription
GET/api/toolsGrouped MCP tool directory
GET/api/vin/:vinFull decode -- all 6 sources aggregated
GET/api/vin/:vin/validateQuick checksum and format validation
GET/api/vin/:vin/recallsRecall data only
GET/api/vin/:vin/complaintsConsumer complaints only
GET/api/vin/:vin/safetyNCAP safety ratings only
GET/api/vin/:vin/fuelEPA fuel economy only
GET/api/vin/:vin/photoRedirects to vehicle photo URL
POST/api/batchBatch decode (body: { "vins": ["VIN1", "VIN2", ...] }, max 50)

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 22+
  • 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

Unified vehicle workspace (v1.7.0)

The main workspace combines VIN reports and saved vehicles with EPA configurations/emissions, Canadian dimensions, manufacturer communications, defect investigations, owner-reported MPG, dated Federal Reserve rate benchmarks, 2-4 VIN comparisons, ownership scenarios and developer tools. Existing /research/ links continue into the matching section, including their search parameters. Accounts, preferences, educational pages and OAuth remain available. Public data coverage varies.

Research is available through REST, 22 MCP tools, the JavaScript client at public/client.mjs and the source CLI cli.mjs. The hosted service is https://mcp.vin; set VIN_BASE_URL for CLI use. This release does not publish an updated npm package.

See data sources and scope and the machine-readable guide at public/research/api.json. Printable capability-comparison and methodology sheets are in public/research/sheets/. These describe source scope; full auto.dev data parity is incomplete.

Run and verify

Use Node.js 22 or later, run npm ci, then npm start. Run npm test and node --test test/transport.test.mjs for the application and actual MCP transport checks. The Python importer tests use only the standard library: python3 tests/investigations_test.py, python3 tests/communications_storage_test.py and python3 tests/recall_labels_test.py.

Install public indexes with python3 scripts/import-communications.py, python3 scripts/import-investigations.py and python3 scripts/import-recall-labels.py. Use --refresh for a new official snapshot. The recall label index (data/recall-labels.db, about 10 MB, built in seconds from NHTSA's two recall flat files) lets reports find campaigns NHTSA files under another model name; without it, reports say the related-name list is partial. NHTSA updates the flat files daily; refresh the index when convenient (weekly is plenty). The standard bulletin index needs about 3.4 GB plus archives. To reduce storage without changing the API, run python3 scripts/compact-communications.py data/communications.db data/communications-compact.db. The compact target is a separate file, verified row for row; deploy it under the name data/communications.db. Never overwrite account data. No automatic source refresh is configured.

With the server and indexes running, node scripts/research-smoke.mjs verifies real sources, pagination and MCP; set VIN_BASE_URL to select a server.

Agent analysis

Agents can query the structured results, combine them with explicit assumptions, and use charting or document tools to create figures and analysis. Custom chart rendering happens in the agent's tools. The API supplies comparisons, scenario calculations, provenance and JSON. Configuration/model-year data and VIN-specific facts retain their distinct scopes.

VIN recall repair status: Tesla and Ford open/completed statuses, GM open/completed or administratively closed records, Honda and Acura active safety recalls, Subaru completed/incomplete safety recalls, Volkswagen, Audi, Land Rover and Jaguar recalls as reported by each maker, positive Nissan open safety recalls, and Mopar VIN-matched open recall/campaign records are included in reports and comparisons, with vin_recall_status, GET /api/vin/{vin}/recall-status and VinClient.recallStatus(vin). Mopar safety-recall count and completed history remain unknown because its feed mixes campaign types. GM repair dates are shown only when explicitly supplied; administrative closing dates remain separate. Ford customer-satisfaction and GM non-recall programs stay separate from recall counts. Honda covers active safety recalls from the past 15 calendar years and does not supply completed history. Nissan requires matching full VINs and verified safety classifications; empty results remain unknown. Toyota/Lexus/Scion, Hyundai and Kia require interactive official verification. Other makes remain unknown. See the source and coverage notes.

Deployment caching: HTML must revalidate, API responses must not be stored by shared caches, and changed JavaScript/PDF links use a content-hash query version generated by node scripts/version-assets.mjs. API clients also bypass stored browser responses. Preserve these policies in any reverse proxy so updated recall records are rendered by the matching client code.


License

MIT


Built for mcp.vin