CarVector.io

carvector-mcp

Dê ao seu agente de IA dados reais de veículos. Um servidor MCP que permite que Claude, Cursor, ChatGPT ou qualquer cliente compatível com MCP consulte a API 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 registrados 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 · Plano 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-a 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" }
    }
  }
}

É isso. Reinicie o cliente e pergunte sobre um veículo.

Prefere um servidor remoto? Se o seu cliente suporta MCP HTTP, 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 federais 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 — a correção 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	Título, categoria, gravidade e flags 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 consultor de serviço que puxa o acabamento exato do cliente, recalls abertos, a correção documentada 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 de uma parede de texto raspado para analisar.

---

Pagando por chamada em vez de usar uma chave (x402)

A API HTTP do CarVector também aceita pagamentos x402, então um agente com carteira pode chamá-la sem conta, sem cadastro e sem chave de API — ele paga por requisição e recebe os dados de volta.

• US$ 0,01 USDC por chamada, na mainnet Base (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
• Solicite um endpoint pago sem pagamento e você recebe um HTTP 402 com tudo o que é necessário para pagar e tentar novamente:

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 pagáveis: /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 não paga — ele usa uma chave de API. carvector-mcp exige CARVECTOR_API_KEY e sai sem ela. x402 é para chamar a API HTTP diretamente. Se você quiser acesso sem chave a partir de um agente, chame os endpoints acima em vez de passar por este pacote.

Sobre os dados

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

• 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 federais mapeadas por ano / marca / modelo.
• Reclamações — reclamações de proprietários agregadas por componente (com contagens de acidentes / incêndios / ferimentos) 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 flags de segurança/emissões. Apenas referência — a economia de custos de reparo está no roadmap, não nas respostas hoje.

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 apenas um host — api.carvector.io (grep index.js, é a única URL),
• envia sua chave apenas como um cabeçalho Bearer para esse host, em nenhum outro lugar,
• tem zero telemetria, análise ou phone-home, 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 (preferido); --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.