{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wyd9dkeptb8h","handle":"vin-decode-mcp","url":"https://wellknown.network/agents/vin-decode-mcp","links":{"self":"https://wellknown.network/agents/vin-decode-mcp/record.json","html":"https://wellknown.network/agents/vin-decode-mcp","markdown":"https://wellknown.network/agents/vin-decode-mcp/record.md","api":"https://wellknown.network/api/v1/agents/vin-decode-mcp","status":"https://wellknown.network/api/v1/agents/vin-decode-mcp/status","claim":"https://wellknown.network/agents/vin-decode-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/vin-decode-mcp/claim.json","badge":"https://wellknown.network/agents/vin-decode-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:vin-decode-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"vin-decode-mcp","summary":"MCP server for decoding VINs and querying vehicle data from a curated NHTSA vPIC SQLite database","description":"# vin-decode-mcp\n\n**Decode VINs and query vehicle data from a curated NHTSA vPIC database — powered by the Model Context Protocol.**\n\nA standalone, offline-capable MCP server for LLMs to decode Vehicle Identification Numbers (VINs) and look up makes, models, and vehicle specifications using data from [NHTSA's vPIC](https://vpic.nhtsa.dot.gov/).\n\n```\npip install vin-decode-mcp\nvin-decode-mcp  # Start the MCP server\n```\n\n## Why?\n\n- **Offline**: Works without internet access. The curated SQLite database (~4.5 MB) is self-contained.\n- **No rate limits**: Unlike calling the vPIC API directly, local queries are unlimited.\n- **Fast**: Pattern matching against the SQLite database takes microseconds.\n- **LLM-native**: Tools with rich docstrings, schema resources, and structured JSON output.\n- **Open data**: NHTSA vPIC is US government open data — free, no API key required.\n\n## Data Coverage\n\n- US-market vehicles, model year **1981 and forward**\n- **536 makes**, **9,284 models**, **88,267 VIN patterns** (2026-08 vintage)\n- Passenger Cars, Trucks, MPVs, Motorcycles, Off-Road Vehicles\n- Excludes: Buses, Trailers, Low-Speed Vehicles, Incomplete Vehicles\n\n> **Specifications only** — this database does not include title, accident, odometer,\n> or theft history (those require NMVTIS/commercial data sources).\n\n## Quick Start\n\n### Installation\n\n```bash\npip install vin-decode-mcp\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/<org>/vin-decode-mcp.git\ncd vin-decode-mcp\npip install -e .\n```\n\n### Running\n\n```bash\n# Default: stdio transport (for Claude Desktop, Cursor, etc.)\nvin-decode-mcp\n\n# HTTP transport\nvin-decode-mcp --transport http --port 8765\n```\n\n### Using with Claude Desktop\n\nCreate a dedicated venv so the binary lands where you can reference it:\n\n```bash\npython3 -m venv ~/.local/venvs/vin-decode\nsource ~/.local/venvs/vin-decode/bin/activate\npip install vin-decode-mcp\ndeactivate\n```\n\nAdd to `~/.config/claude-desktop/config.json` (or `~/Library/Application Support/cla…","publisher":{"name":"Justin Oakes","url":null},"homepage":"https://github.com/joakes90/vin-decode-mcp#readme","repository":"https://github.com/joakes90/vin-decode-mcp/issues","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["fastmcp","mcp","nhtsa","sqlite","vehicle","vin","vpic"],"pricing":null,"endpoints":[{"url":"pypi:vin-decode-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"vin-decode-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:13.028Z","publishedAt":"2026-08-30T03:08:14.051620Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"vin-decode-mcp","url":"https://pypi.org/project/vin-decode-mcp/","firstSeenAt":"2026-09-10T15:23:38.761Z","fetchedAt":"2026-09-10T15:23:38.761Z","normalizedAt":"2026-09-10T15:23:38.761Z"}]},"firstSeenAt":"2026-09-10T15:23:38.761Z","updatedAt":"2026-09-10T15:25:13.028Z"}