Skip to main content
Glama
Transporter CC MCP Server

Transporter CC MCP Server

Transporter CC MCP Server

Servidor MCP (Model Context Protocol) para búsqueda de rutas de TransMilenio y SITP en Bogotá, con tracking GPS en vivo.

Herramientas disponibles

Herramienta

Descripción

find_route

Busca rutas entre origen y destino (directas o con transbordo)

nearby_stops

Encuentra paraderos cercanos a una ubicación

get_bus_locations

Posiciones GPS de buses en una ruta, con distancia a un punto de referencia

get_arrivals

Tiempos estimados de llegada de buses a un paradero

get_stops

Lista completa de paraderos

get_routes_at_stop

Rutas que paran en una estación/paradero

get_route_info

Recorrido y paraderos de una ruta

Related MCP server: Movilidad Con Prompts

Instalación

git clone https://github.com/carloscrcalderon/transporter_cc_mcp.git
cd transporter_cc_mcp
uv sync

Configuración

Copiá .env.example a .env y configurá:

GOOGLE_MAPS_API_KEY=tu_api_key_aqui

Las demás variables usan defaults funcionales (credenciales públicas de la API SITP y realtime provider).

Ejecución local

SSE (recomendado para agentes)

uv run transporter_cc_mcp --transport sse --host 0.0.0.0 --port 8080

El endpoint SSE queda en http://localhost:8080/sse.

Stdio

uv run transporter_cc_mcp --transport stdio

Conectar con agentes

Para ver la guía detallada con diagrama de flujo, ejemplos conversacionales, reglas de negocio y máquina de estados, consulta la Guía de Integración para Agentes (docs/agent_integration.md).

Hermes Agent

Agregá al mcp.json de Hermes:

{
  "mcpServers": {
    "transporter_cc": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

OpenClaw

Agregá al config de OpenClaw (~/.openclaw/config.yaml o donde lo tengas):

mcp_servers:
  transporter_cc:
    type: sse
    url: http://localhost:8080/sse

Pruebas

uv run pytest

Available Tools

8 tools
find_routeC

Busca la mejor ruta directa o con transbordo entre un origen y un destino en Bogotá (coordenadas o direcciones), enriquecida con seguimiento en vivo cuando esté disponible.

Inputs: origin (required), destination (required), now, max_nearby_stops, +1 more. Returns: Structured response payload for find_route tool.

get_arrivalsB

Devuelve los próximos buses aproximándose y su tiempo estimado de llegada para un paradero dado (código de paradero, ej. 'TM0058').

Inputs: stop_code (required).

get_bus_locationsB

Devuelve la ubicación GPS en tiempo real de los buses en operación (ej. 'B10'). Puede recibir coordenadas de referencia o paradero (stop_code, stop_id).

Inputs: route_code (required), stop_id, stop_code, target_latitude, +1 more.

get_route_infoC

Devuelve el itinerario y trazado completo para un código/ID de ruta dado.

Inputs: route_id (required). Returns: API response container for infoRuta endpoint.

get_routes_at_stopB

Devuelve las rutas de transporte que prestan servicio en un paradero dado (stop_id).

Inputs: stop_id (required). Returns: API response container for searchRutasByEstacionTroncales endpoint.

get_route_statusA

Devuelve en una sola llamada el estado operativo completo de una ruta (horario de servicio, tiempos estimados de llegada y buses en vivo con dirección) para un código de ruta y paradero dado.

Inputs: stop_code (required), route_code (required), now. Returns: Unified response model returned by the get_route_status tool.

get_stopsA

Devuelve la lista completa de paraderos del sistema de transporte.

Inputs: no named parameters. Returns: API response container for getParaderosList endpoint.

nearby_stopsC

Devuelve los paraderos de transporte público más cercanos a un punto geográfico.

Inputs: latitude (required), longitude (required), max_stops, max_radius_meters. Returns: Formatted single-object response for the nearby_stops tool.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Cada herramienta tiene un propósito claramente distinto: llegadas en tiempo real, listado de paraderos, rutas en un paradero, información de ruta, ubicación GPS de buses, estado operativo completo, planificación de rutas y paraderos cercanos. No hay superposición funcional.

    Naming Consistency4/5

    La mayoría de herramientas sigue el patrón verbo_sustantivo (get_arrivals, get_stops, etc.), excepto 'nearby_stops' (adjetivo_sustantivo) y 'find_route' (verbo diferente a 'get'). En general, la convención es predecible y uniforme.

    Tool Count5/5

    Con 8 herramientas, el servidor cubre de manera concisa las funcionalidades esenciales de un sistema de transporte: consulta de paraderos, rutas, llegadas en tiempo real y planificación. No hay herramientas redundantes ni faltantes obvias.

    Completeness4/5

    El conjunto cubre los casos de uso principales de un sistema de transporte público (consulta de paraderos, rutas, llegadas, ubicación de buses y planificación). Falta quizás un endpoint para alertas de servicio, pero para el alcance declarado es suficientemente completo.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers