Informacion Vehicular
al Alcance de tu Agente IA

Servidor MCP que expone la base de datos del RUNT (Registro Unico Nacional de Transito de Colombia) para consulta por cualquier sistema agentico.

Conectar Ahora Ver Tools Disponibles
16
Tools
2
Resources
3
Prompts
9
Tablas DB
410
Variables

Conexion Streamable HTTP

Servidor v2.0.0. Dos transportes MCP en el mismo puerto: usa Streamable HTTP, el transporte actual del protocolo.

https://mcp-intempo.agentify.lat/mcp
https://mcp-intempo.agentify.lat/sse

El endpoint /sse se mantiene solo por compatibilidad con clientes ya integrados y esta en retirada. Para integraciones nuevas usa siempre /mcp.

GET /health

Chequeo de salud publico en https://mcp-intempo.agentify.lat/health. Devuelve status, version del servidor (2.0.0), transportes expuestos y si la autenticacion esta activa.

Autenticacion por token

Disponible, hoy desactivada: los endpoints MCP estan abiertos. Cuando se active, el token de servicio viaja en cabecera como Authorization: Bearer <token> o X-API-Key: <token>. Se coordinara antes de exigirla. /health y / quedan siempre publicos.

16 Herramientas Disponibles

Cada tool es invocable por el agente IA de forma automatica cuando detecta la necesidad. Toda respuesta es JSON estructurado.

Entorno de demostracion con datos simulados: si se consulta la placa de un carro particular (formato AAA000) que aun no esta en la base, el servidor la registra con datos verosimiles y deterministas, y desde ese momento todas las herramientas devuelven el mismo vehiculo.

🚗
buscar_vehiculo
Busca un vehiculo por placa o numero de registro y retorna su ficha tecnica completa: marca, modelo, clase, color, cilindraje, combustible, estado, gama, ciudad. Incluye la seccion propietario.
placa nro_registro
📄
verificar_documentos_vehiculo
Verifica el estado de SOAT (seguro obligatorio), RTM (revision tecnico-mecanica) y Tarjeta de Operacion. Fechas de vigencia, aseguradoras y CDA.
placa nro_registro
⚖
consultar_limitaciones_vehiculo
Medidas cautelares, embargos, secuestros, denuncias de robo, prendas. Estado inscrita/levantada, entidad juridica y descripcion.
placa nro_registro
💥
historial_accidentes_vehiculo
Historial de accidentes: cantidades por periodo, tipologia (muertos/heridos/danos), tipos (choque, atropello, volcamiento, incendio), indicadores.
placa nro_registro
🚨
infracciones_vehiculo
Indicadores de infracciones asociadas al vehiculo: SOAT, RTM, prenda, traslado.
placa nro_registro
🎯
score_riesgo_vehiculo
Score de riesgo consolidado: indicadores de accidentalidad, estado de documentos, medidas cautelares, gama y estado general.
placa nro_registro
📋
reporte_integral_vehiculo
Reporte completo tipo Vehiscore: ficha tecnica + propietario + documentos + limitaciones + accidentes + indicadores en un solo reporte. Acepta consulta por lote: hasta 25 placas en una sola llamada con el parametro placas.
placa placas nro_registro
🔴
alertas_vehiculo
Detecta banderas rojas: SOAT vencido, RTM vencida, embargos, secuestros, robos, prendas, accidentes recientes. Severidad ALTA/MEDIA/BAJA.
placa nro_registro
🔑
consultar_propietario_por_placa
Propietario registrado de un vehiculo a partir de su placa: documento, tipo, si es persona natural o juridica, fecha de adquisicion y cuantos vehiculos tiene. No expone el nombre.
placa
👤
consultar_propietario
Perfil del propietario: vehiculos actuales e historicos, tenencia promedio, compra/venta, genero, fecha nacimiento.
documento tipo_documento
💳
consultar_licencia_conductor
Licencia de conduccion: categoria (A1-C3), estado, vigencia, restricciones, maxima categoria, antiguedad, historial renovaciones.
documento tipo_documento
🚨
infracciones_conductor
Infracciones de transito: cantidades por periodo, tipologia (I grave a VII leve), estados (pendiente/resolucion/pagado), indicador.
documento tipo_documento
💥
accidentes_conductor
Informacion de accidentes vinculada al propietario. Para detalle por vehiculo, usar historial_accidentes_vehiculo.
documento tipo_documento
📋
reporte_integral_persona
Reporte completo: propietario + licencia + infracciones + vehiculos + datos sociodemograficos en un solo reporte.
documento tipo_documento
📊
analisis_flota
Estadisticas agregadas de la flota: distribucion por marca, clase, ciudad, gama, combustible. Filtros combinables.
marca clase ciudad gama modelo_desde modelo_hasta
🔍
buscar_vehiculos
Busqueda avanzada con filtros multiples. Cada resultado trae ademas linea y modelo_año. Soporta paginacion con offset y declara limite_aplicado y hay_mas en la respuesta. Maximo 50 resultados por pagina.
marca clase ciudad combustible estado limite offset

