Para el equipo de Tratto y el banco

Tratto Conecta

La puerta para que un agente o un sistema use Tratto: el inventario, la cuota con tasas ilustrativas, la consola del banco y las fuentes de atrás, con las mismas reglas que la app. Cada quien entra con su identidad y ve solo lo que su acceso permite. Esta versión es de solo lectura.

Direcciones

MCP, para agentes
https://conecta.tratto.com.co/mcp
API REST, para sistemas
https://conecta.tratto.com.co/api/v1
Descripción OpenAPI
https://conecta.tratto.com.co/api/v1/openapi.json
Credencial
Authorization: Bearer … con un token de OAuth (entras con tu celular y un código por WhatsApp) o una llave de servicio tc_live_….

Cómo se conecta cada plataforma

PlataformaCómo
claude.ai y CoworkConfiguración › Conectores › agregar un conector personalizado con https://conecta.tratto.com.co/mcp. Al conectarlo, entras con tu celular y apruebas el permiso.
Claude Codeclaude mcp add --transport http tratto https://conecta.tratto.com.co/mcp
Agentes de Pine (Tracy, ARIA)En Pine › Agentes IA › servidores MCP: la dirección del MCP con una llave de servicio en Authorization.
Agentes del bancoLa dirección del MCP desde su plataforma, con OAuth o con una llave del banco.
Marketplaces y sistemasLa API REST con su llave: GET https://conecta.tratto.com.co/api/v1/buscar_carros?frase=…

Herramientas

Las mismas en el MCP y en la API. Cada una dice qué devuelve y de dónde sale; lo simulado lo dice en su respuesta.

Catálogo

Buscar carros, ver su ficha, simular la cuota con tasas ilustrativas y comparar el precio con el mercado. Lo usan: Equipo, Banco, Agentes de Pine, Marketplaces.

  • Buscar carrosbuscar_carros

    Busca en el inventario real de Tratto (Pine) con una frase como la diría una persona («SUV familiar hasta 80 millones») o con filtros. Devuelve hasta 12 carros por página con precio, ciudad, enlace a la ficha, el precio frente al mercado (referencia estimada) y la cuota mensual con tasas ILUSTRATIVAS (30 % de inicial, 60 meses). La cuota no es una oferta de crédito: el crédito lo decide el banco.

  • Ficha de un carroficha_carro

    La ficha completa de un carro publicado en Tratto: datos técnicos, fotos, lo que se verificó (con su evidencia o «sin dato»), el precio frente al mercado (referencia estimada) y la cuota con tasas ILUSTRATIVAS. Si el carro ya no está publicado, lo dice.

  • Simular la cuotasimular_cuota

    La cuota mensual estimada de un carro con las tasas ILUSTRATIVAS de Sufi: precio, cuota inicial (en % del precio) y plazo. No es una oferta de crédito ni una aprobación: el crédito lo estudia y lo decide el banco. Úsala para hacer cuentas con la persona.

  • Precio frente al mercadoprecio_frente_al_mercado

    Dice si el precio de un carro está por debajo, en o por encima del mercado, con el rango estimado (referencia ±7 %). Es una referencia ESTIMADA, no un avalúo. Si no hay referencia para ese carro, lo dice.

Operación

Ver los números de la consola, el pipeline, las conversaciones y el inventario del negocio. Lo usan: Equipo, Banco.

  • Indicadores de la consolaindicadores_consola

    Los cinco números del negocio de Tratto con el banco para un periodo (interesados, citas, solicitudes de crédito, ventas y monto que piden financiar), cada uno con su definición y el periodo anterior para comparar; además el embudo (en personas) y la serie por día. Datos reales de Pine. Las solicitudes de crédito están EN ESTUDIO: las decide el banco. Periodo: rango «7d», «30d» o «mes», o desde/hasta (AAAA-MM-DD).

  • Pipeline por etapaspipeline

    Dónde está cada oportunidad del periodo, por etapa, con el carro (título, año, precio) y los días en la etapa. Nunca dice quién es la persona. Datos reales de Pine. Periodo: rango «7d», «30d» o «mes», o desde/hasta (AAAA-MM-DD).

  • Bandeja de conversacionesbandeja_conversaciones

    Las conversaciones de Tracy con compradores y vendedores (WhatsApp y web), de la más reciente a la más vieja, de a 30: canal, estado, quién atiende, el último mensaje y el carro. El nombre y el celular solo salen si tu acceso incluye datos de personas; si no, van enmascarados. Para leer una conversación completa usa leer_conversacion con su «clave». Para la página siguiente, pasa el «siguiente» que devuelve esta.

  • Leer una conversaciónleer_conversacion

    El hilo completo de una conversación de Tracy (hasta 100 mensajes), por la «clave» que da bandeja_conversaciones. Sin acceso a datos de personas, el texto sale con celulares, cédulas y correos enmascarados.

  • Inventario del negocioinventario

    El inventario publicado en Tratto como lo ve el banco en su consola: cuántos carros hay, cuántos por tipo y la página pedida (24 por página, los más recientes primero), con precio, ciudad y precio frente al mercado. Sin datos del vendedor. Datos reales de Pine.

Puentes

Consultar los datos técnicos por placa y el estado de un traspaso en FLIT. Lo usan: Equipo, Banco, Agentes de Pine.

  • Datos técnicos por placadatos_por_placa

    Los datos técnicos de un carro por su placa (marca, línea, año, color, combustible, cilindraje, ciudad de matrícula), consultados al RUNT por Intempo. Hoy la fuente es una base SIMULADA: sirve para probar el flujo, no para afirmar nada de un carro real. Nunca trae la situación legal (prenda, embargo, SOAT) ni datos del dueño.

  • Estado de un traspaso en FLITestado_traspaso

    Lo que FLIT (la plataforma de trámites de tránsito) reportó de un trámite de traspaso: su estado actual y los hitos con fecha, tal como FLIT los describe. Solo trámites de prueba del sandbox de FLIT, creados en pausa: no llegan a un organismo de tránsito. La placa sale con sus últimos 3 caracteres.

Datos de personas: con este acceso, la bandeja muestra nombre, celular y texto sin tachar. Sin él, todo sale enmascarado.

Para leer antes de actuar

  • tratto://reglas · Las reglas que todo agente cumple al usar Tratto. Léelas antes de responderle a alguien.
  • tratto://glosario · Qué significa cada palabra que usan las herramientas.
  • tratto://fuentes · De dónde sale cada dato de las herramientas y si hoy es real o simulado.