American Airlines MCP server for AI agents

Let Claude, ChatGPT or your own agent read American Airlines: 3 typed functions through one MCP server. No American Airlines API key needed.

Site
aa.com
Functions
3
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just American Airlines

An MCP server for American Airlines alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/aa
Every site

One MCP server for American Airlines and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 3
  • getBaggageAllowanceAmerican's published baggage allowance and fees for a ROUTE, keyed on the two COUNTRIES flown between: which region of its own fee table the trip…

    Arguments

    NameTypeRequired
    originstring
    The country flown FROM, an ISO-3166 alpha-2 code ("US", "GB") or a country name in any capitalisation.
    Yes
    destinationstring
    The country flown TO, same forms.
    Yes

    Returns aaBaggageAllowance

    interface aaBaggageAllowance {
      origin: aaBaggageEndpoint;
      destination: aaBaggageEndpoint;
      /** Which row of American's fee table this trip landed on, and how. */
      feeRegion: {
        label: string;
        matchedOn: "country" | "region" | "region-members";
        matchedEndpoint: "origin" | "destination";
      };
      checkedBagFees: aaCheckedBagFee[];
      checkedBagLimits: aaCheckedBagLimits;
      carryOn: aaCarryOnAllowance;
      freeCheckedBags: aaFreeCheckedBagRule[];
      /** Null when American's own bag-count rule names neither end of the trip. */
      maxCheckedBags: number | null;
      maxCheckedBagsRules: aaMaxCheckedBagsRule[];
      footnotes: string[];
      sources: string[];
    }
    
    interface aaBaggageEndpoint {
      input: string;
      countryCode: string;
      countryName: string;
      /** Null for a country American files under no bag region, Mexico is the live
       * case, and the fee table names it directly instead. */
      region: string | null;
    }
    
    interface aaCheckedBagFee {
      /** "1", "2", "3", "4+". */
      bag: string;
      /** The cell verbatim, e.g. "$0 / $85*". */
      display: string;
      /** Every dollar figure in the cell, in the order printed. */
      amountsUsd: number[];
      footnoteMarkers: string[];
    }
    
    interface aaCheckedBagLimits {
      maxLinearInches: number | null;
      maxLinearCm: number | null;
      maxWeightPounds: number | null;
      maxWeightKilos: number | null;
      notes: string[];
    }
    
    interface aaCarryOnAllowance {
      carryOnBags: number;
      personalItems: number;
      carryOnMaxInches: number[];
      carryOnMaxCm: number[];
      personalItemMaxInches: number[];
      personalItemMaxCm: number[];
    }
    
    interface aaFreeCheckedBagRule {
      bags: number;
      qualifiers: string[];
    }
    
    interface aaMaxCheckedBagsRule {
      count: number;
      applies: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aa/getBaggageAllowance

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aa.getBaggageAllowance({ origin: "US", destination: "GB" });
  • getFlightStatusLooks up an American Airlines flight's real-time status by flight number and date, or every American NONSTOP on a route and date.

    Arguments

    NameTypeRequired
    arg0{ date, flightNumber, origin, destination }Yes

    Returns aaFlightStatusResult

    interface aaFlight {
      flightNumber: string;
      airlineCode: string;
      flightStatus: string | null;
      flightStatusKey: string | null;
      flightStatusColor: string | null;
      canceled: boolean;
      diverted: boolean;
      inFlight: boolean;
      landed: boolean;
      departure: aaAirportInfo;
      arrival: aaAirportInfo;
      equipment: aaEquipment;
      disruptionMessage: string | null;
      codeShare: boolean;
      operatedBy: string | null;
      marketingCarrier: string | null;
      wifiAvailable: boolean | null;
      powerPortAvailable: boolean | null;
    }
    
    interface aaAirportInfo {
      airportCode: string;
      cityName: string | null;
      gate: string | null;
      terminal: string | null;
      state: string | null;
      country: string | null;
      baggageClaim: string | null;
      scheduledTime: string | null;
      estimatedTime: string | null;
      actualTime: string | null;
      scheduledBoardingTime: string | null;
      estimatedBoardingTime: string | null;
    }
    
    interface aaEquipment {
      tailNumber: string | null;
      equipmentCode: string | null;
      iataName: string | null;
      displayName: string | null;
    }
    
    interface aaFlightStatusResult {
      date: string;
      flightNumber: string | null;
      origin: string | null;
      destination: string | null;
      flights: aaFlight[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aa/getFlightStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aa.getFlightStatus({ flightNumber: "100", date: { $daysFromNow: 1 } });
  • retrieveBookingReads an existing American Airlines reservation by its six-letter record locator (PNR) and the passenger's last name.

    Arguments

    NameTypeRequired
    recordLocatorstring
    Exactly six letters, American's own record-locator format.
    Yes
    lastNamestring
    The passenger's last name, exactly as it appears on the reservation.
    Yes

    Returns aaReservation

    interface aaReservation {
      recordLocator: string;
      status: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      bookingTime: string | null;
      passengers: aaReservationPassenger[];
      itinerary: aaReservationSlice[];
    }
    
    interface aaReservationPassenger {
      firstName: string | null;
      lastName: string | null;
      passengerID: string | null;
      paxType: string | null;
      loyaltyNumber: string | null;
      ticketNumbers: string[];
    }
    
    interface aaReservationSlice {
      segments: aaReservationSegment[];
    }
    
    interface aaReservationSegment {
      flightNumber: string | null;
      marketingCarrierCode: string | null;
      operatingCarrierCode: string | null;
      cabinType: string | null;  // the site's own labels, read the values off a result, never guess one from prose
      bookingCode: string | null;
      departureDateTime: string | null;
      legs: aaReservationLeg[];
    }
    
    interface aaReservationLeg {
      originAirportCode: string | null;
      originCity: string | null;
      destinationAirportCode: string | null;
      destinationCity: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aa/retrieveBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aa.retrieveBooking({ recordLocator: "<recordLocator>", lastName: "<lastName>" });

Use it from code