encontrado • consultado_en

Todas las respuestas son JSON, nunca frases sueltas. Cada una lleva encontrado (booleano) y consultado_en (ISO-8601 UTC).

codigo • valor • significado

Los indicadores viajan con su codigo del diccionario. Por ejemplo: {"codigo": "VPRE_IND01", "valor": 2, "significado": "Prenda inscrita >= 8 años"}

Conecta tu Agente IA

Selecciona tu plataforma y sigue la guia paso a paso. Todas usan Streamable HTTP contra /mcp.

Pine CRM - Agentes IA

Conecta el MCP a tus agentes para darles habilidades de consulta vehicular

1
En tu agente IA, ve a Herramientas & Respuestas y haz clic en + Agregar
2
Selecciona Conectar MCP Externo. Se abre el dialogo con seis campos.
3
Rellena el formulario campo por campo, en este orden y con estos valores exactos:
Nombre del servicio *Intempo RUNT
DescripcionConsulta de vehiculos y transito
URL del servidor MCP *https://mcp-intempo.agentify.lat/mcp
TransporteStreamable HTTP
AutenticacionSin autenticacion
Timeout (ms)30000
Los campos marcados con * son requeridos. Transporte y Autenticacion son desplegables: elige las opciones indicadas, no escribas texto libre.
4
Haz clic en Conectar. Veras el indicador verde con 16 herramientas disponibles.
5
Haz clic en Sincronizar en la parte superior del agente para activar las herramientas.
✅
Listo: Tu agente puede buscar vehiculos, verificar documentos, detectar alertas y generar reportes integrales en la conversacion.
ⓘ
Cuando se active el token: el campo Autenticacion dejara de ser Sin autenticacion y pasara a usar el token de servicio por cabecera (Authorization: Bearer <token> o X-API-Key: <token>). Se coordinara contigo antes de exigirlo. El resto de campos no cambia.

Claude Desktop / Cowork

El cliente oficial de Anthropic con soporte nativo MCP

1
Abre el archivo de configuracion:
%APPDATA%\Claude\claude_desktop_config.json
2
Agrega la siguiente entrada en mcpServers. El puente mcp-remote habla Streamable HTTP contra /mcp:
claude_desktop_config.jsonJSON
{
  "mcpServers": {
    "intempo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-intempo.agentify.lat/mcp"
      ]
    }
  }
}
3
Reinicia Claude Desktop. Veras los 16 tools en el icono de herramientas.
✅
Requiere npx (Node.js). El paquete mcp-remote conecta Claude Desktop y Cowork al servidor por Streamable HTTP.

Claude Code (CLI)

La CLI oficial de Anthropic para desarrolladores

1
Ejecuta en tu terminal:
Terminalbash
claude mcp add --transport http intempo \
  https://mcp-intempo.agentify.lat/mcp
2
Verifica la conexion con claude mcp list. Deben aparecer las 16 tools.
✅
Claude Code conecta directamente via Streamable HTTP, sin paquetes intermedios.

Cursor IDE

Editor de codigo con IA integrada y soporte MCP

