thehesiod avatar

Aa

thehesiod/aa-mcp

Gives Claude read-only access to your American Airlines AAdvantage account by calling aa.com's internal JSON APIs directly. Exposes mile balances, Loyalty Points progress, transaction history, upcoming trips, reservation details, flight-change pricing with fare deltas, and travel credits. Uses curl_cffi with Chrome TLS fingerprinting to satisfy Akamai's bot detection. Auth requires a one-time Chromium session extraction since headless login won't work. Supports multiple accounts via an optional parameter on each tool. Useful when you want Claude to check your AA status, analyze earning history, or explore rebooking options without opening a browser.

tools
13
transport
STDIO
last updated
May 4, 2026

Tools

13 tools

Public tool metadata for what this MCP can expose to an agent.

get_account_summaryName, AAdvantage #, mile balance, status, cobranded card, business memberships

Name, AAdvantage #, mile balance, status, cobranded card, business memberships

No parameter schema in public metadata yet.

get_loyalty_points_progressLP YTD, last-year totals, tier thresholds, next-status delta

LP YTD, last-year totals, tier thresholds, next-status delta

No parameter schema in public metadata yet.

get_profile_detailsDOB, partners list, sales city, mile expiration, million-miler stats

DOB, partners list, sales city, mile expiration, million-miler stats

No parameter schema in public metadata yet.

get_mile_activityMile/LP transaction history (date range, paginated, searchable)

Mile/LP transaction history (date range, paginated, searchable)

No parameter schema in public metadata yet.

get_upcoming_tripsReservations with record locators

Reservations with record locators

No parameter schema in public metadata yet.

get_reservation_by_locatorFull reservation: segments, passengers, tickets, costs, change/cancel eligibility (requires lead-passenger name)

Full reservation: segments, passengers, tickets, costs, change/cancel eligibility (requires lead-passenger name)

No parameter schema in public metadata yet.

search_change_flightsAlternative flights for a reservation with a ±6-day price carousel, per-cabin pricing (netPrice = delta vs paid). Accepts origin/destination/date changes; pricing is total for all pax (no per-passenger split)

Alternative flights for a reservation with a ±6-day price carousel, per-cabin pricing (netPrice = delta vs paid). Accepts origin/destination/date changes; pricing is total for all pax (no per-passenger split)

No parameter schema in public metadata yet.

get_flight_creditsSingle-passenger ticket credits

Single-passenger ticket credits

No parameter schema in public metadata yet.

get_trip_creditsMulti-passenger / itinerary credits

Multi-passenger / itinerary credits

No parameter schema in public metadata yet.

get_partner_offersDashboard partner promotions

Dashboard partner promotions

No parameter schema in public metadata yet.

get_notificationsAccount notifications

Account notifications

No parameter schema in public metadata yet.

check_auth_statusSaved-session info: AA #, token expiry, cookie count

Saved-session info: AA #, token expiry, cookie count

No parameter schema in public metadata yet.

save_session_from_browserPulls cookies from a logged-in Chromium and persists them

Pulls cookies from a logged-in Chromium and persists them

No parameter schema in public metadata yet.

Sponsors

Readme

aa-mcp-server

An MCP server that gives Claude (or any MCP-compatible LLM) read-only access to your American Airlines AAdvantage account — mile balance, Loyalty Points progress, transaction history, upcoming trips, travel credits, and partner offers.

This is not a browser-automation wrapper. The server discovers and calls aa.com's underlying JSON APIs directly using session cookies extracted from a Chromium login. All HTTP traffic uses curl_cffi with Chrome TLS impersonation to satisfy aa.com's Akamai Bot Manager.

Tools


View the full README on GitHub

Details

Repository
github.com/thehesiod/aa-mcp
Package
aa-mcp-server
Transport
STDIO
Registry
MCP registry, active

More from thehesiod