v0.1.0

First PyPI release of nz-akahu-mcp: an unofficial MCP server for the
Akahu open-finance API (NZ), distributed as a single
PyPI package.

What's in v0.1.0

14 tools, pure Akahu API primitives. No baked-in analytical opinions;
the LLM reasons over raw transaction data.

• accounts/: list_accounts, get_account, get_account_balance,
  get_pending_transactions, refresh_all_accounts, refresh_account
• transactions/: get_transactions, get_transaction,
  get_transactions_by_ids, get_pending_transactions,
  search_transactions, report_transaction_issue
• identity/: get_me, verify_name

Safety

• Read-only by default (AKAHU_READ_ONLY=true). Every write tool refuses
  until you flip the flag.
• Per-call consent for every write via ctx.elicit().
• Automation bypass opt-in for a small subset of idempotent, rate-limited
  writes (refresh_all_accounts, refresh_account) via
  AKAHU_AUTOMATION_BYPASS=true.

Install

claude mcp add nz-akahu \
  --scope user \
  --env AKAHU_APP_TOKEN=app_token_... \
  --env AKAHU_USER_TOKEN=user_token_... \
  -- uvx nz-akahu-mcp

Full install options (Claude Code, Claude Desktop, pip+venv) in the
README.

Requirements

• Python 3.12+
• Akahu Personal App + User token from https://my.akahu.nz/developers

Disclaimer

Unofficial integration. Not affiliated with Akahu, your bank, or any
financial institution.