Vincario Vehicle Data

Vincario MCP Server

Um servidor MCP (Model Context Protocol) que expõe a API Vincario para agentes de IA e clientes LLM. Permite que assistentes de IA decodifiquem VINs, consultem bancos de dados de veículos roubados e obtenham avaliações de mercado por meio de linguagem natural.

Ferramentas

Ferramenta	Descrição
vin_decode	Decodificar um VIN e retornar informações detalhadas do veículo
vin_decode_info	Listar campos disponíveis para um VIN específico (endpoint gratuito)
stolen_check	Verificar se um VIN aparece em bancos de dados de veículos roubados
vehicle_market_value	Obter avaliação de mercado para um veículo (suporta entrada de odômetro)

Requisitos

• Chave da API Vincario — enviada via cabeçalho HTTP X-API-Key
• Docker (recomendado) ou Python 3.11+ com uv

Executando com Docker

docker build -t vincario-mcp .
docker run -p 8080:8080 vincario-mcp

O servidor inicia em http://localhost:8080.

Executando localmente

pip install uv
uv sync
uv run main.py

Conectando a um cliente MCP

Envie sua chave da API Vincario como cabeçalho HTTP em cada requisição:

X-API-Key: your_api_key_here

Claude Code

Adicione à sua configuração MCP (.mcp.json ou claude_desktop_config.json):

{
  "mcpServers": {
    "vincario": {
      "type": "http",
      "url": "http://localhost:8080",
      "headers": {
        "X-API-Key": "your_api_key_here"
      }
    }
  }
}

Endpoint hospedado

Se estiver conectando ao servidor hospedado em https://mcp.vincario.com/mcp, substitua a URL de acordo.

Exemplo de uso

Depois de conectado, você pode perguntar ao seu assistente de IA:

• "Decodifique o VIN WBAFR9C54BC780006"
• "Este veículo foi roubado? VIN: WBAFR9C54BC780006"
• "Qual é o valor de mercado do VIN WBAFR9C54BC780006 com 85000 km?"

Transporte

O servidor usa transporte streamable HTTP (stateless_http=True), o que significa que nenhuma sessão persistente é necessária. Cada requisição é independente, tornando simples a implantação atrás de um proxy reverso ou balanceador de carga.

Para implantação com HTTPS, coloque um proxy reverso (nginx, Caddy, Cloudflare) na frente do servidor — a aplicação em si roda na porta HTTP 8080.

Licença

Consulte os Termos de Serviço da API Vincario para os termos de uso.