servers / aa-mcp-server
aa-mcp-server
communityunknownpythonunknownhealthy
MCP server for read-only American Airlines AAdvantage account access — direct API calls via session cookies extracted from a Chromium login
01Tools · 11
How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.
| Tool | Risk | Side effects | Approval |
|---|---|---|---|
| get_notifications Account notifications panel.
Args:
account: Account name (optional, uses default).
| read | false | unknown |
| get_upcoming_trips Upcoming flight reservations with record locators.
Args:
account: Account name (optional, uses default).
| read | false | unknown |
| get_loyalty_points_progress Elite status progress — Loyalty Points YTD + last-year EQDs/EQMs/EQSs + tier thresholds.
Args:
account: Account name (optional, uses default).
| read | false | unknown |
| get_flight_credits Flight credits (single-passenger ticket credits from cancelled flights).
Args:
locale: Locale code (default en_US).
account: Account name (optional, uses default).
| read | false | unknown |
| get_mile_activity AAdvantage mile / loyalty-point transaction history.
Returns activity cards with date, type (Flight/Bank/Promo/Misc), miles earned/used,
loyalty points, partner code, and transaction description.
Args:
from_date: YYYY-MM-DD inclusive (default: 180 days ago).
to_date: YYYY-MM-DD inclusive (default: today).
starting_index: 0-based offset for pagination.
page_size: Max records (server caps ~50).
search_string: Free-text filter on transaction description.
sort_direction: "asc" or "desc" by activity_date.
account: Account name (optional, uses default).
| read | false | unknown |
| get_account_summary Member info: name, AAdvantage #, mile balance, status, cobranded card, business memberships.
Args:
account: Account name (optional, uses default).
| read | false | unknown |
| get_profile_details Detailed profile: DOB, partners, sales city, mile expiration, million-miler stats.
Args:
account: Account name (optional, uses default).
| read | false | unknown |
| check_auth_status Check the saved AA session for an account — token expiry, AAdvantage #, cookie count.
Args:
account: Account name (optional, uses default).
| read | false | unknown |
| get_trip_credits Trip credits (multi-passenger / itinerary-level credits).
Args:
locale: Locale code (default en_US).
account: Account name (optional, uses default).
| read | false | unknown |
| get_partner_offers Partner offers / promotions on the dashboard.
Args:
account: Account name (optional, uses default).
| read | false | unknown |
| save_session_from_browser Pull cookies from a logged-in Chromium (started by aa-auth-browser) and save them.
Workflow:
1. Run `aa-auth-browser <account>` to launch Chromium with --remote-debugging-port.
2. Log into aa.com in that browser.
3. Call this tool — it connects to the debug port via CDP and saves all aa.com cookies.
Args:
account: Account name to associate with the saved cookies. Default: "default".
port: Chromium remote-debugging port as a string. Empty/omitted uses the default
(9224, matches aa-auth-browser). Pass as string to avoid MCP type-coercion
issues with some clients.
| unknown | unknown | unknown |
02Install & source
uvx aa-mcp-server
uvxpip install aa-mcp-server
pip- repohttps://github.com/thehesiod/aa-mcp
- packagehttps://pypi.org/project/aa-mcp-server
- homepagehttps://github.com/thehesiod/aa-mcp
- licenseMIT
- adoption0 stars · 0 forks
05Provenance & freshness
sourcesPyPI [p4]
last_checked2026-08-16 08:50Z
next_check2026-08-18 08:50Z
cadenceevery 48h
verifiedmetadata:passed handshake:failed metadata:passed metadata:passed metadata:passed metadata:passed handshake:failed metadata:passed metadata:passed metadata:passed
index_statusindex — 8 unique facts >= 5
06Badge
Add the “as seen on MCPExplorer” badge to your README. 
[](https://mcpexplorer.com/servers/aa-mcp-server)
Next step
This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.
Explore loadouts →