Provides AI agents with structured vehicle specifications, federal recalls, owner complaints, service bulletins, and OBD-II diagnostic data.
Also known as carvectorio/carvector-mcp
- Stars
- 1
- Tools
- 7
- Downloads, 30 days
- —
- Latest version
- 1.1.1
- Last commit
- Sep 19, 2026
- License
- MIT
What is CarVector MCP?
CarVector provides AI agents with structured vehicle specifications, federal recalls, owner complaints, service bulletins, and OBD-II diagnostic data. It exposes 7 tools, such as search_vehicles, get_vehicle, get_recalls.
Summary generated from the project's README
About CarVector MCP server
Providing AI agents with verified automotive data is the primary function of carvector-mcp. It allows developers to connect models like Claude, Cursor, or ChatGPT to the CarVector API to prevent hallucinations regarding vehicle specifications, recalls, and diagnostic codes. Users can set this up locally using npx with a CARVECTOR_API_KEY environment variable or connect via a remote HTTP MCP endpoint.
The server provides a suite of specialized tools including search_vehicles for finding specific models, get_recalls for federal safety campaigns, and lookup_dtc for interpreting OBD-II trouble codes. Advanced features like get_complaints, get_tsbs, and get_investigations are available through Pro and Business plans to provide deeper insights into owner feedback and manufacturer service bulletins. This ensures that an agent can provide sourced, structured answers about engine types, drivetrain details, and safety risks instead of guessing.
What you can do with it
- 1Diagnosing check engine lightsAsk an AI to explain the severity and safety implications of a specific OBD-II diagnostic trouble code.
- 2Building automotive service assistantsCreate a tool that retrieves a vehicle's exact trim, open recalls, and manufacturer service bulletins in a single interaction.
- 3Verifying technical vehicle specificationsQuery an agent to find accurate engine and drivetrain details for a specific vehicle model to avoid incorrect information.
Written from the project's README. Every use case is checked against a quote from it.
How to install CarVector MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall CarVector MCP in Claude Code
$ claude mcp add --env 'CARVECTOR_API_KEY=<YOUR_CARVECTOR_API_KEY>' carvector-mcp -- npx -y carvector-mcpInstall CarVector MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"carvector-mcp": {
"command": "npx",
"args": [
"-y",
"carvector-mcp"
],
"env": {
"CARVECTOR_API_KEY": "<YOUR_CARVECTOR_API_KEY>"
}
}
}
}Install CarVector MCP in VS Code
.vscode/mcp.json
{
"servers": {
"carvector-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"carvector-mcp"
],
"env": {
"CARVECTOR_API_KEY": "<YOUR_CARVECTOR_API_KEY>"
}
}
}
}Install CarVector MCP in VS Code CLI
$ code --add-mcp '{"name":"carvector-mcp","type":"stdio","command":"npx","args":["-y","carvector-mcp"],"env":{"CARVECTOR_API_KEY":"<YOUR_CARVECTOR_API_KEY>"}}'Install CarVector MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"carvector-mcp": {
"command": "npx",
"args": [
"-y",
"carvector-mcp"
],
"env": {
"CARVECTOR_API_KEY": "<YOUR_CARVECTOR_API_KEY>"
}
}
}
}Install CarVector MCP in Codex
$ codex mcp add carvector-mcp --env 'CARVECTOR_API_KEY=<YOUR_CARVECTOR_API_KEY>' -- npx -y carvector-mcpInstall CarVector MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.carvector-mcp] command = "npx" args = ["-y", "carvector-mcp"] [mcp_servers.carvector-mcp.env] CARVECTOR_API_KEY = "<YOUR_CARVECTOR_API_KEY>"
Install CarVector MCP in Gemini CLI
$ gemini mcp add -s user -e 'CARVECTOR_API_KEY=<YOUR_CARVECTOR_API_KEY>' carvector-mcp npx -- -y carvector-mcpInstall CarVector MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"carvector-mcp": {
"command": "npx",
"args": [
"-y",
"carvector-mcp"
],
"env": {
"CARVECTOR_API_KEY": "<YOUR_CARVECTOR_API_KEY>"
}
}
}
}CarVector MCP tools 7
Detected from the READMEsearch_vehiclesget_vehicleget_recallsget_complaintsget_tsbsget_investigationslookup_dtc
| search_vehicles | — | |
| get_vehicle | — | |
| get_recalls | — | |
| get_complaints | — | |
| get_tsbs | — | |
| get_investigations | — | |
| lookup_dtc | — |
Configuration
CARVECTOR_API_KEYRequiredSecretYour CarVector API key (free at carvector.io)
| Name | Description | |
|---|---|---|
| CARVECTOR_API_KEY | Your CarVector API key (free at carvector.io) | RequiredSecret |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablecarvectorio/carvector-mcp is public and reachablegithub.com/carvectorio/carvector-mcp ↗Pass
- Package names this repository as its sourcecarvector-mcp names carvectorio/carvector-mcp as sourcenpmjs.com/package/carvector-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for carvector-mcpnpmjs.com/package/carvector-mcp/v/1.1.1#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-19github.com/carvectorio/carvector-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from carvector-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubcarvector-mcp
Give your AI agent real vehicle data. An MCP server that lets Claude, Cursor, ChatGPT, or any MCP-capable client query the CarVector API natively — vehicle specs, representative images, federal recalls, owner complaints, service bulletins, defect investigations, and OBD-II diagnostic trouble codes.
Models hallucinate car data. They invent horsepower numbers, miss recalls filed last week, and guess at what a trouble code means. carvector-mcp gives your agent structured, sourced answers it can cite instead of a confident guess.
npx -y carvector-mcp --key cv_your_key
· MIT · Free tier, no card → carvector.io
Quickstart
1. Get a free API key at carvector.io — 500 requests a month, no credit card.
2. Add it to your MCP client. Most clients use an mcpServers block:
{
"mcpServers": {
"carvector": {
"command": "npx",
"args": ["-y", "carvector-mcp"],
"env": { "CARVECTOR_API_KEY": "cv_your_key" }
}
}
}
That's it. Restart your client and ask it about a vehicle.
Prefer a remote server? If your client supports HTTP MCP, skip the install and point it straight at the hosted endpoint:
{ "mcpServers": { "carvector": { "url": "https://api.carvector.io/v1/mcp", "headers": { "Authorization": "Bearer cv_your_key" } } } }
Tools
| Tool | What it returns |
|---|---|
search_vehicles |
Matching vehicles by year / make / model, with ids + specs |
get_vehicle |
Full specs for one vehicle — engine, drivetrain, body, image, recall count |
get_recalls |
Federal recall campaigns for a vehicle — component, summary, consequence, remedy |
get_complaints |
Owner-complaint signal for a vehicle — aggregate by component + the most recent complaints (Pro plan) |
get_tsbs |
Manufacturer service-bulletin index for a vehicle — the fix the dealer already knows about (Business plan) |
get_investigations |
Federal defect investigations for a vehicle — a leading indicator of recalls (Business plan) |
lookup_dtc |
An OBD-II code's title, category, severity, and safety/emissions flags |
The agent chains them naturally: search_vehicles to resolve an id, then get_vehicle, get_recalls, get_complaints, get_tsbs, or get_investigations.
Example
You: "Is a P0300 code serious?"
→ carvector.lookup_dtc({ code: "P0300" })
{
"code": "P0300",
"title": "Random/Multiple Cylinder Misfire Detected",
"category": "Powertrain",
"severity": "High",
"safety_risk": true,
"emissions_related": true
}
Your agent answers: "Yes — P0300 is a high-severity, safety-related misfire code. Don't keep driving on it." Sourced, not guessed.
Three things to build with it
- A service-advisor copilot that pulls a customer's exact trim, open recalls, the manufacturer's documented fix (TSBs), the complaint pattern behind a symptom, and a decoded check-engine code — in one turn, no tab-switching.
- A consumer car chatbot that answers "what engine does my truck have" and "is it under recall" with real data instead of a hallucination.
- A coding/automotive agent that needs structured vehicle knowledge as a tool, not a wall of scraped text to parse.
Paying per call instead of using a key (x402)
The CarVector HTTP API also accepts x402 payments, so an agent with a wallet can call it with no account, no signup and no API key — it pays per request and gets the data back.
- $0.01 USDC per call, on Base mainnet
(USDC
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) - Request a paid endpoint without payment and you get an HTTP 402 with everything needed to pay and retry:
curl -i "https://carvector.io/v1/vehicles?year=2020&make=Ford&model=F-150"
# HTTP/1.1 402 Payment Required
# { "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "base", ... } ] }
Payable endpoints: /v1/vehicles, /v1/vehicles/:id, /v1/vehicles/:id/recalls,
/v1/vehicles/:id/complaints, /v1/vehicles/:id/tsbs,
/v1/vehicles/:id/investigations, /v1/dtc/:code.
This MCP client does not pay — it uses an API key.
carvector-mcprequiresCARVECTOR_API_KEYand exits without one. x402 is for calling the HTTP API directly. If you want keyless access from an agent, call the endpoints above rather than going through this package.
About the data
carvector-mcp is an open-source, thin client. It bundles no data — every call forwards to the CarVector API, authenticated with your key. What you get back:
- Vehicles — a broad catalog (1925–2029), broken out by trim and engine variant, with representative illustrations (not photos).
- Recalls — federal recall campaigns mapped to year / make / model.
- Complaints — owner-filed complaints aggregated by component (with crash / fire / injury counts) plus the most recent filings, mapped to a vehicle. (Pro plan.)
- Service bulletins (TSBs) — the manufacturer's technical service-bulletin index — metadata, not the documents. (Business plan.)
- Investigations — federal defect investigations, a leading indicator that often precedes a recall. (Business plan.)
- DTC reference — OBD-II codes classified by category, severity, and safety/emissions flags. Reference only — repair-cost economics is on the roadmap, not in responses today.
Calls count against your plan's rate limit and show up in your dashboard, exactly like a REST request.
Open source & your key
This client is ~150 lines of readable JavaScript — please read them. It:
- talks to one host only —
api.carvector.io(grepindex.js, it's the only URL), - sends your key only as a
Bearerheader to that host, nowhere else, - has zero telemetry, analytics, or phone-home, and writes nothing to disk,
- depends on exactly one package: the official
@modelcontextprotocol/sdk.
Your key stays on your machine. Set it via the CARVECTOR_API_KEY env var (preferred); --key works too but, like any CLI argument, is visible in process listings.
License
MIT. The client is open source; the data is served by CarVector.
CarVector MCP questions
How do I add CarVector MCP to Claude Code?
Run claude mcp add --env 'CARVECTOR_API_KEY=<YOUR_CARVECTOR_API_KEY>' carvector-mcp -- npx -y carvector-mcp in your terminal. Add --scope user to make it available in every project.
How do I add CarVector MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does CarVector MCP provide?
It exposes 7 tools, including search_vehicles, get_vehicle, get_recalls, get_complaints, get_tsbs.
What kind of vehicle data can I access?
You can access vehicle specs, representative images, federal recalls, owner complaints, service bulletins, defect investigations, and OBD-II diagnostic trouble codes.
Does the MCP server handle payments?
No, the MCP client requires an API key and does not support x402 payments; those are for the direct HTTP API.