Um agente autônomo reserva um voo em seis passos, todos documentados nesta página.

1. Encontrar o voo

GET /api/v1/flights?q=<cidade> busca por cidade de destino, código de aeroporto ou número do voo.

2. Cotar as tarifas

GET /api/v1/flights/{flightNumber}/fares?budget=<centavos> devolve cada tarifa com preço, horário de chegada, se chega no mesmo dia, a bagagem incluída e se cabe no orçamento. O campo bestByConstraints já responde a pergunta da jornada: a mais barata que chega no mesmo dia com uma malia despachada e dentro do orçamento.

3. Autenticar

OAuth 2.1 authorization code com PKCE. Detalhes em /auth.md. A leitura é pública; criar reserva, mandato, ticket e pagamento exige token com os escopos correspondentes.

4. Criar a reserva

POST /api/v1/bookings com flightNumber, fareCode epassengers.

5. Estabelecer o mandato

POST /api/v1/mandates com limit (o teto em centavos). Nenhuma cobrança é possível sem um mandato válido.

6. Confirmar e emitir o ticket

POST /api/v1/orders com o bookingId, o mandateId e o pagamento. Depois, GET /api/v1/orders/{id}/receipt recupera o recibo.

WebMCP

As mesmas operações de leitura estão disponíveis como tools WebMCP. O manifesto em /.well-known/webmcp.json lista search_flights, get_flight, quote_fare, add_to_booking e place_booking. Em um navegador com WebMCP, document.modelContext as registra automaticamente via /webmcp.js.