transmilenio-mcp

Desde el 4 de noviembre de 2026 TransMilenio publica la posición de sus buses como datos abiertos (GTFS Realtime). Este proyecto los conecta a Claude por MCP y trae un mapa para verlos en el navegador. Corre en tu computador y no pide API key ni registro.

Un minuto con sonido, grabado en vivo el martes 10 de noviembre a las 7:18 p. m.: la flota completa, una estación, un bus, lo programado contra lo real, los viajes cancelados y dos preguntas a Claude.

https://github.com/user-attachments/assets/7a694c14-81cf-42f5-8b0b-6c298049341b

Tú:     ¿Qué buses llegan a Calle 72 en los próximos 5 minutos?
Claude: H75 hacia Portal Usme, llegando (vagón B-2). A60, llegando.
        L18 hacia Portal 20 de Julio, en 1 min. D24 hacia Portal 80, en 2 min (va 8 min tarde).

Cubre troncales, duales, alimentadores, SITP zonal y TransMiCable. El 5 de noviembre a las 7 p. m. el feed tenía 7.730 buses en 665 rutas.

Instalar

Hace falta uv (pip install uv).

Claude Code

claude mcp add transmilenio -- uvx transmilenio-mcp

Claude Desktop, en claude_desktop_config.json:

{
  "mcpServers": {
    "transmilenio": {
      "command": "uvx",
      "args": ["transmilenio-mcp"]
    }
  }
}

La primera vez descarga el GTFS del día (~180 MB) y arma un índice de 0,4 MB. Tarda unos 30 segundos y luego queda en caché.

Opcional: copia skills/transmilenio/ a tus skills de Claude. Le explica cómo leer los datos (ultima_parada es la última que el bus pasó, los tiempos son estimados, qué hacer si el feed está detenido o si faltan buses sin sentido conocido).

Related MCP server: Transporter CC MCP Server

Ver el mapa

uvx --from transmilenio-mcp transmilenio-web

Abre http://127.0.0.1:8765. Puedes buscar una ruta (C25) o una estación (Calle 72), tocar un bus para ver sus próximas paradas y usar tu ubicación para saber cuándo pasa por tu paradero. Tiene modo noche (automático de 6 p. m. a 6 a. m.) y la tecla R activa un modo para grabar video.

Las capturas se regeneran con python docs/capturas.py y el video con los pasos de docs/video.

Veedor: lo programado contra lo que sale a la calle

El horario oficial dice cuántos viajes debe hacer cada ruta y cuántos buses deberían estar andando a cada hora. El feed dice cuántos hay de verdad. Juntos permiten preguntar cosas como "¿qué zonales tienen menos buses de los programados en la hora pico?" o "¿cómo le fue al C25 esta semana?".

Para eso hay que guardar el feed mientras pasa el día:

uvx --from transmilenio-mcp transmilenio-veedor

Lee el feed una vez por minuto y lo guarda en un SQLite local (entre 5 y 10 MB por día). También puedes agregar --veedor al mapa o al MCP para que guarde mientras estén abiertos. Si el feed se cae, lo anota como caída y no lo cuenta como buses; salud_feed dice cuánto tiempo estuvo caído.

Un ejemplo con la foto del jueves 5 de noviembre a las 7:11 p. m.:

Algunas zonales tenían menos de la mitad de sus buses (K904, L810, A516, D122). Con un solo momento no se puede sacar mucho; para medir hay que dejar el recolector prendido varios días.

Los viajes cancelados no necesitan recolector para el día en curso: el feed de viajes trae todos los del día con su estado (programado, cancelado o añadido). El martes 10 de noviembre a la 1 p. m. el horario tenía 81.378 viajes y TransMilenio había marcado 5.866 como cancelados (7,2 %): 11,1 % en el zonal, 2,8 % en alimentadores y 0,5 % en la troncal. Para comparar días hay que guardarlos; el recolector lo hace cada 10 minutos.

Qué se le puede preguntar

Cómo calcula las llegadas

El feed de TransMilenio dice dónde está cada bus y de qué ruta es. No dice a qué hora llegará a las siguientes paradas, y desde el 10 de noviembre de 2026 tampoco trae una parada que corresponda a la posición del bus. Así que el bus se ubica por geometría: el tramo de su ruta que tiene más cerca. La ida y la vuelta suelen ir por la misma vía; las separa hacia dónde se ha movido el bus entre una lectura y otra. TransMilenio regenera el feed más o menos cada minuto, así que en la primera pregunta algunos buses aún no tienen sentido y la respuesta dice cuántos; en uno o dos minutos salen casi todos.

Con el bus ubicado, la estimación toma qué parte del tramo actual ya recorrió y le suma el tiempo de los tramos que le faltan. Ese tiempo sale del horario oficial, corregido por el tráfico del momento: Bogotá no publica velocidades en vivo, pero cada bus del feed sirve de sensor. Cuando un bus avanza por su recorrido se compara lo que tardó con lo que le daba el horario, y ese factor queda para el tramo (y para las otras rutas que pasan por ahí) durante 20 minutos. Con 35 minutos del feed de un martes al mediodía, el error medio de las llegadas bajó de 2,1 a 1,7 minutos (de 3,6 a 2,8 en las que estaban a 10-20 minutos). buses_ruta dice además si una variante va más lenta o más rápida que su horario.

Si el feed deja de actualizarse (pasa de noche), cada respuesta trae un aviso y los tiempos se calculan contra el último dato, no contra la hora actual. Un bus que lleva más de 5 minutos sin reportar no se usa para estimar llegadas.

Más detalle en docs/arquitectura.md.

Datos y créditos

Los datos son de TransMilenio S.A. y este es un proyecto personal, sin relación con la empresa.

Los datos tienen licencia CC BY-SA 4.0; el índice que arma este proyecto es una obra derivada y lleva la misma licencia (ver NOTICE). El código es MIT. Dudas sobre los datos: radicacion@transmilenio.gov.co.

transmi-live documentó con datos reales cómo se comporta el feed, y eso ahorró varias horas.

Desarrollo

python -m venv .venv
.venv/Scripts/pip install -e ".[dev]"     # Linux/macOS: .venv/bin/pip
pytest                                     # sin internet: usa feeds reales guardados en tests/fixtures
ruff check . && ruff format --check .
python docs/capturas.py                    # capturas y demo del README (con el mapa abierto)
transmilenio-web --no-abrir               # mapa local
transmilenio-mcp --http --port 8000       # MCP por HTTP en /mcp

Variables opcionales: TRANSMI_CACHE (carpeta del índice), TRANSMI_INDICE_URL (índice ya armado, para no descargar el GTFS), TRANSMI_RT_BASE (otra base para los feeds), TRANSMI_HISTORIAL (archivo SQLite del veedor).