Precios de autos desde tu asistente de IA

ArgAutos tiene un servidor MCP (Model Context Protocol) de solo lectura para Claude y otros asistentes compatibles. El asistente busca versiones y consulta o compara precios de CCA, ACARA y ArgAutos, siempre con la fuente y la fecha de cada dato. Está incluido en los planes Starter y Pro y usa la misma cuota de tu API key.

1. Antes de empezar

Una API key Starter o Pro activa. No hace falta habilitar nada: la misma key que usás con la API REST ya incluye el MCP.
Un asistente compatible con MCP por HTTP y OAuth, como Claude Code, Claude (web y escritorio) o Cursor. El asistente se registra solo al conectar.

Tu API key se escribe solamente en la página de autorización de argautos.com. Nunca la pegues en un chat ni en la configuración del asistente: el MCP no la acepta como credencial.

2. Conectar Claude Code

Agregá el servidor:
```
claude mcp add --transport http argautos https://argautos.com/mcp
```
En Claude web o escritorio, agregalo como conector personalizado con la misma URL.
Abrí Claude Code, entrá a /mcp, elegí argautos y tocá Authenticate.
Se abre argautos.com en el navegador. Ingresá tu API key y revisá los permisos, las fuentes y la cuota que vas a compartir.
Tocá Autorizar. El asistente queda conectado y ya podés preguntarle, por ejemplo: «¿Cuánto vale una Hilux SRX 4x4 2024 según CCA y según ACARA?».

3. Herramientas

Todas son de solo lectura. El asistente elige cuál usar según lo que le preguntes.

Herramienta	Qué hace	Permiso	Cuota
buscar_vehiculo	Busca versiones por marca, modelo o versión y devuelve candidatos separados por fuente, cada uno con su identificador.	catalogo:leer	1
consultar_precios	Precios por año-modelo de un vehículo en su fuente, con fecha, vigencia y conversión.	precios:leer	1
comparar_vehiculos	Diferencia de precio entre dos vehículos del mismo tipo: de la misma fuente, o CCA contra ACARA.	precios:leer	1
consultar_cuota	Plan, límites, consumo del día y la autorización con la que consultás.	cuota:leer	0

buscar_vehiculo

texto (obligatorio): marca, modelo y/o versión, hasta 8 palabras. Ej.: toyota hilux srx.
fuente: cca, acara o argautos. Si se omite, busca en todas y separa los resultados por fuente.
tipo_vehiculo: auto o moto (las motos están en la fuente ArgAutos).
orden, marca (solo motos), pagina (hasta 20) y por_pagina (hasta 25).

consultar_precios

id_vehiculo (obligatorio): el identificador que devolvió buscar_vehiculo.
moneda (obligatorio): USD o ARS.
anio: año-modelo, 0 para 0 km. Si se omite, devuelve todos los años con precio.

comparar_vehiculos

id_vehiculo_a, anio_a, id_vehiculo_b, anio_b y moneda, todos obligatorios.
La diferencia es B − A y el porcentaje se calcula sobre A. Al comparar CCA con ACARA, la respuesta avisa que son guías distintas, con su propia metodología y fecha.

4. Identificadores y precios

Cada vehículo tiene un identificador {fuente}:{tipo}:{referencia}, por ejemplo cca:auto:4910. Pertenece a una sola fuente: el mismo número en otra fuente es otro vehículo.
Los importes llegan como texto decimal ("28521.37"). null significa que no hay precio, nunca cero.
Cada precio informa su fecha, si está vigente y, cuando se convierte de moneda, el tipo de cambio aplicado. Los precios históricos se convierten con el tipo de cambio vigente y la respuesta lo avisa.
El campo limitaciones explica lo que el asistente tiene que tener en cuenta al responder, como precios estimados, ausentes o de fechas distintas.

5. Cuota y límites

El MCP usa la cuota diaria y el límite por minuto de tu API key: los comparten la API REST y todos los asistentes que conectes. Conectar más asistentes no aumenta la cuota.

Plan	Por minuto	Por día
Starter	15	1.000
Pro	40	5.000

Además, cada key admite hasta 4 consultas simultáneas y 30 pedidos por minuto de descubrimiento (listar herramientas, iniciar la sesión), que no consumen cuota. La cuota diaria se reinicia a medianoche, hora de Buenos Aires.

6. Errores

Los errores traen un codigo estable. Los más comunes:

Código	Qué pasó
no_autenticado	Falta el acceso o se revocó. Volvé a autorizar desde el asistente.
permiso_insuficiente	La autorización no incluye el permiso que pide esa herramienta.
cuota_diaria_agotada	Se usó toda la cuota del día. Se reinicia a medianoche.
limite_por_minuto	Se superó el límite por minuto. Reintentá después de los segundos indicados.
demasiadas_solicitudes_simultaneas	Hay 4 consultas en curso con la misma key.
vehiculo_no_encontrado	El identificador no existe en esa fuente.
comparacion_entre_fuentes_no_soportada	Entre fuentes distintas solo se compara CCA contra ACARA. Consultá cada precio por separado.
tipos_de_vehiculo_distintos	Solo se comparan autos con autos o motos con motos.
combinacion_no_soportada	Un filtro no está disponible para esa fuente o tipo de vehículo.
argumentos_invalidos	Falta un argumento o tiene un valor fuera de rango.

Si una consulta falla por un error del servicio, la unidad de cuota se devuelve.

7. Permisos y revocación

Permisos de solo lectura: catalogo:leer, precios:leer y cuota:leer. El asistente no puede modificar datos ni administrar claves.
El acceso del asistente dura 15 minutos y se renueva solo. Si no lo usás durante 30 días, o si lo retirás, hay que volver a autorizar.
En argautos.com/mcp/conexiones ves qué asistentes tienen acceso y podés retirar cualquiera.
Si la API key se revoca o vence, el acceso de todos sus asistentes se corta en la consulta siguiente.

8. Clientes propios

Si integrás el MCP en tu propio cliente, el servidor usa transporte Streamable HTTP en POST https://argautos.com/mcp y OAuth 2.1 con Authorization Code y PKCE (S256). Los metadatos están publicados en:

https://argautos.com/.well-known/oauth-protected-resource/mcp
https://argautos.com/.well-known/oauth-authorization-server

Registrá tu cliente en el registration_endpoint que publican los metadatos (registro dinámico, RFC 7591): sólo clientes públicos con PKCE, con URLs de retorno https o http en loopback. Pedí el parámetro resource con la URL del MCP.