RedTransporteMCP
Servidor MCP de solo lectura que actúa como proxy de RedTransporteAPI para transporte público de Santiago.
Buscar paraderos por nombre/código y ver detalle (coords, accesibilidad, servicios).
Encontrar paraderos cercanos, estación metro/tren más cercana, recorridos cerca de un punto y paraderos en bounding box.
Listar recorridos y obtener detalle, paradas y geometría.
Obtener predicciones de llegada en tiempo real para un paradero.
Sugerir recorridos directos entre dos puntos y planificar viajes RAPTOR con transbordos, tiempos y tarifa.
Consultar estadísticas y estado del dataset GTFS.
Solo lectura, sin tools de escritura/administración; valida parámetros y traduce errores MCP.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RedTransporteMCP Show me the next arrivals at stop "PA156""
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
RedTransporteMCP
Servidor MCP (Model Context Protocol) privado para RedTransporteAPI — transporte público de Santiago de Chile: paraderos, recorridos, predicciones en tiempo real (iBus + RED web) y planificación RAPTOR.
El repositorio de la API se deja intacto como motor REST/CLI; este proyecto es un adaptador MCP que la consume por HTTP. Código libre para quien quiera montarlo; el endpoint HTTP está protegido por defecto (deny-by-default).
Capacidades
Tool | Descripción |
| Buscar paraderos por nombre o código parcial |
| Detalle de un paradero (coords, accesibilidad, servicios) |
| Paraderos cercanos a una coordenada |
| Estación metro/tren más cercana |
| Recorridos cerca de un punto |
| Paraderos en un bounding box |
| Listar recorridos (filtro por modo) |
| Detalle, paradas y geometría de un recorrido |
| Predicciones en tiempo real para un paradero |
| Recorridos directos entre dos puntos |
| Planificación RAPTOR con transbordos y tarifa |
| Estado del dataset |
Todas las tools son de solo lectura. No hay tools de escritura ni de administración.
Related MCP server: @cyanheads/onebusaway-mcp-server
Arquitectura
La guía completa está en MCP_USAGE.md: tools, transports,
OAuth, ChatGPT, OpenCode, despliegue y troubleshooting.
ChatGPT / Codex / Claude / opencode
│ (MCP streamable-http o stdio)
▼
┌───────────────────────┐
│ RedTransporteMCP │ ← bearer token MCP (RED_TRANSPORTE_MCP_TOKEN)
│ deny-by-default │
└──────────┬────────────┘
│ HTTPS + bearer token API (RED_TRANSPORTE_API_TOKEN)
▼
┌───────────────────────┐
│ RedTransporteAPI │ ← motor GTFS/RAPTOR/iBus/RED (repo aparte)
└───────────────────────┘El servidor es un proxy delgado: valida parámetros, traduce errores a errores MCP y reenvía al REST. No carga GTFS en memoria ni duplica el motor. El transporte HTTP usa OAuth 2.1 con PKCE para clientes como ChatGPT; el token MCP existente se usa en la pantalla de consentimiento y sigue funcionando para clientes legacy.
Configuración
Variable | Default | Descripción |
|
| Base URL del REST |
| (requerido) | Bearer token de la API (crear en |
| (requerido para HTTP) | Bearer token exigido al cliente MCP |
|
| Hostname HTTP permitido por la protección DNS-rebinding |
|
| URL canónica del issuer; puede incluir un prefijo de ruta y el recurso final es |
| (deriva del MCP token) | Secreto HMAC opcional separado para clientes y tokens OAuth |
|
| Puerto del transporte HTTP |
|
| Timeout de llamadas al REST (segundos) |
Uso local (stdio)
uv sync
RED_TRANSPORTE_API_TOKEN=tu-token uv run red-transporte-mcp --transport stdioConfigura el cliente MCP con comando uv run red-transporte-mcp (stdio).
Uso remoto (streamable-http)
RED_TRANSPORTE_API_TOKEN=tu-token \
RED_TRANSPORTE_MCP_TOKEN=token-privado \
uv run red-transporte-mcp --transport http --host 0.0.0.0 --port 8001Endpoint: https://<host>/mcp por defecto. Si RED_TRANSPORTE_MCP_BASE_URL es,
por ejemplo, https://mcp.example.com/red, el endpoint es
https://mcp.example.com/red/mcp y las rutas auxiliares también quedan bajo
/red (/red/health, /red/register, /red/oauth/consent y los metadatos
OAuth).
Liveness: GET <prefijo>/health (sin prefijo, GET /health; no authentication;
no application data).
Sin
RED_TRANSPORTE_MCP_TOKEN,<prefijo>/mcpfalla cerrado con401y la pantalla de consentimiento OAuth no puede autorizar usuarios.Con token configurado, cualquier request sin un bearer OAuth válido o el token legacy recibe
401(deny-by-default).
Conexión desde ChatGPT
En ChatGPT web, activa Developer mode en Settings → Apps → Advanced Settings.
Crea una app MCP desde Apps → Create.
Usa el endpoint HTTPS de tu despliegue, por ejemplo
https://mcp.example.com/mcp, y selecciona OAuth.Pulsa Scan Tools; el flujo redirige a la pantalla de consentimiento del MCP.
Introduce el valor de
RED_TRANSPORTE_MCP_TOKENdesde tu gestor de secretos.Crea/publica la app y actívala desde el menú de herramientas de un chat.
El MCP publica los metadatos en
<prefijo>/.well-known/oauth-protected-resource/mcp y
<prefijo>/.well-known/oauth-authorization-server, registra clientes
dinámicamente y requiere PKCE S256. Sin prefijo, <prefijo> es vacío. No hay
que pegar el token de la API REST en ChatGPT.
Producción
Este repositorio no documenta un host, LXC, reverse proxy, secretos ni estado persistente concreto. El procedimiento de producción pertenece a la documentación privada de infraestructura del operador. Revisa allí el runbook antes de instalar este servicio.
Docker local
cp .env.example .env
# completar RED_TRANSPORTE_API_TOKEN y RED_TRANSPORTE_MCP_TOKEN en .env
docker compose up --buildEl compose publica solo 127.0.0.1:8001; un reverse proxy o túnel debe
terminar TLS y reenviar al puerto local.
Seguridad
Deny-by-default:
<prefijo>/mcprequiere un bearer OAuth válido o el token MCP legacy.OAuth usa authorization code + PKCE
S256, resource indicators y tokens ligados al recurso<base>/mcp.Los access tokens expiran en una hora y los refresh tokens rotan durante 30 días.
El token MCP se compara en tiempo constante (
hmac.compare_digest).El token de la API nunca se expone a los clientes MCP: el servidor lo usa solo contra el REST.
Errores de la API se traducen a errores MCP sin filtrar detalles internos.
Las tools son read-only y no exponen paths del servidor.
Roadmap
mTLS de OpenAI como capa adicional de identificación
CI: tests, build de imagen, smoke test MCP
Imagen Docker reproducible (uv.lock, semver)
Resources MCP para shapes/geometrías grandes
Licencia
GPL-3.0-only. Datos: GTFS DTPM, iBus y RED web — revisar términos de cada fuente antes de un uso público amplio.
Available Tools
15 toolsfind_closest_stationEstación más cercanaARead-only
Encontrar la estación de metro o tren más cercana a una coordenada, con sus servicios.
Inputs: latitude (required), longitude (required). Returns: object
find_nearby_stopsParaderos cercanosBRead-only
Encontrar paraderos dentro de un radio (km) de una coordenada, ordenados por distancia.
Inputs: latitude (required), longitude (required), limit, radius_km. Returns: object
find_stops_in_bboxParaderos en bounding boxBRead-only
Paraderos dentro de un bounding box (min/max lat/lon).
Inputs: max_latitude (required), min_latitude (required), max_longitude (required), min_longitude (required). Returns: object
get_arrivalsPredicciones de llegadaBRead-only
Predicciones de llegada en tiempo real para un paradero (iBus + RED web). Usar después de resolver el código con search_stops.
Inputs: stop_code (required), service. Returns: object
get_gtfs_statusEstado del dataset GTFSBRead-only
Estado del dataset GTFS: disponible, fecha de descarga, vigencia.
Inputs: no named parameters. Returns: object
get_routeDetalle de un recorridoARead-only
Detalle de un recorrido: nombre, color, modo, paradas de ida/vuelta y frecuencias por día.
Inputs: route_id (required). Returns: object
get_route_shapeGeometría de un recorridoBRead-only
Geometría (shape) de un recorrido como coordenadas [lon, lat].
Inputs: route_id (required), direction. Returns: object
get_routes_near_pointRecorridos cerca de un puntoBRead-only
Recorridos que pasan cerca de una coordenada, dentro de un radio.
Inputs: latitude (required), longitude (required), radius_km. Returns: object
get_route_stopsParadas de un recorridoBRead-only
Secuencia de paradas de un recorrido en una dirección (0=ida, 1=vuelta).
Inputs: route_id (required), direction. Returns: object
get_stopInformación de un paraderoBRead-only
Obtener información detallada de un paradero por su código: nombre, coordenadas, accesibilidad y servicios que pasan por él.
Inputs: stop_code (required). Returns: object
get_system_statsEstadísticas del sistemaBRead-only
Estadísticas del dataset GTFS: paraderos, recorridos, viajes, modos.
Inputs: no named parameters. Returns: object
list_routesListar recorridosBRead-only
Listar recorridos, opcionalmente filtrados por modo (bus, metro, rail, tram).
Inputs: mode. Returns: object
plan_journeyPlanificar viajeARead-only
Planificar un viaje en transporte público entre dos coordenadas (RAPTOR): alternativas con transbordos, tiempos y tarifa integrada. day: L=laboral, S=sábado, D=domingo. fare_type: normal, estudiante, adulto_mayor.
Inputs: to_latitude (required), to_longitude (required), from_latitude (required), from_longitude (required), +4 more. Returns: object
search_stopsBuscar paraderosARead-only
Buscar paraderos de Santiago por nombre o código parcial. Útil cuando el usuario menciona un lugar o intersección y hay que resolver el código del paradero.
Inputs: query (required), limit. Returns: object
suggest_direct_routesRecorridos directos entre dos puntosARead-only
Sugerir recorridos directos que conecten dos puntos. No planifica transbordos; para eso usar plan_journey.
Inputs: to_latitude (required), to_longitude (required), from_latitude (required), from_longitude (required), +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Tools are mostly distinct with clear purposes: stop lookup (search_stops/get_stop/find_nearby_stops), route lookup (list_routes/get_route/get_route_stops/get_route_shape), and journey planning (plan_journey/suggest_direct_routes). Some minor boundary overlap exists between route stop listing (get_route_stops, get_route) and spatial queries (find_nearby_stops, find_closest_station, get_routes_near_point, find_stops_in_bbox), which could cause some ambiguity but descriptions help disambiguate them.
Names mostly follow a consistent get_/find_/list_/search_/suggest_/plan_ prefix pattern with descriptive object suffixes. Minor inconsistencies: mix of get_/find_/list_ for data retrieval operations is permissible but not perfectly uniform, and get_system_stats vs get_gtfs_status are somewhat similar in style. Overall predictable and readable.
15 tools is on the higher end but appropriate for a comprehensive transit MCP server covering stops, routes, journey planning, arrival predictions, and dataset health. Each tool appears to earn its place covering distinct data needs.
The surface is comprehensive: spatial queries (nearby, bbox), route listing/detail/geometry, stop search/detail, arrivals, journey planning with mode and fare options, plus GTFS dataset status. Minor gaps exist, such as direct route-to-route stop exploration without coordinates (though get_route covers this), and no route filtering by arrival time, but the core transit workflows are well covered.
Maintenance
Related MCP Connectors
MCP compatibility and transport verification server.
MCP compatibility and transport verification server.
MCP compatibility and transport verification server.
MCP compatibility and transport verification server.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for Chelaile realtime public transit data in China, including bus and metro arrivals, vehicle positions, nearby stops, timetables, and route planning. It runs locally over stdio with no login or account configuration required.1538MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying stops, routes, real-time arrivals, vehicle positions, and schedules from OneBusAway transit APIs via MCP, supporting STDIO or Streamable HTTP.323 npm2Apache 2.0
- FlicenseNot gradedqualityDmaintenanceMCP server exposing live MBTA V3 transit data, with tools for routes, stops, arrivals, alerts, and vehicle positions.-
- AlicenseNot gradedqualityBmaintenanceMCP server for the Mobilerun platform, exposing tools for device control, workflow automation, task management, and platform operations via a stateless HTTP or stdio interface with bearer-token authentication and policy-based access control.1Apache 2.0