CarVector.io
Vehicle specs, federal recall campaigns, and OBD-II DTC lookup via a single MCP server. Covers 12,000+ vehicles (1925–2029). Free tier, no API key required. Install with `npx -y carvector-mcp`.
Documentación
carvector-mcp
Dale a tu agente de IA datos reales de vehículos. Un servidor MCP que permite a Claude, Cursor, ChatGPT o cualquier cliente compatible con MCP consultar la API de CarVector de forma nativa: especificaciones de vehículos, imágenes representativas, retiros federales, quejas de propietarios, boletines de servicio, investigaciones de defectos y códigos de diagnóstico OBD-II.
Los modelos alucinan datos de automóviles. Inventan cifras de caballos de fuerza, omiten retiros presentados la semana pasada y adivinan qué significa un código de falla. carvector-mcp le da a tu agente respuestas estructuradas y con fuente que puede citar en lugar de una suposición confiada.
npx -y carvector-mcp --key cv_your_key
· MIT · Nivel gratuito, sin tarjeta → carvector.io
Inicio rápido
1. Obtén una clave API gratuita en carvector.io: 500 solicitudes al mes, sin tarjeta de crédito.
2. Agrégala a tu cliente MCP. La mayoría de los clientes usan un bloque mcpServers:
{
"mcpServers": {
"carvector": {
"command": "npx",
"args": ["-y", "carvector-mcp"],
"env": { "CARVECTOR_API_KEY": "cv_your_key" }
}
}
}
Eso es todo. Reinicia tu cliente y pregúntale sobre un vehículo.
¿Prefieres un servidor remoto? Si tu cliente admite MCP por HTTP, omite la instalación y apunta directamente al endpoint alojado:
{ "mcpServers": { "carvector": { "url": "https://api.carvector.io/v1/mcp", "headers": { "Authorization": "Bearer cv_your_key" } } } }
Herramientas
| Herramienta | Qué devuelve |
|---|---|
search_vehicles | Vehículos coincidentes por año / marca / modelo, con ids y especificaciones |
get_vehicle | Especificaciones completas de un vehículo: motor, tren motriz, carrocería, imagen, cantidad de retiros |
get_recalls | Campañas de retiro federal para un vehículo: componente, resumen, consecuencia, remedio |
get_complaints | Señal de quejas de propietarios para un vehículo: agregado por componente + las quejas más recientes (plan Pro) |
get_tsbs | Índice de boletines de servicio del fabricante para un vehículo: la solución que el concesionario ya conoce (plan Business) |
get_investigations | Investigaciones federales de defectos para un vehículo: un indicador adelantado de retiros (plan Business) |
lookup_dtc | Título, categoría, gravedad y banderas de seguridad/emisiones de un código OBD-II |
El agente las encadena de forma natural: search_vehicles para resolver un id, luego get_vehicle, get_recalls, get_complaints, get_tsbs o get_investigations.
Ejemplo
Tú: "¿Es grave un código P0300?"
→ carvector.lookup_dtc({ code: "P0300" })
{
"code": "P0300",
"title": "Random/Multiple Cylinder Misfire Detected",
"category": "Powertrain",
"severity": "High",
"safety_risk": true,
"emissions_related": true
}
Tu agente responde: "Sí: P0300 es un código de falla de encendido de alta gravedad relacionado con la seguridad. No sigas conduciendo con él." Con fuente, no adivinado.
Tres cosas para construir con esto
- Un copiloto de asesor de servicio que obtiene el acabado exacto del cliente, retiros abiertos, la solución documentada del fabricante (TSB), el patrón de quejas detrás de un síntoma y un código de motor decodificado, en un solo turno, sin cambiar de pestaña.
- Un chatbot de autos para consumidores que responde "¿qué motor tiene mi camioneta?" y "¿está bajo retiro?" con datos reales en lugar de una alucinación.
- Un agente de programación/automotriz que necesita conocimiento estructurado de vehículos como herramienta, no un muro de texto extraído para analizar.
Pago por llamada en lugar de usar una clave (x402)
La API HTTP de CarVector también acepta pagos x402, por lo que un agente con una billetera puede llamarla sin cuenta, sin registro y sin clave API: paga por solicitud y recibe los datos.
- $0.01 USDC por llamada, en la red principal de Base
(USDC
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) - Solicita un endpoint de pago sin pagar y recibes un 402 HTTP con todo lo necesario para pagar y reintentar:
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", ... } ] }
Endpoints pagables: /v1/vehicles, /v1/vehicles/:id, /v1/vehicles/:id/recalls,
/v1/vehicles/:id/complaints, /v1/vehicles/:id/tsbs,
/v1/vehicles/:id/investigations, /v1/dtc/:code.
Este cliente MCP no paga: usa una clave API.
carvector-mcprequiereCARVECTOR_API_KEYy sale sin una. x402 es para llamar a la API HTTP directamente. Si quieres acceso sin clave desde un agente, llama a los endpoints anteriores en lugar de pasar por este paquete.
Acerca de los datos
carvector-mcp es un cliente delgado y de código abierto. No incluye datos: cada llamada se reenvía a la API de CarVector, autenticada con tu clave. Lo que recibes:
- Vehículos: un catálogo amplio (1925–2029), desglosado por acabado y variante de motor, con ilustraciones representativas (no fotos).
- Retiros: campañas de retiro federal mapeadas por año / marca / modelo.
- Quejas: quejas de propietarios agregadas por componente (con conteos de choques / incendios / lesiones) más las presentaciones más recientes, mapeadas a un vehículo. (plan Pro.)
- Boletines de servicio (TSB): el índice de boletines de servicio técnico del fabricante: metadatos, no los documentos. (plan Business.)
- Investigaciones: investigaciones federales de defectos, un indicador adelantado que a menudo precede a un retiro. (plan Business.)
- Referencia de DTC: códigos OBD-II clasificados por categoría, gravedad y banderas de seguridad/emisiones. Solo referencia: la economía de costos de reparación está en la hoja de ruta, no en las respuestas actuales.
Las llamadas cuentan contra el límite de tu plan y aparecen en tu panel, exactamente como una solicitud REST.
Código abierto y tu clave
Este cliente tiene ~150 líneas de JavaScript legible: por favor, léelas. Este:
- habla con un solo host:
api.carvector.io(buscaindex.js, es la única URL), - envía tu clave solo como encabezado
Bearera ese host, a ningún otro lugar, - tiene cero telemetría, análisis o llamadas a casa, y no escribe nada en disco,
- depende de exactamente un paquete: el oficial
@modelcontextprotocol/sdk.
Tu clave permanece en tu máquina. Configúrala mediante la variable de entorno CARVECTOR_API_KEY (preferida); --key también funciona, pero, como cualquier argumento de CLI, es visible en los listados de procesos.
Licencia
MIT. El cliente es de código abierto; los datos son servidos por CarVector.