1
Abre Settings → MCP Servers
2
Agrega un nuevo server tipo Streamable HTTP:
.cursor/mcp.jsonJSON
{
  "mcpServers": {
    "intempo": {
      "type": "http",
      "url": "https://mcp-intempo.agentify.lat/mcp"
    }
  }
}
✅
Cursor soporta Streamable HTTP nativo. Los tools aparecen automaticamente en el chat.

Windsurf / Codeium

Editor IA con soporte MCP via configuracion

1
Abre ~/.codeium/windsurf/mcp_config.json
2
Agrega la configuracion apuntando a /mcp:
mcp_config.jsonJSON
{
  "mcpServers": {
    "intempo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-intempo.agentify.lat/mcp"
      ]
    }
  }
}
✅
Requiere npx (Node.js) para el puente mcp-remote, que habla Streamable HTTP contra /mcp.

Agente Custom (Python)

Conecta desde cualquier agente Python usando el SDK de MCP

1
Instala la dependencia:
Terminalbash
pip install mcp
2
Conecta y usa los tools:
agent.pyPython
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://mcp-intempo.agentify.lat/mcp"
) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()

        # Listar tools disponibles
        tools = await session.list_tools()

        # Buscar un vehiculo
        result = await session.call_tool(
            "buscar_vehiculo",
            {"placa": "ABC123"}
        )

        # Consulta por lote: hasta 25 placas
        lote = await session.call_tool(
            "reporte_integral_vehiculo",
            {"placas": ["ABC123", "XYZ789"]}
        )
✅
Compatible con LangChain, CrewAI, AutoGen, o cualquier agente custom. Si tu SDK aun no soporta Streamable HTTP, el transporte SSE legacy sigue disponible en /sse.

Agente Custom (Node.js / TypeScript)

Conecta con el SDK oficial de MCP

1
Instala la dependencia:
Terminalbash
npm install @modelcontextprotocol/sdk
2
Conecta y usa los tools:
agent.tsTypeScript
import { Client } from
  "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from
  "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://mcp-intempo.agentify.lat/mcp")
);

const client = new Client({
  name: "my-agent",
  version: "1.0.0"
});

await client.connect(transport);
const result = await client.callTool({
  name: "buscar_vehiculo",
  arguments: { placa: "ABC123" }
});
✅
Compatible con Vercel AI SDK, n8n, y cualquier framework Node.js. Si tu SDK aun no soporta Streamable HTTP, el transporte SSE legacy sigue disponible en /sse.

Contexto y Plantillas

Resources proporcionan contexto estatico. Prompts son plantillas de flujo reutilizables.

Resources (Contexto)

intempo://diccionario-variables

Diccionario completo de las 410 variables del sistema organizadas por tematica. Permite al agente entender que significa cada campo.

intempo://convenciones

Tabla de convenciones: significado de valores numericos en indicadores como gama, prenda, SOAT, RTM, estado de licencia, etc.

Prompts (Plantillas)

evaluar_para_compra(placa)

Guia completa para evaluar un vehiculo antes de comprarlo. Genera un dictamen: comprar / no comprar / comprar con precaucion.

evaluar_conductor(documento)

Evaluacion de riesgo del conductor: licencia, infracciones, experiencia. Genera perfil de riesgo bajo/medio/alto/muy alto.

verificar_cumplimiento(placa)

Checklist de cumplimiento normativo: SOAT, RTM, cautelares, embargos, prendas. Resultado: APTO / NO APTO para tramites.

Casos de Uso

Escenarios donde este MCP potencia a los agentes IA

🛒

Compraventa de Vehiculos

Evaluacion pre-compra con verificacion legal, documental y de accidentalidad.

🛡

Seguros

Scoring de riesgo para cotizacion de polizas SOAT y todo riesgo.

🏦

Credito Vehicular

Due diligence: estado legal, prendas, propietarios, valor de mercado.

🚚

Gestion de Flotas

Monitoreo de documentos, alertas de vencimiento, estadisticas agregadas.

✅

Cumplimiento Normativo

Verificacion de requisitos legales para tramites ante organismos de transito.

👨‍💻

Perfilamiento

Evaluacion de conductores: licencia, infracciones, accidentes, experiencia.

💬

Atencion al Cliente

Bots que responden consultas: "Mi SOAT esta vigente?", "Tengo multas?"