mirror of https://github.com/luxfi/bank.git synced 2026-10-30 17:02:07 +00:00

Files

T

zeekayandHanzo Dev ae60ecb30d mcp: @luxfi/bank-mcp — the agent surface over the banking API

An MCP server wrapping @luxfi/bank so an AI agent gets typed bank tools
(accounts, payments, cards, crypto, exchange, plans) over stdio. Thin
adapter: every tool is one SDK call, so contract/types/auth are the
SDK's. 22 tools; a BankError becomes an isError result carrying the
upstream status, never a dropped connection. Proven live end to end:
agent JSON-RPC -> MCP -> @luxfi/bank -> bankd -> back. Published
@luxfi/[email protected].

Co-authored-by: Hanzo Dev <[email protected]>

2026-08-22 18:19:08 -07:00

2.0 KiB

Raw Permalink Blame History

@luxfi/bank-mcp

An MCP server that gives an AI agent typed tools over the Lux banking API. It is a thin adapter over @luxfi/bank: every tool calls one SDK method, so the wire contract, types, and auth are the SDK's — this package adds no logic of its own.

Run

BANK_API_URL=https://api.sandbox.lux.financial \
BANK_TOKEN=<iam-bearer-token> \
npx @luxfi/bank-mcp

Or wire it into a client (e.g. Claude Desktop / Claude Code):

{
  "mcpServers": {
    "lux-bank": {
      "command": "npx",
      "args": ["-y", "@luxfi/bank-mcp"],
      "env": {
        "BANK_API_URL": "https://api.sandbox.lux.financial",
        "BANK_TOKEN": "<iam-bearer-token>"
      }
    }
  }
}

The token authorizes every call as one principal — run one server per user. Point BANK_API_URL at https://api.sandbox.lux.financial to explore against the seeded demo, or https://api.lux.financial for production.

Tools

Tool	Does
`bank_plans`, `bank_config`	Membership ladder; public config + partner disclosure
`bank_overview`, `bank_accounts`, `bank_transactions`	Dashboard aggregate; account list; activity
`bank_balances`, `bank_wallet`, `bank_crypto_prices`	Balances; crypto wallet; reference prices
`bank_transfer`, `bank_pay`	Book transfer between own accounts; outbound payment to a beneficiary
`bank_beneficiaries`, `bank_create_beneficiary`	List / register payment recipients
`bank_send_crypto`	On-chain send (returns a txHash)
`bank_exchange_quote`, `bank_exchange`	Quote / execute a fiat-FX or crypto conversion
`bank_issue_card`, `bank_freeze_card`, `bank_unfreeze_card`	Card issuance and controls
`bank_card_account`, `bank_create_virtual_card`, `bank_order_virtual_card`	The provider-neutral issuer card lifecycle

Amounts are integers in minor units (cents for fiat, 6-dp for crypto). Errors surface as a tool result carrying the upstream status, never a dropped connection. The interface standard is LP-3040.

2.0 KiB Raw Permalink Blame History

@luxfi/bank-mcp

Run

Tools

2.0 KiB

Raw Permalink Blame History