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

Servidor MCP de Clara Carros

Un servidor MCP que permite a los asistentes de IA trabajar con Clara Carros — coches usados e importados en Portugal. Busca en el stock en vivo, estima el impuesto de importación portugués (ISV), estima el valor de reventa de un coche y ponte en contacto.

Es un envoltorio ligero y de código abierto sobre la API pública claracars.pt — sin claves, sin configuración más allá de añadir el servidor.

Cline / instalación con un clic: consulta llms-install.md — la guía de configuración legible por máquina.

Herramientas

Herramienta	Qué hace
search_inventory	Busca en el stock actual por marca, modelo, combustible, precio, año
get_car	Detalles completos + especificaciones de un coche
calculate_isv	Estima el impuesto de importación de coches en Portugal (ISV)
calculate_iuc	Estima el impuesto anual de circulación en Portugal (IUC)
list_makes_models	Nombres canónicos de marca/modelo que esperan las otras herramientas
estimate_resale_value	Rango de valor de mercado para un coche en Portugal
list_services	Lo que ofrece Clara Carros
contact_me	Pide a una persona que se ponga en contacto (requiere el consentimiento + contacto del usuario)
request_import_quote	Pide a Clara Carros que busque y presupueste un coche para importar

Úsalo

Remoto (añade una URL)

https://claracars.pt/mcp

Añádelo en cualquier cliente que admita servidores MCP HTTP remotos/Streamable.

Local (stdio, mediante npx)

Configuración de Claude Desktop / Cline / Continue:

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

Ejemplos

• "Busca familiares diésel por menos de 20.000 € en el stock de Clara Carros."
• "¿Cuál es el ISV y el impuesto anual de circulación IUC de un diésel de 2016, 1950 cc, 130 g/km de CO₂?"
• "¿Cuánto vale mi VW Golf de 2018 con 100.000 km en Portugal?"
• "Pide a Clara Carros que busque un BMW 320d Touring 2021, mi nombre es … y teléfono …"

Configuración

Variable de entorno	Valor por defecto	Propósito
CLARACARS_API_BASE	https://claracars.pt/api/public	Base de la API pública
CLARACARS_LANG	en	Idioma de respuesta (pt/en/ru/ua)
PORT / MCP_PATH	8099 / /mcp	Servidor HTTP (modo remoto)

Desarrollo

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

Notas

• Estimaciones, no presupuestos. Las cifras de ISV y reventa son estimaciones; el ISV oficial lo evalúa la autoridad tributaria portuguesa.
• Privacidad. contact_me / request_import_quote envían los detalles que proporciona el usuario a Clara Carros (política de privacidad); tienen límite de frecuencia y requieren intención explícita del usuario.
• No hay lógica de negocio ni datos en este repositorio — solo llama a la API pública.

Relacionados

• Calculadoras: la lógica de impuestos ISV/IUC que llama este servidor es de código abierto en claracarspt/calcs — una biblioteca Python sin dependencias + API sin claves.

MIT © Clara Carros