Guides
Banking CLI
Install on macOS or Linux (arm64/x64):
curl -fsS https://bankmcp.app/install.sh | sh
# Or download and inspect first, then:
sh install.sh --version 0.1.0 --dir "$HOME/.local/bin"
A standalone binary built with Effect CLI. No Node.js/Bun installation or sudo required.
Add ~/.local/bin to PATH. Releases and SHA-256 checksums are served from
https://downloads.bankmcp.app/cli/v0.1.0/SHA256SUMS. The installer verifies the checksum,
runs the binary's version check, then atomically replaces an existing installation.
Authentication
Create an API key in Banking Account → API keys or via MCP create_api_key.
banking auth login prompts without echoing and stores a verified key in the OS
credential store. --token-stdin accepts a key from a secret manager's pipe.
Headless systems can set BANKING_API_KEY; it overrides saved credentials.
There is no plaintext fallback. Linux persistence requires a working Secret Service.
Keys are stored per API origin; an alternate --api-url never inherits a saved production key.
An explicitly supplied environment key is sent to the selected API origin.
banking auth status returns effective permissions, resources and expiry.
banking auth logout removes only the local credential. Revoke in the portal to
invalidate the key. The CLI cannot create keys or authorize portal sessions.
Do not put keys into command arguments, shell history or committed files.
Commands
banking banks list
banking accounts list --bank BANK_ID --include-closed
banking balances get --account ACCOUNT_ID
banking transactions list --account ACCOUNT_ID --from 2026-01-01 --to 2026-09-23 --limit 100
banking transactions list --account ACCOUNT_ID --all --format ndjson > pages.ndjson
banking institutions list --query Example --country DE
banking institutions get "Example Bank"
banking banks connect "Example Bank" --country DE --psu-type personal
banking banks refresh BANK_ID
banking banks import-history BANK_ID
banking banks disconnect BANK_ID --yes
banking merchants resolve
banking merchants correct --name "EXAMPLE COFFEE" --query example.com --brand "Example Coffee" --category coffee
banking docs
banking upgrade
banking upgrade --version 0.1.0
banking --completions zsh
Open returned connection/consent URLs yourself. Reads use stored data. Background
actions report their current status; starting a refresh is not completion.
Disconnect confirms interactively or requires --yes in automation.
All API permission/resource restrictions and customer eligibility apply unchanged.
Output, pagination and errors
TTY defaults to table output; redirected output defaults to JSON. Override with
--json or --format table|json|ndjson. JSON preserves the complete API envelope.
--all --format ndjson follows cursors and emits one full page per line. Keep the
freshness, coverage, complete flag, warnings and decimal money strings. Don't sum
mixed currencies. A failed or looping export exits nonzero even after earlier pages.
Without --all, use --cursor and retain the same filters for continuation.
Results: stdout. Diagnostics: stderr. Exit codes: 0 success; 1 unexpected failure;
2 invalid input; 3 authentication; 4 permission; 5 not found; 6 conflict; 7 rate
limit; 8 network/service/invalid response. Error JSON contains code, error
and optional action. GET requests retry at most twice within the request timeout,
respecting Retry-After. Mutations are never automatically retried.
Global flags: --api-url https://api.bankmcp.app, --timeout 20 (1–300 seconds),
--format, --json, --help, --version. The API URL is an HTTPS origin without
paths or embedded credentials; localhost HTTP is allowed for development.
Project dotenv files and bunfig preloads are not loaded by the binary.
Updates are explicit; no background telemetry or auto-updater. Install a pinned
previous version to roll back. To uninstall, run banking auth logout, remove the
binary and any shell completion entry. Windows support is deferred.