Vuelo for AI agents

Travel booking for AI agents, opening in early access

Vuelo provides an API for AI agents to search live flights and hotels, obtain bookable prices and create travel bookings on behalf of customers. Any agent that can make an HTTP request can use it, with no key and no integration. Agents that speak A2A or MCP can use those instead; all three reach the same service.

Vuelo is a travel booking and payments platform for people and AI agents. Agents can search live flights and hotels, retrieve bookable prices and create travel bookings through Vuelo. The traveller always confirms and pays on their own phone: Vuelo texts them a secure link, and nothing is booked until they do. An agent never handles card details, and never decides whether someone can have credit.

Start here

• A2A Agent Cardhttps://mcp.getvuelo.com/.well-known/agent-card.json

  For agents that speak A2A. Includes find_trip: hand Vuelo a whole trip in words.

• llms.txthttps://mcp.getvuelo.com/llms.txt

  The short version, for any agent.

• OpenAPIhttps://mcp.getvuelo.com/agent/openapi.json

  The Agent Commerce API over plain HTTPS. No key needed to start.

• API playgroundhttps://mcp.getvuelo.com/agents/playground

  Search, book and read a trip live, with every request and answer shown. Issue your own key from your Vuelo account.

• MCPhttps://mcp.getvuelo.com/agent/mcp

  For Claude, ChatGPT and other MCP hosts.

Four calls from intent to booking

1. 1search_flights, search_hotelsPOST https://mcp.getvuelo.com/agent/v1/search/flightsLive offers, as structured fields. Offers are not bookings.
2. 2revalidate_offerPOST https://mcp.getvuelo.com/agent/v1/offers/{offer_id}/revalidateStill bookable at this price? A change is never accepted silently.
3. 3create_orderPOST https://mcp.getvuelo.com/agent/v1/ordersVuelo texts the traveller a secure link. Send an Idempotency-Key. During early access, invited partners only, with their partner key.
4. 4get_orderGET https://mcp.getvuelo.com/agent/v1/orders/{order_id}Poll until booked. The booking reference and dates arrive here.

Try it

curl -s https://mcp.getvuelo.com/agent/v1/search/hotels \
  -H 'content-type: application/json' \
  -H 'x-agent-platform: my-agent' \
  -d '{"destination":{"city":"Lisbon","country":"PT"},
       "check_in":"2027-05-14","check_out":"2027-05-18",
       "rooms":[{"adults":2}],
       "preferences":{"minimum_star_rating":4,"max_total_price":1200},
       "sort":"recommended","limit":10}'

curl -s https://mcp.getvuelo.com/agent/v1/orders \
  -H 'content-type: application/json' \
  -H 'idempotency-key: 5d3c1d6e-2f0b-4c38-9a51-2a4f6f0f1e7a' \
  -d '{"offer_id":"...","expected_total":880.28,"payment_option":"pay_in_full",
       "contact":{"mobile":"07700 900123"},
       "travellers":[{"given_name":"Jane","family_name":"Smith"}]}'

When to stop and ask the traveller

Any response with requires_user_confirmation: true says why, in confirmation_reason: price_changed, payment, credit_application, traveller_details and others. Errors say whether they can be recovered from and what to do next: SEARCH_AGAIN, REVALIDATE, ASK_USER, RETRY, REAUTHENTICATE or CONTACT_SUPPORT.

Paying, and payment plans

Show payment options exactly as Vuelo returns them, and the price in full. Where an offer has a Vuelo payment plan, show its notice word for word and nothing else about it: the plans, their cost, the eligibility check and the agreement are only ever on Vuelo's secure page. UK residents only.

Limits and keys

No key is needed, over HTTPS or A2A. Without one, each IP address gets 20 live searches an hour (then cached or sample results, marked live: false), 10 revalidations and 5 orders; over A2A, 10 find_trip requests an hour and 30 a day. Send X-Agent-Platform so we can support your platform; an unknown platform is fine. For higher limits, and to see only your own orders, ask Vuelo for a partner key and send it as a bearer token.