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

Machine-readable tool list (JSON)

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_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.