mercury-cli

CLI for the Mercury Banking API - manage accounts, transactions, transfers, and more. Made with api2cli.dev.

Install

npx api2cli install Melvynx/mercury-cli

This clones the repo, builds the CLI, links it to your PATH, and installs the AgentSkill to your coding agents.

Install AgentSkill only

npx skills add Melvynx/mercury-cli

Auth

mercury-cli auth set <token>
mercury-cli auth show          # masked
mercury-cli auth show --raw    # full token
mercury-cli auth test
mercury-cli auth remove

Global Flags

All commands support:

Flag	Description
--json	Output as JSON
--format <fmt>	Output format: text, json, csv, yaml
--verbose	Enable debug logging
--no-color	Disable colored output
--no-header	Omit table/csv headers (for piping)

Resources

accounts

mercury-cli accounts list [--fields <cols>]
mercury-cli accounts get <account-id>
mercury-cli accounts cards <account-id> [--fields <cols>]
mercury-cli accounts statements <account-id> [--fields <cols>]

transactions

mercury-cli transactions list <account-id> [--limit <n>] [--offset <n>] [--start <date>] [--end <date>] [--status <status>] [--search <query>] [--fields <cols>]
mercury-cli transactions all [--limit <n>] [--offset <n>] [--start <date>] [--end <date>] [--status <status>] [--search <query>] [--fields <cols>]
mercury-cli transactions get <transaction-id>

Examples:

mercury-cli transactions list acc_123 --limit 10 --start 2024-01-01 --end 2024-12-31
mercury-cli transactions all --search "Stripe" --json

transfers

mercury-cli transfers create [--account-id <id>] --recipient-id <id> --amount <amount> [--payment-method <method>] [--note <note>] [--idempotency-key <key>]

Example:

mercury-cli transfers create --account-id acc_123 --recipient-id rec_456 --amount 10000 --payment-method ach

recipients

mercury-cli recipients list [--fields <cols>]
mercury-cli recipients get <recipient-id>
mercury-cli recipients create --name <name> [--email <email>] [--payment-method <method>] [--routing-number <number>] [--account-number <number>] [--address <json>]

Example:

mercury-cli recipients create --name "Acme Corp" --payment-method ach --routing-number 123456789 --account-number 987654321

invoices

mercury-cli invoices list [--fields <cols>]
mercury-cli invoices get <invoice-id>
mercury-cli invoices create --customer-id <id> --amount <amount> [--due-date <date>] [--description <desc>] [--invoice-number <number>]

Example:

mercury-cli invoices create --customer-id cust_123 --amount 50000 --due-date 2025-01-31 --description "Consulting"

customers

mercury-cli customers list [--fields <cols>]
mercury-cli customers get <customer-id>

webhooks

mercury-cli webhooks list [--fields <cols>]
mercury-cli webhooks create --url <url> [--events <events>] [--secret <secret>]

Example:

mercury-cli webhooks create --url https://example.com/webhook --events "transaction.created,transaction.updated"

org

mercury-cli org info
mercury-cli org categories [--fields <cols>]