CarVector.io

carvector-mcp

Dê ao seu agente de IA dados reais de veículos. Um servidor MCP que permite ao Claude, Cursor, ChatGPT ou qualquer cliente compatível com MCP consultar a API do CarVector nativamente — especificações de veículos, imagens representativas, recalls federais, reclamações de proprietários, boletins de serviço, investigações de defeitos e códigos de diagnóstico OBD-II.

Modelos alucinam dados de carros. Eles inventam números de potência, perdem recalls arquivados na semana passada e adivinham o que um código de falha significa. carvector-mcp dá ao seu agente respostas estruturadas e com fonte que ele pode citar em vez de um palpite confiante.

npx -y carvector-mcp --key cv_your_key

· MIT · Nível gratuito, sem cartão → carvector.io

---

Início rápido

1. Obtenha uma chave de API gratuita em carvector.io — 500 requisições por mês, sem cartão de crédito.

2. Adicione ao seu cliente MCP. A maioria dos clientes usa um bloco mcpServers:

{
  "mcpServers": {
    "carvector": {
      "command": "npx",
      "args": ["-y", "carvector-mcp"],
      "env": { "CARVECTOR_API_KEY": "cv_your_key" }
    }
  }
}

Pronto. Reinicie o cliente e pergunte sobre um veículo.

Prefere um servidor remoto? Se o seu cliente suporta HTTP MCP, pule a instalação e aponte diretamente para o endpoint hospedado:

{ "mcpServers": { "carvector": {
    "url": "https://api.carvector.io/v1/mcp",
    "headers": { "Authorization": "Bearer cv_your_key" } } } }

---

Ferramentas

Ferramenta	O que retorna
search_vehicles	Veículos correspondentes por ano / marca / modelo, com ids + especificações
get_vehicle	Especificações completas de um veículo — motor, trem de força, carroceria, imagem, contagem de recalls
get_recalls	Campanhas de recall federal para um veículo — componente, resumo, consequência, reparo
get_complaints	Sinal de reclamações de proprietários para um veículo — agregado por componente + as reclamações mais recentes (plano Pro)
get_tsbs	Índice de boletins de serviço do fabricante para um veículo — o reparo que a concessionária já conhece (plano Business)
get_investigations	Investigações federais de defeitos para um veículo — um indicador antecedente de recalls (plano Business)
lookup_dtc	O título, a categoria, a gravidade e os sinalizadores de segurança/emissões de um código OBD-II

O agente os encadeia naturalmente: search_vehicles para resolver um id, depois get_vehicle, get_recalls, get_complaints, get_tsbs ou get_investigations.

---

Exemplo

Você: "O código P0300 é grave?"

→ carvector.lookup_dtc({ code: "P0300" })
{
  "code": "P0300",
  "title": "Random/Multiple Cylinder Misfire Detected",
  "category": "Powertrain",
  "severity": "High",
  "safety_risk": true,
  "emissions_related": true
}

Seu agente responde: "Sim — P0300 é um código de falha de ignição de alta gravidade relacionado à segurança. Não continue dirigindo com ele." Com fonte, não adivinhado.

---

Três coisas para construir com ele

• Um copiloto de assessor de serviço que puxa o acabamento exato do cliente, recalls abertos, o reparo documentado do fabricante (TSBs), o padrão de reclamações por trás de um sintoma e um código de check-engine decodificado — em uma única interação, sem alternar de aba.
• Um chatbot de carros para consumidores que responde "qual motor meu caminhão tem" e "está em recall?" com dados reais em vez de alucinação.
• Um agente de codificação/automotivo que precisa de conhecimento estruturado de veículos como ferramenta, não uma parede de texto raspado para processar.

---

Sobre os dados

carvector-mcp é um cliente fino e de código aberto. Ele não inclui nenhum dado — toda chamada é encaminhada para a API CarVector, autenticada com sua chave. O que você recebe:

• Veículos — um catálogo amplo (1925–2029), dividido por acabamento e variante de motor, com ilustrações representativas (não fotos).
• Recalls — campanhas de recall federal mapeadas por ano / marca / modelo.
• Reclamações — reclamações de proprietários agregadas por componente (com contagens de colisão / incêndio / ferimento) além dos registros mais recentes, mapeadas para um veículo. (Plano Pro.)
• Boletins de serviço (TSBs) — o índice de boletins de serviço técnico do fabricante — metadados, não os documentos. (Plano Business.)
• Investigações — investigações federais de defeitos, um indicador antecedente que frequentemente precede um recall. (Plano Business.)
• Referência de DTC — códigos OBD-II classificados por categoria, gravidade e sinalizadores de segurança/emissões. Apenas referência — a economia de custos de reparo está no roadmap, não nas respostas atuais.

As chamadas contam para o limite de taxa do seu plano e aparecem no seu painel, exatamente como uma requisição REST.

---

Código aberto e sua chave

Este cliente tem ~150 linhas de JavaScript legível — por favor, leia-as. Ele:

• fala com um único host — api.carvector.io (grep index.js, é a única URL),
• envia sua chave apenas como cabeçalho Bearer para esse host, para nenhum outro lugar,
• tem zero telemetria, analytics ou comunicação não solicitada, e não grava nada em disco,
• depende de exatamente um pacote: o oficial @modelcontextprotocol/sdk.

Sua chave permanece na sua máquina. Defina-a via variável de ambiente CARVECTOR_API_KEY (preferencial); --key também funciona, mas, como qualquer argumento de CLI, é visível nas listagens de processos.

Licença

MIT. O cliente é código aberto; os dados são fornecidos pela CarVector.