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/aaEvery 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/mcpSet it up in your clientBoth 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
Name Type Required originstringThe country flown FROM, an ISO-3166 alpha-2 code ("US", "GB") or a country name in any capitalisation.Yes destinationstringThe country flown TO, same forms.Yes Returns
aaBaggageAllowanceinterface 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/getBaggageAllowanceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aa.getBaggageAllowance({ origin: "US", destination: "GB" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aa.getBaggageAllowance({"origin": "US", "destination": "GB"}))curl -X POST https://api.bowmark.ai/v1/sites/aa/getBaggageAllowance \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"origin":"US","destination":"GB"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required arg0{ date, flightNumber, origin, destination }Yes Returns
aaFlightStatusResultinterface 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/getFlightStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aa.getFlightStatus({ flightNumber: "100", date: { $daysFromNow: 1 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aa.getFlightStatus({"flightNumber": "100", "date": {"$daysFromNow": 1}}))curl -X POST https://api.bowmark.ai/v1/sites/aa/getFlightStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"flightNumber":"100","date":{"$daysFromNow":1}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required recordLocatorstringExactly six letters, American's own record-locator format.Yes lastNamestringThe passenger's last name, exactly as it appears on the reservation.Yes Returns
aaReservationinterface 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/retrieveBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aa.retrieveBooking({ recordLocator: "<recordLocator>", lastName: "<lastName>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aa.retrieveBooking({ "recordLocator": "<recordLocator>", "lastName": "<lastName>" }))curl -X POST https://api.bowmark.ai/v1/sites/aa/retrieveBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"recordLocator":"<recordLocator>","lastName":"<lastName>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aa.retrieveBooking({ recordLocator: "<recordLocator>", lastName: "<lastName>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/aa/<function> - OpenAPI
/v1/sites/aa/openapi.json