Transit MCP API

Telemetría en tiempo real de tránsito, marítimo y aviación para agentes de IA.

Documentación

Transit MCP API

Telemetría de tránsito en tiempo real para agentes de IA. Consume feeds GTFS-Realtime de más de 25 agencias de tránsito y sirve posiciones de vehículos normalizadas, predicciones y alertas a través de una API REST con pagos criptográficos x402 (USDC en Base).

En vivo: transit.motioninfo.com:8400

Qué hace

  • Consulta 25 feeds GTFS-RT cada 15 segundos (MBTA, NYC Subway, BART, SEPTA y más)
  • Normaliza posiciones de vehículos, predicciones de viajes y alertas de servicio en una única base de datos consultable
  • Enriquece las respuestas con nombres legibles de rutas y paradas a partir de datos estáticos GTFS
  • Sirve datos mediante API REST con protocolo de pago x402 (USDC en Base mainnet)
  • Endpoint de transmisión SSE para actualizaciones de posición de vehículos en tiempo real

Endpoints

EndpointAutenticaciónDescripción
GET /healthGratisVerificación de estado
GET /api/statsGratisEstadísticas en vivo
GET /api/feedsGratisLista de feeds y estado
GET /mcp/toolsGratisDefiniciones de herramientas MCP para descubrimiento por agentes
GET /api/vehicles?lat=X&lon=Y&radius_km=Zx402 $0.001Vehículos cerca de una ubicación
GET /api/alerts?feed=mbtax402 $0.001Alertas de servicio
GET /api/predictions?feed=mbta&stop=70154x402 $0.001Predicciones de llegada
GET /api/airports?q=back+bayx402 $0.001Búsqueda de paradas/estaciones
GET /api/stream/vehicles?lat=X&lon=YGratisTransmisión SSE en tiempo real

Pago

Los endpoints de pago utilizan el protocolo x402. Cuando un agente accede a un endpoint de pago sin pagar, recibe un HTTP 402 con un encabezado PAYMENT-REQUIRED que contiene una factura USDC en Base. El agente firma una autorización de pago, reenvía la solicitud con un encabezado PAYMENT-SIGNATURE y recibe los datos.

  • Precio: $0.001 USDC por consulta
  • Red: Base mainnet (eip155:8453)
  • Nivel gratuito: 10 solicitudes/minuto sin pago

Configuración

python3 -m venv /opt/transit-mcp
source /opt/transit-mcp/bin/activate
pip install gtfs-realtime-bindings requests aiohttp fastapi uvicorn 'x402[fastapi,evm]'

python setup_db.py        # Create database and seed feeds
python load_static.py     # Download GTFS static data (routes, stops)
python ingest.py          # Start polling (run as daemon)
python server.py          # Start API server

Entorno

VariablePredeterminadoDescripción
TRANSIT_MCP_PORT8400Puerto del servidor API
X402_PAY_TO(obligatorio)Dirección EVM para recibir pagos USDC
X402_PRICE$0.001Precio por consulta
X402_NETWORKeip155:8453Base mainnet
X402_FACILITATORhttps://x402.org/facilitatorURL del facilitador x402

Arquitectura

GTFS-RT Feeds (25 agencies)
    ↓ poll every 15s (ingest.py)
SQLite Database (transit.db)
    ↓ query
FastAPI Server (server.py)
    ↓ x402 middleware
AI Agent (pays USDC on Base)

Licencia

Propietaria. Copyright 2026 MotionInfo.