@magnolia-financial/banking-mcp

An MCP (Model Context Protocol) server that wraps the Magnolia banking API, letting AI agents manage crypto wallets, bank accounts, trading, fiat operations, and Lightning Network payments.

Powered by Magnolia Financial | Get started at clawbot.cash

Quick Start

npx -y @magnolia-financial/banking-mcp

Prerequisites

• Node.js 18+
• A Magnolia API key (get one at clawbot.cash)

Install

From npm:

npx -y @magnolia-financial/banking-mcp

From source:

npm install
npm run build

Configuration

Set your API key as an environment variable:

export MAGNOLIA_API_KEY=magfi_your_api_key_here

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MAGNOLIA_API_KEY | Yes | — | API key from ClawBot.cash KYC flow | | MAGNOLIA_API_URL | No | https://api.magfi.net | Magnolia API base URL |

Usage

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "magnolia": {
      "command": "npx",
      "args": ["-y", "@magnolia-financial/banking-mcp"],
      "env": {
        "MAGNOLIA_API_KEY": "magfi_your_api_key_here"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "magnolia": {
      "command": "npx",
      "args": ["-y", "@magnolia-financial/banking-mcp"],
      "env": {
        "MAGNOLIA_API_KEY": "magfi_your_api_key_here"
      }
    }
  }
}

Direct

MAGNOLIA_API_KEY=magfi_... node dist/index.js

Available Tools (30 total)

Enterprise

| Tool | Description | |------|-------------| | list_enterprises | List all enterprises accessible to this API key |

Crypto Wallets

| Tool | Description | |------|-------------| | list_wallets | List wallets for a cryptocurrency (btc, eth, tbtc, teth) | | get_wallet | Get wallet details by coin and wallet ID | | generate_address | Generate a new receive address for a wallet | | list_addresses | List all addresses for a wallet | | get_address_balances | Get address balances for a wallet | | send_crypto | Send a cryptocurrency transaction | | get_wallet_transfer | Get transfer status for a wallet | | list_wallet_transfers | List all transfers for a wallet |

Bank Accounts

| Tool | Description | |------|-------------| | list_bank_accounts | List linked bank accounts (filterable by type, state, enterprise) | | get_bank_account | Get bank account details by ID | | add_bank_account | Add a new bank account (wire, ACH, or SEPA) | | delete_bank_account | Delete a bank account | | get_deposit_info | Get deposit/wiring instructions |

Trading

| Tool | Description | |------|-------------| | get_trading_balances | Get balances for a trading account | | get_trading_products | List available trading products/pairs | | place_order | Place a trading order (market, limit, TWAP, steady pace) | | list_orders | List orders for a trading account | | get_order | Get order details by ID | | cancel_order | Cancel a pending order |

Fiat/ACH

| Tool | Description | |------|-------------| | get_ach_agreement | Get the ACH debit agreement | | accept_ach_agreement | Accept the ACH debit agreement for a bank account | | create_ach_debit | Create an ACH debit to pull funds from a bank account |

Lightning Network

| Tool | Description | |------|-------------| | create_lightning_invoice | Create a Lightning invoice to receive payment | | get_lightning_invoice | Check Lightning invoice status | | pay_lightning_invoice | Pay a Lightning invoice | | list_lightning_transactions | List Lightning transactions for a wallet |

Utility

| Tool | Description | |------|-------------| | lookup_routing_number | Look up bank info by ACH or wire routing number |

Auth

| Tool | Description | |------|-------------| | list_api_keys | List all API keys for the authenticated user | | delete_api_key | Delete an API key by ID |

Example Interactions

Once configured, you can ask your AI agent things like:

• "List my BTC wallets"
• "Generate a new receive address for my ETH wallet"
• "Send 0.001 BTC to address bc1q..."
• "Show my bank accounts"
• "Add my Chase checking account for ACH"
• "Place a market order to buy $100 of BTC"
• "What are my trading balances?"
• "Create a Lightning invoice for 10000 sats"
• "Look up routing number 021000021"

Testing

npm test              # Run all tests
npm run test:watch    # Watch mode
npm run test:integration  # Integration tests only

118 tests across 5 suites covering auth, API paths, client methods, edge cases, and backward compatibility.

Development

npm run dev    # Watch mode (recompiles on change)
npm run build  # One-time build
npm start      # Run the compiled server

License

MIT