Skip to content
Developers

Guides

Banking CLI

Install on macOS or Linux (arm64/x64):

Shell
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

Shell
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.