Transit MCP API
Telemetria em tempo real de trânsito, marítimo e aviação para agentes de IA.
GitHubExperimente este MCPPatrocinado
Documentação
Transit MCP API
Telemetria de trânsito em tempo real para agentes de IA. Consome feeds GTFS-Realtime de mais de 25 agências de trânsito e fornece posições de veículos, previsões e alertas normalizados via API REST com pagamentos cripto x402 (USDC na Base).
Ao vivo: transit.motioninfo.com:8400
O que faz
- Consulta 25 feeds GTFS-RT a cada 15 segundos (MBTA, NYC Subway, BART, SEPTA e outros)
- Normaliza posições de veículos, previsões de viagens e alertas de serviço em um único banco de dados consultável
- Enriquece respostas com nomes legíveis de rotas e paradas a partir de dados estáticos do GTFS
- Fornece dados via API REST com protocolo de pagamento x402 (USDC na mainnet da Base)
- Endpoint de streaming SSE para atualizações em tempo real de posição de veículos
Endpoints
| Endpoint | Autenticação | Descrição |
|---|---|---|
GET /health | Grátis | Verificação de saúde |
GET /api/stats | Grátis | Estatísticas ao vivo |
GET /api/feeds | Grátis | Lista de feeds e status |
GET /mcp/tools | Grátis | Definições de ferramentas MCP para descoberta por agentes |
GET /api/vehicles?lat=X&lon=Y&radius_km=Z | x402 $0.001 | Veículos próximos a um local |
GET /api/alerts?feed=mbta | x402 $0.001 | Alertas de serviço |
GET /api/predictions?feed=mbta&stop=70154 | x402 $0.001 | Previsões de chegada |
GET /api/airports?q=back+bay | x402 $0.001 | Buscar paradas/estações |
GET /api/stream/vehicles?lat=X&lon=Y | Grátis | Stream em tempo real SSE |
Pagamento
Endpoints pagos usam o protocolo x402. Quando um agente acessa um endpoint pago sem pagamento, recebe HTTP 402 com um cabeçalho PAYMENT-REQUIRED contendo uma fatura USDC na Base. O agente assina uma autorização de pagamento, reenvia a solicitação com um cabeçalho PAYMENT-SIGNATURE e recebe os dados.
- Preço: $0.001 USDC por consulta
- Rede: Base mainnet (eip155:8453)
- Nível gratuito: 10 solicitações/minuto sem pagamento
Configuração
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
Ambiente
| Variável | Padrão | Descrição |
|---|---|---|
TRANSIT_MCP_PORT | 8400 | Porta do servidor da API |
X402_PAY_TO | (obrigatório) | Endereço EVM para receber pagamentos USDC |
X402_PRICE | $0.001 | Preço por consulta |
X402_NETWORK | eip155:8453 | Base mainnet |
X402_FACILITATOR | https://x402.org/facilitator | URL do facilitador x402 |
Arquitetura
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)
Licença
Proprietário. Copyright 2026 MotionInfo.