Skip to content

avios-cli v0.6.0 — MCP server for AI agents

Latest

Choose a tag to compare

@alexechoi alexechoi released this 11 Aug 12:36
efa9632

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-mcp
// Claude Desktop: claude_desktop_config.json
{ "mcpServers": { "avios": { "command": "avios-mcp" } } }

Added

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 and whoami'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. Running avios-mcp without 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