Skip to content

Recall repairs: links to the maker and NHTSA; no manufacturer requests - #35

Open
keptlive wants to merge 8 commits into
nhtsa-photosfrom
safe-sources
Open

keptlive wants to merge 8 commits into
nhtsa-photosfrom
safe-sources

Conversation

@keptlive

Copy link
Copy Markdown
Owner

After the terms review of 18 November 2026, mcp.vin stops asking manufacturers about a VIN. Every place that showed a VIN's recall repair status (website, REST, MCP, client library, CLI) now shows NHTSA's model-year campaigns, then a link to the maker's own recall page and a link to NHTSA's recall page. Stacked on #30 (nhtsa-photos). Not deployed.

What a report says now

recall_status keeps its key and becomes a link block:

{"vin": "1FTEX1EP4FFD06976", "available": false, "reason": "manufacturer_link_only", "checked_by_mcp_vin": false,
 "maker": "Ford", "manufacturer_lookup_url": "https://www.ford.com/support/recalls-details/1FTEX1EP4FFD06976/",
 "manufacturer_page_url": "https://www.ford.com/support/recalls/", "vin_prefilled": true,
 "nhtsa_lookup_url": "https://www.nhtsa.gov/recalls?vin=1FTEX1EP4FFD06976", "nhtsa_vin_prefilled": null,
 "open_count": null, "completed_count": null, "recalls": [], "note": "mcp.vin does not check this VIN with Ford or NHTSA, ..."}

Counts are null (unknown, never zero). A make with no listed page gets NHTSA only (maker: null). GET /api/vin/:vin/recall-status and MCP vin_recall_status stay and return this block. ?recall_wait and MCP recall_wait are ignored. The pending machinery for maker lookups is gone. The pending machinery for NHTSA complaints stays.

Changes

  • Deleted: lib/recall-status.mjs, lib/manufacturer-recalls.mjs, lib/more-manufacturer-recalls.mjs, lib/mopar-recalls.mjs and lib/manufacturer-description.mjs, with their callers, tests and fixtures. The decode checks lose the manufacturer-record tier.
  • New: lib/recall-links.mjs (the link table, which makes no requests). A VIN goes into the link only where the page was shown to take it: Ford (in_use), Tesla (page_code), and Honda, Acura, Subaru and Hyundai (browser_1118). The other makers get their plain page.
  • Website: the recall card, car sheet, comparison and print show the campaigns first, then "Check this VIN on X’s recall page" and "Check on NHTSA" (each opens in a new tab), with one sentence. On paper they read "Not checked by mcp.vin. Check at …". "Checking with …" is removed.
  • Credits: the Open Government Licence – Canada statement and licence link appear wherever Transport Canada dimensions show, and in the sources section. A "not affiliated" statement is in page footers, the sources section, the privacy page, the README and llms.txt.
  • Importers: they send an honest client name, mcp.vin-importer/1.0 (+https://mcp.vin), instead of a desktop Chrome user agent.
  • Docs, llms.txt and the MCP descriptions no longer claim a VIN's open or completed recall status.

Tests

  • tests/mock-upstream.mjs now fails closed. It refuses and logs any outbound request it does not answer, including node:https.
  • tests/no-maker-requests.test.mjs fails in these cases:
    • a maker hostname appears in server-side code anywhere other than the link table;
    • the link table could make a request;
    • any report path (REST, recall-status, compare, VIN page, MCP decode_vin and vin_recall_status) contacts a non-government host.
  • To check that test, I injected a Ford fetch on purpose. The test caught it.
  • flock /tmp/vin-mcp-test.lock npm test: 228 Node tests (227 pass, 1 skipped) and 10 Python suites OK.
  • Headless Chromium at 390 px with a Ford, a Toyota and a Volvo: no horizontal scroll, and the car sheet prints on one Letter page. The server reached only api.nhtsa.gov, vpic.nhtsa.dot.gov and fueleconomy.gov.

Merging onto main

main has #31–#34 beyond this stack's base. #34 changed lib/recall-status.mjs, which this branch deletes. A trial merge conflicts in lib/recall-status.mjs and three maker test files (modify/delete), and in public/app.js, public/car-sheet.js, public/index.html and server.mjs (content).

🤖 Generated with Claude Code

root and others added 8 commits November 18, 2026 18:35
Deletes every manufacturer VIN recall lookup (Ford, GM, Honda/Acura, Nissan, Mopar, Tesla, Subaru, VW, Audi,
Land Rover, Jaguar) and the manufacturer-description parser. recall_status keeps its key but now carries
links only (lib/recall-links.mjs): the maker's own recall page, VIN filled in only where shown, and NHTSA's
VIN recall page; open and completed counts stay null. Decode checks lose the manufacturer-record tier.
The pending/background machinery for maker lookups is gone; NHTSA complaints keep theirs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…on dimensions

Recall card, car sheet row, decode-checks sources line and the comparison table no longer show or wait for a
manufacturer status. They list NHTSA's model-year campaigns, then 'Check this VIN on <maker>'s recall page' and
'Check on NHTSA', with a copy-VIN button where the maker's page does not take the VIN from a link. Print says
'Not checked by mcp.vin' and where to check. Transport Canada dimensions carry the Open Government Licence –
Canada statement with a licence link (car sheet, research page, REST/MCP vehicle_dimensions).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…d OGL credit

README, data-sources, llms.txt/llms-full.txt, MCP tool directory, FAQ, examples, API guide, api.json and the
printable sheets no longer say mcp.vin reports a VIN's open or completed recalls; they describe the links.
Footers and the Data coverage and privacy pages say mcp.vin is independent and not affiliated with or endorsed
by NHTSA, EPA, DOE, Transport Canada, the Federal Reserve or any manufacturer, list the sources with their
official addresses, and carry the Open Government Licence – Canada statement for Transport Canada data. The
privacy page says VINs are no longer sent to manufacturers. Asset versions and tool directory regenerated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
import-aala, import-theft-rates, import-epa-test-cars, import-fueleconomy, build-nhtsa-photos and vpic-refresh
now send 'mcp.vin-importer/1.0 (+https://mcp.vin)'. One small request each on 2026-11-18: federalregister.gov,
epa.gov, fueleconomy.gov, nrd-static.nhtsa.dot.gov and vpic.nhtsa.dot.gov accept it; www.nhtsa.gov (AALA PDFs)
answers 403. Not worked around: import-aala stops with a clear message and reads files saved by hand.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tests/mock-upstream.mjs no longer falls through to the network: anything it does not answer is refused and logged
(MOCK_OUTBOUND_LOG). tests/no-maker-requests.test.mjs fails if a maker hostname appears in server-side code outside
the link table, if the link table could make a request, or if any report path (REST report, recall-status,
comparison, VIN page, MCP decode_vin and vin_recall_status) asks a non-government host; an injected Ford fetch was
caught. New tests for the link table and the web recall block; maker-status tests and fixtures (including real
maker reply shapes in decode-checks.test.mjs) removed. Rule fix rf-008's served reason drops the quote of
Volkswagen's VIN record (stored data unchanged); links render only for https URLs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… VIN button

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…/data-sources.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant