DEVELOPERS
GoFly for developers and AI agents
GoFly offers a Model Context Protocol server. Here is how to connect, how sign-in and approval work, and every tool it offers.
Rolling out. The server address below does not accept sign-ins yet. This page describes it as it works at launch.
Connect
- Endpoint
https://mcp.gofly.travel/mcp- Transport
- Streamable HTTP
- Tools
- 22
- Manifest version
- 0.1.0
Sign-in and approval
Each person signs in with their own GoFly account over OAuth, and a connected assistant sees only what that account can see.
Tools marked two-step approval return the exact terms first and act only after the traveler approves them in the GoFly view, so an assistant cannot pay for or confirm a booking by itself.
Tools
get_travel_capabilities Check what GoFly can do right now
Reads
Read whether GoFly is in test or live mode and which actions are enabled: booking, holds, exchanges, extras, cancellations, passenger updates and airline changes. Call this before promising the traveler an action.
No input.
get_account_status Check traveler enrollment
Reads
Read whether the signed-in traveler has finished GoFly enrollment. Flight tools need the phase to be ready; any other phase must be completed in the GoFly app.
No input.
search_airports Find airports
Reads
Find airports in GoFly's directory by city, airport name or code. Returns IATA codes for search_flights; whether flights exist is known only from a search.
query(required)- string
search_flights Search flights
Reads
Search live airline offers for a one-way, round-trip or multi-city journey. Returns the cheapest offers with price, times, stops, carriers and expiry. Offers expire; call get_flight_offer to revalidate one before booking. Searching never charges or reserves anything.
slices(required)- array of object. One slice is one-way. Two slices that reverse each other are a round trip. Anything else is multi-city. Dates must be in order and each slice must change airport
maxConnections- integer. Most connections on any flight; 0 means nonstop. Default 2
adults- integer. At most 9 travelers in total. Default 1
childAges- array of integer. Age of each child on the travel date. Default []
lapInfantAges- array of integer. Age of each infant on an adult lap; one adult per infant. Default []
cabin- string. Default "economy"
currency- string. Default "USD"
maxOffers- integer. How many of the cheapest offers to return. Default 10
waitSeconds- integer. How long to wait for airlines to answer before returning partial results. Default 20
get_flight_search Refresh flight search
Reads
Read a flight search again by searchId while its status is starting, partial or polling: more offers may have arrived. Expired offers are dropped. Once the status is complete, expired or failed, start a new search instead.
id(required)- string (uuid). searchId returned by search_flights
maxOffers- integer. Default 10
get_flight_offer Revalidate a flight offer
Reads
Revalidate one offer and read its current price, fare brand, change and refund rules, baggage allowance, hold option, document requirement and purchasable extras. Always call this before prepare_booking: the price can change.
searchId(required)- string (uuid)
offerId(required)- string (uuid)
prepare_booking Prepare a booking for review
Changes
Create a checkout for one offer with traveler details and chosen extras. This does not charge and does not book. It returns the checkout with its exact total, revision and expiry for the traveler to review. Passenger names must match travel documents. Each call without an idempotencyKey creates a new checkout.
searchId(required)- string (uuid)
offerId(required)- string (uuid)
bookingType- string. Default "instant"
passengers(required)- array of object
services- array of object. Default []
idempotencyKey- string (uuid). Idempotency key. Omit on the first call; a key is generated and returned. Reuse the returned key for every retry of the same request. Never invent a new key for the same purchase
confirm_booking Confirm and pay for a booking
Irreversible with two-step approval
Authorize payment and booking for a reviewed checkout, using its id, revision, exact total and the terms digest from get_booking (terms.digest), which binds the itinerary, price, conditions and the GoFly terms version the traveler saw. If the outcome is ever unknown, do not retry: call get_booking. Two steps: the first call changes nothing and returns the exact terms for the traveler to approve; the action runs only after that approval.
id(required)- string (uuid)
revision(required)- integer
acceptedTotal(required)- object
acceptedTerms(required)- string
idempotencyKey- string (uuid). Idempotency key. Omit on the first call; a key is generated and returned. Reuse the returned key for every retry of the same request. Never invent a new key for the same purchase
confirmation- string. Approval digest issued together with the terms. Omit it unless you were given one for exactly these arguments
list_bookings List bookings
Reads
List the traveler's checkouts and reservations with status, total, payment and ticketing state.
No input.
get_booking Read a booking
Reads
Read one booking: status, itinerary, payment, refund, reservation and ticketing state. This is the way to reconcile after an uncertain result.
id(required)- string (uuid)
get_tickets Read issued tickets
Reads
Read e-ticket numbers and the ticketed itinerary for a paid, issued booking.
id(required)- string (uuid)
get_booking_options See what can be changed on a booking
Reads
Read what the traveler can still do with a booking: cancel, exchange, pay a hold, buy extras or accept an airline schedule change, plus any operations already in progress.
id(required)- string (uuid)
request_booking_change Request a booking change quote
Changes
Ask for a quote to cancel and refund, exchange to another date or cabin, pay a held reservation, add extras, update passenger contact details or accept an airline change. This only prepares a quote; nothing changes until confirm_booking_change.
id(required)- string (uuid)
intent(required)- object
idempotencyKey- string (uuid). Idempotency key. Omit on the first call; a key is generated and returned. Reuse the returned key for every retry of the same request. Never invent a new key for the same purchase
get_booking_change Read a booking change
Reads
Read a change operation: its status, quote or options, charge, penalty, refund amount and refund destination.
id(required)- string (uuid)
select_booking_change_option Choose an exchange option
Changes
Choose one unexpired exchange option so its quote can be reviewed. Does not charge.
id(required)- string (uuid)
option(required)- string (uuid)
revision(required)- integer
idempotencyKey- string (uuid). Idempotency key. Omit on the first call; a key is generated and returned. Reuse the returned key for every retry of the same request. Never invent a new key for the same purchase
confirm_booking_change Confirm a booking change
Irreversible with two-step approval
Authorize a reviewed change quote including charges, penalties and the refund destination. Two steps: the first call changes nothing and returns the exact terms for the traveler to approve; the action runs only after that approval.
id(required)- string (uuid)
revision(required)- integer
acceptedTotal(required)- object
idempotencyKey- string (uuid). Idempotency key. Omit on the first call; a key is generated and returned. Reuse the returned key for every retry of the same request. Never invent a new key for the same purchase
confirmation- string. Approval digest issued together with the terms. Omit it unless you were given one for exactly these arguments
abandon_booking_change Abandon a booking change
Irreversible with two-step approval
Drop an unconfirmed change request. Two steps: the first call changes nothing and returns the exact terms for the traveler to approve; the action runs only after that approval.
id(required)- string (uuid)
idempotencyKey- string (uuid). Idempotency key. Omit on the first call; a key is generated and returned. Reuse the returned key for every retry of the same request. Never invent a new key for the same purchase
confirmation- string. Approval digest issued together with the terms. Omit it unless you were given one for exactly these arguments
list_support_cases List support cases
Reads
List the traveler's GoFly support cases.
No input.
get_support_case Read a support case
Reads
Read one support case and its messages between the traveler and GoFly operators.
id(required)- string (uuid)
open_support_case Open a support case
Changes with two-step approval
Open a GoFly support case for a booking when something cannot be completed here: unsupported request, unknown outcome, payment discrepancy, refund failure or passenger update. Two steps: the first call changes nothing and returns the exact terms for the traveler to approve; the action runs only after that approval.
id(required)- string (uuid)
reason(required)- string
message(required)- string
idempotencyKey- string (uuid). Idempotency key. Omit on the first call; a key is generated and returned. Reuse the returned key for every retry of the same request. Never invent a new key for the same purchase
confirmation- string. Approval digest issued together with the terms. Omit it unless you were given one for exactly these arguments
reply_support_case Reply to a support case
Changes with two-step approval
Send the traveler's reply on an open support case. Two steps: the first call changes nothing and returns the exact terms for the traveler to approve; the action runs only after that approval.
id(required)- string (uuid)
message(required)- string
idempotencyKey- string (uuid). Idempotency key. Omit on the first call; a key is generated and returned. Reuse the returned key for every retry of the same request. Never invent a new key for the same purchase
confirmation- string. Approval digest issued together with the terms. Omit it unless you were given one for exactly these arguments
list_notifications List travel alerts
Reads
Read ticket, schedule change, hold deadline, refund and support alerts for the traveler.
cursor- string
More ways in
Set-up steps for ChatGPT, Claude and other assistants are on the assistants page. The GoFly CLI, for scripts and coding agents, is listed on the downloads page.

