Clara Carros — used & imported cars in Portugal (ISV/IUC, live stock, resale)

Servidor MCP Clara Carros

Um servidor MCP que permite que assistentes de IA trabalhem com Clara Carros — carros usados e importados em Portugal. Pesquise o estoque ao vivo, estime o imposto de importação português (ISV), estime o valor de revenda de um carro e entre em contato.

É um wrapper fino e de código aberto sobre a API pública claracars.pt — sem chaves, sem configuração além de adicionar o servidor.

Cline / instalação em um clique: veja llms-install.md — o guia de configuração legível por máquina.

Ferramentas

Ferramenta	O que faz
search_inventory	Pesquisar o estoque atual por marca, modelo, combustível, preço, ano
get_car	Detalhes completos + especificações de um carro
calculate_isv	Estimar o imposto de importação de carros português (ISV)
calculate_iuc	Estimar o imposto anual de circulação português (IUC)
list_makes_models	Nomes canônicos de marcas/modelos que as outras ferramentas esperam
estimate_resale_value	Faixa de valor de mercado para um carro em Portugal
list_services	O que a Clara Carros oferece
contact_me	Pedir que um humano entre em contato (requer consentimento + contato do usuário)
request_import_quote	Pedir à Clara Carros para localizar e cotar um carro para importação

Como usar

Remoto (adicione uma URL)

https://claracars.pt/mcp

Adicione em qualquer cliente que suporte servidores MCP remotos/Streamable HTTP.

Local (stdio, via npx)

Configuração do Claude Desktop / Cline / Continue:

{
  "mcpServers": {
    "claracars": {
      "command": "npx",
      "args": ["-y", "claracars-mcp"]
    }
  }
}

Exemplos

• "Encontre peruas a diesel abaixo de €20.000 no estoque da Clara Carros."
• "Qual é o ISV e o imposto anual IUC de um diesel 2016, 1950 cc, 130 g/km de CO₂?"
• "Quanto vale meu VW Golf 2018, 100.000 km, em Portugal?"
• "Peça à Clara Carros para localizar um BMW 320d Touring 2021, meu nome é … e telefone …"

Configuração

Variável de ambiente	Padrão	Finalidade
CLARACARS_API_BASE	https://claracars.pt/api/public	Base da API pública
CLARACARS_LANG	en	Idioma da resposta (pt/en/ru/ua)
PORT / MCP_PATH	8099 / /mcp	Servidor HTTP (modo remoto)

Desenvolvimento

npm install
npm run build
node dist/index.js        # stdio
npm run start:http        # remote HTTP on :8099/mcp

Notas

• Estimativas, não cotações. Os valores de ISV e revenda são estimativas; o ISV oficial é avaliado pela autoridade tributária portuguesa.
• Privacidade. contact_me / request_import_quote enviam os detalhes fornecidos pelo usuário à Clara Carros (política de privacidade); eles têm limite de taxa e exigem intenção explícita do usuário.
• Nenhuma lógica de negócio ou dados reside neste repositório — ele apenas chama a API pública.

Relacionados

• Calculadoras: a lógica de impostos ISV/IUC que este servidor chama é de código aberto em claracarspt/calcs — uma biblioteca Python sem dependências + API sem chaves.

MIT © Clara Carros