Repository navigation
Your Avios accounts, and British Airways reward availability, available to Claude
and any other MCP client.
uv tool install 'avios-cli[mcp]'
avios login ba # sessions come from the CLI
claude mcp add avios -- avios-mcpAdded
MCP server (avios-mcp) — six read-only tools over stdio: list_accounts,
get_balance, get_transactions, get_pending_transactions, whoami,
search_reward_flights. Closes #45.
Sessions come from avios login, so the server never performs a login itself —
that stays a deliberate human action in a terminal.
The safeguards are the interesting part:
- Read-only. Nothing books, spends, or mutates a session.
- No credentials in output. Every tool returns an explicit response model
rather than a raw API payload, so cookies, API keys andwhoami's id token
cannot leak through a field nobody thought about. - Reward search is batched and rate-limited. British Airways blocks by IP
address, so an agent exploring "what about March? what about via LGW?" could
lock you out of the site. A whole return trip goes through one batched,
single-browser-session search; the server enforces a cooldown between searches;
and a block is reported as terminal and explicitly not retryable. - MCP is an optional extra, so a plain CLI install does not pull in the SDK's
web stack. Runningavios-mcpwithout it prints the install command rather than
a traceback.
Built against MCP Python SDK 2.x.
Full changelog: https://github.com/alexechoi/avios-cli/blob/main/CHANGELOG.md