@striderlabs/mcp-american

MCP server for American Airlines — let AI agents search flights, manage bookings, check in, retrieve boarding passes, and access AAdvantage rewards on aa.com via Playwright browser automation.

Built by Strider Labs.

Features

• Flight Search — Search AA flights by origin, destination, dates, and cabin class
• Flight Details — Get connection info, aircraft type, baggage policy, and fare rules
• Flight Selection — Select outbound and return flights into a booking session
• Seat Maps — View available seats including Main Cabin Extra, Preferred, and First Class
• Seat Selection — Choose specific seats by seat number
• Baggage — Add checked bags to a booking
• Checkout — Complete bookings with a confirmation gate
• Reservations — Look up existing reservations by record locator
• Modify Trips — Initiate flight changes on existing bookings
• Cancellations — Cancel reservations with a confirmation gate
• Check-In — Online check-in starting 24 hours before departure
• Boarding Passes — Retrieve digital boarding passes after check-in
• AAdvantage — Check miles balance, elite status, and earning milestones
• Upgrades — Request upgrades using miles, systemwide certificates, or elite status

Installation

npm install -g @striderlabs/mcp-american
npx playwright install chromium

Or run directly with npx:

npx @striderlabs/mcp-american

Claude Desktop Setup

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "american": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-american"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Authentication

This server uses browser automation and stores session cookies locally. To authenticate:

1. Call the login tool — it opens aa.com in a browser window
2. Log in manually with your AAdvantage credentials
3. Call status to verify and save the session

Sessions are saved to ~/.striderlabs/american/ and reused across invocations. You typically only need to log in once until the session expires.

Tools

| Tool | Description | |------|-------------| | status | Check login status and session info | | login | Open aa.com for manual login | | logout | Clear saved session and cookies | | search_flights | Search AA flights by route, date, cabin | | get_flight_details | Get detailed info on a search result | | select_flight | Choose outbound/return flight for booking | | get_seat_map | View available seats and fees | | select_seats | Choose seats by seat number | | add_bags | Add checked baggage | | checkout | Complete booking (requires confirm: true) | | get_reservation | Look up reservation by record locator | | modify_trip | Change flights on existing reservation | | cancel_trip | Cancel reservation (requires confirm: true) | | check_in | Online check-in (opens 24h before departure) | | get_boarding_pass | Retrieve digital boarding passes | | get_aadvantage | Check miles, elite status, milestones | | upgrade_request | Request upgrade using miles or elite status |

Example Workflow

User: Search for flights from DFW to JFK next Friday

Agent:
1. search_flights { origin: "DFW", destination: "JFK", departureDate: "2025-07-11" }
2. get_flight_details { flightId: "0" }
3. select_flight { outboundFlightId: "0" }
4. get_seat_map {}
5. select_seats { seats: ["14A"] }
6. add_bags { bags: 1 }
7. checkout {}  → preview
8. checkout { confirm: true }  → booking confirmed

Safety Gates

Destructive or financial actions require explicit confirmation:

• checkout — pass confirm: true only after user confirms the purchase
• cancel_trip — pass confirm: true only after user confirms the cancellation

Without confirm: true, these tools return a preview instead of taking action.

Environment Variables

Optional — credentials can be provided via environment variables for automated workflows:

| Variable | Description | |----------|-------------| | AA_USERNAME | AAdvantage number or email | | AA_PASSWORD | Account password |

When set, the server will attempt auto-login on first use.

Session Storage

Cookies and session info are stored at:

~/.striderlabs/american/
├── cookies.json    # Browser session cookies
└── session.json    # Account info cache

To reset authentication: call logout or delete this directory.

Development

git clone https://github.com/markswendsen-code/mcp-american
cd mcp-american
npm install
npx playwright install chromium
npm run build
npm start

License

MIT — Strider Labs