@bank-mcp/server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bank-mcp contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,564 @@
+# 🏦 bank-mcp
+
+<p align="center">
+  <img src="bank-mcp.png" alt="bank-mcp — Banking data for AI assistants" width="700">
+</p>
+
+**Give your AI assistant secure, read-only access to your bank accounts.**
+
+[![npm version](https://img.shields.io/npm/v/@bank-mcp/server.svg)](https://www.npmjs.com/package/@bank-mcp/server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/elcukro/bank-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/elcukro/bank-mcp/actions/workflows/ci.yml)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
+
+---
+
+Most people manage their finances by logging into bank portals, downloading CSVs, and building spreadsheets. bank-mcp eliminates that friction by letting your AI assistant query your bank accounts directly — balances, transactions, spending breakdowns — through natural conversation. It connects to real bank APIs via the [Model Context Protocol](https://modelcontextprotocol.io) so any MCP-compatible client (Claude Code, Claude Desktop, and others) can understand your finances.
+
+- **5 providers, 15,000+ institutions** — US and European banks covered
+- **Read-only by design** — no write access, no transfers, no modifications
+- **Works with any MCP client** — Claude Code, Claude Desktop, Cursor, and more
+- **Pluggable architecture** — add your own provider in under 100 lines
+
+## Table of Contents
+
+- [Supported Providers](#supported-providers)
+- [Quick Start](#quick-start)
+- [Client Setup](#client-setup)
+- [Available Tools](#available-tools)
+- [Architecture](#architecture)
+- [Provider Setup Guides](#provider-setup-guides)
+- [Caching](#caching)
+- [Multiple Connections](#multiple-connections)
+- [Security](#security)
+- [Adding a New Provider](#adding-a-new-provider)
+- [Troubleshooting](#troubleshooting)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Supported Providers
+
+| Provider | Region | Institutions | Auth Method | Setup Difficulty |
+|----------|--------|-------------|-------------|-----------------|
+| **[Enable Banking](https://enablebanking.com)** | Europe | 2,000+ | RSA key + session | Medium |
+| **[Teller](https://teller.io)** | US | 7,000+ | mTLS certificate | Medium |
+| **[Plaid](https://plaid.com)** | US / CA / EU | 12,000+ | Client ID + secret | Easy |
+| **[Tink](https://tink.com)** | Europe | 3,400+ | OAuth2 token | Easy |
+| **Mock** | Demo | — | None | Instant |
+
+### US Banks
+
+Supported through Plaid and Teller — covering the top 20 US institutions and thousands more:
+
+JPMorgan Chase · Bank of America · Wells Fargo · Citibank · Capital One · U.S. Bank · PNC · Truist · Goldman Sachs · TD Bank · Citizens · Fifth Third · M&T Bank · Huntington · KeyBank · Ally · Regions · BMO · American Express · USAA
+
+### European Banks
+
+Supported through Enable Banking and Tink — covering major banks across the EU and UK:
+
+HSBC · BNP Paribas · Deutsche Bank · ING · Crédit Agricole · Santander · Société Générale · UniCredit · Intesa Sanpaolo · Barclays · Lloyds · BBVA · CaixaBank · Commerzbank · Rabobank · ABN AMRO · Swedbank · Handelsbanken · Nordea · PKO Bank Polski
+
+## Quick Start
+
+### 1. Configure a bank connection
+
+```bash
+npx @bank-mcp/server init
+```
+
+The interactive wizard walks you through selecting a provider and entering credentials. It validates your connection by fetching accounts before saving.
+
+### 2. Add to your MCP client
+
+Add bank-mcp to your AI tool's MCP configuration. Here's the most common setup:
+
+**Claude Code** (`.mcp.json` in your project root or `~/.claude/.mcp.json` globally):
+
+```json
+{
+  "mcpServers": {
+    "bank": {
+      "command": "npx",
+      "args": ["@bank-mcp/server"]
+    }
+  }
+}
+```
+
+> **Using a different tool?** See [Client Setup](#client-setup) for Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI, Gemini CLI, and Zed.
+
+### 3. Try it
+
+Ask your AI assistant about your finances in natural language:
+
+```
+"What's my checking account balance?"
+"Show my spending by category this month"
+"Find all Amazon purchases over $50"
+"Compare my spending this month vs last month"
+```
+
+### Demo Mode
+
+Don't have bank credentials yet? Start with realistic fake data:
+
+```bash
+npx @bank-mcp/server --mock
+```
+
+This launches with a mock provider that generates deterministic sample accounts and transactions — perfect for testing your setup or building on top of bank-mcp before connecting real accounts.
+
+## Client Setup
+
+bank-mcp works with any MCP-compatible client. Pick your tool below.
+
+### Claude Code
+
+Add to `.mcp.json` in your project root (or `~/.claude/.mcp.json` for all projects):
+
+```json
+{
+  "mcpServers": {
+    "bank": {
+      "command": "npx",
+      "args": ["@bank-mcp/server"]
+    }
+  }
+}
+```
+
+Or add via the CLI:
+
+```bash
+claude mcp add bank -- npx @bank-mcp/server
+```
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "bank": {
+      "command": "npx",
+      "args": ["@bank-mcp/server"]
+    }
+  }
+}
+```
+
+Config file location:
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project root (or `~/.cursor/mcp.json` globally):
+
+```json
+{
+  "mcpServers": {
+    "bank": {
+      "command": "npx",
+      "args": ["@bank-mcp/server"]
+    }
+  }
+}
+```
+
+### VS Code (Copilot)
+
+Add to `.vscode/mcp.json` in your workspace:
+
+```json
+{
+  "servers": {
+    "bank": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["@bank-mcp/server"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "bank": {
+      "command": "npx",
+      "args": ["@bank-mcp/server"]
+    }
+  }
+}
+```
+
+### OpenAI Codex CLI
+
+Add to `~/.codex/config.toml` (or `.codex/config.toml` in your project):
+
+```toml
+[mcp_servers.bank]
+command = "npx"
+args = ["@bank-mcp/server"]
+```
+
+Or add via the CLI:
+
+```bash
+codex mcp add bank -- npx @bank-mcp/server
+```
+
+### Gemini CLI
+
+Add to `~/.gemini/settings.json` (or `.gemini/settings.json` in your project):
+
+```json
+{
+  "mcpServers": {
+    "bank": {
+      "command": "npx",
+      "args": ["@bank-mcp/server"]
+    }
+  }
+}
+```
+
+### Zed
+
+Add to your Zed `settings.json`:
+
+```json
+{
+  "context_servers": {
+    "bank": {
+      "command": {
+        "path": "npx",
+        "args": ["@bank-mcp/server"]
+      }
+    }
+  }
+}
+```
+
+> **Don't see your tool?** bank-mcp uses standard MCP stdio transport. Any client that supports MCP stdio servers can connect using `npx @bank-mcp/server` as the command.
+
+## Available Tools
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `list_accounts` | List all bank accounts across connections | `connectionId?` |
+| `list_transactions` | Fetch transactions with filtering | `accountId`, `from?`, `to?`, `minAmount?`, `maxAmount?` |
+| `search_transactions` | Full-text search on descriptions and merchants | `query`, `accountId?`, `from?`, `to?` |
+| `get_balance` | Current and available balances | `accountId`, `connectionId?` |
+| `spending_summary` | Expenses grouped by merchant or category | `accountId`, `from?`, `to?`, `groupBy?` |
+
+### Example Conversations
+
+Here's what real interactions look like:
+
+**Checking balances:**
+> **You:** What's in my bank accounts?
+>
+> **Claude:** You have 3 accounts across 2 connections:
+> | Account | Balance | Available |
+> |---------|---------|-----------|
+> | ING Checking | €3,241.50 | €3,141.50 |
+> | ING Savings | €12,800.00 | €12,800.00 |
+> | Revolut Main | €891.23 | €891.23 |
+
+**Spending analysis:**
+> **You:** Show my spending by category this month
+>
+> **Claude:** Here's your spending breakdown for February 2026:
+> | Category | Amount | Transactions |
+> |----------|--------|-------------|
+> | Groceries | €487.30 | 12 |
+> | Restaurants | €213.50 | 8 |
+> | Transport | €156.00 | 5 |
+> | Subscriptions | €89.97 | 4 |
+
+**Searching transactions:**
+> **You:** Find all Amazon purchases over $50 in the last 3 months
+>
+> **Claude:** Found 7 Amazon transactions over $50 since November:
+> - Dec 15: Amazon.com — $129.99 (Electronics)
+> - Dec 3: Amazon.com — $67.50 (Books)
+> - ...
+
+## Architecture
+
+<p align="center">
+  <img src="architecture.png" alt="bank-mcp architecture diagram" width="700">
+</p>
+
+### File Structure
+
+```
+~/.bank-mcp/
+  config.json          # Connections & credentials (permissions: 600)
+  keys/                # RSA keys and certificates
+
+src/
+  providers/
+    base.ts            # Abstract BankProvider class
+    registry.ts        # Provider registration
+    enable-banking/    # PSD2 via Enable Banking API
+    teller/            # US banks via mTLS
+    plaid/             # US/CA/EU via Plaid API
+    tink/              # EU Open Banking via Tink API
+    mock/              # Deterministic fake data
+  tools/               # MCP tool implementations
+  utils/
+    cache.ts           # In-memory TTL cache
+    http.ts            # Fetch with timeout + retry
+```
+
+### Provider Interface
+
+Every provider extends the same abstract class, making it straightforward to add new integrations:
+
+```typescript
+abstract class BankProvider {
+  abstract listAccounts(config): Promise<BankAccount[]>;
+  abstract listTransactions(config, accountId, filter?): Promise<Transaction[]>;
+  abstract getBalance(config, accountId): Promise<Balance[]>;
+  abstract getConfigSchema(): ConfigField[];
+}
+```
+
+## Provider Setup Guides
+
+### Enable Banking (PSD2)
+
+**What you need:**
+- [ ] An [Enable Banking](https://enablebanking.com) account with a registered app
+- [ ] Your RSA private key (`.pem` file)
+- [ ] An active session ID from the OAuth consent flow
+
+```bash
+npx @bank-mcp/server init
+# Select: Enable Banking (PSD2)
+# Enter: App ID, key path, session ID
+```
+
+> **Tip:** Sessions expire after 90 days (PSD2 regulation). You'll need to re-authenticate through the consent flow periodically. The server logs a clear message when a session expires.
+
+### Teller (US Banks)
+
+**What you need:**
+- [ ] A [Teller](https://teller.io) developer account
+- [ ] Your client certificate and private key (`.zip` download from the Teller dashboard)
+- [ ] An access token from a Teller Connect enrollment
+
+```bash
+# Extract your certificate
+mkdir -p ~/.bank-mcp/keys/teller
+unzip ~/Downloads/teller.zip -d ~/.bank-mcp/keys/teller/
+chmod 600 ~/.bank-mcp/keys/teller/*.pem
+
+# Run setup
+npx @bank-mcp/server init
+# Select: Teller (US Banks)
+# Enter: certificate path, key path, access token
+```
+
+> **Tip:** Teller uses mutual TLS (mTLS) — your app authenticates at the TLS layer via client certificate, then individual enrollments authenticate via access token. Free tier supports up to 100 live connections.
+
+### Plaid (US/CA/EU)
+
+**What you need:**
+- [ ] A [Plaid](https://plaid.com) developer account (free signup)
+- [ ] Your Client ID and Secret (from the Plaid dashboard)
+- [ ] An access token from a Plaid Link enrollment
+
+```bash
+npx @bank-mcp/server init
+# Select: Plaid (US/CA/EU)
+# Enter: client ID, secret, access token, environment
+```
+
+> **Tip:** Start with the `sandbox` environment (fake data, instant setup). Plaid provides the richest transaction categorization — 104 sub-categories with confidence scores — which makes it ideal for LLM-driven spending analysis.
+
+### Tink (EU Open Banking)
+
+**What you need:**
+- [ ] A [Tink](https://tink.com) developer account (free for testing)
+- [ ] An OAuth2 access token (from the Tink Console or your OAuth2 flow)
+
+```bash
+npx @bank-mcp/server init
+# Select: Tink (EU Open Banking)
+# Enter: access token
+```
+
+> **Tip:** Tink covers 3,400+ banks across Europe. Transactions include PFM (Personal Finance Management) categories with merchant enrichment, and amounts use fixed-point decimals — no floating-point rounding surprises.
+
+## Caching
+
+All data is cached in-memory (no disk persistence — cache dies with the process):
+
+| Data | TTL | Why |
+|------|-----|-----|
+| Account list | 1 hour | Accounts rarely change; minimizes API calls |
+| Transactions | 15 minutes | Balances new transactions vs freshness |
+| Balances | 5 minutes | Most time-sensitive; users expect current data |
+
+Cache is per-connection and per-account. Restarting the server clears all caches.
+
+## Multiple Connections
+
+Configure as many bank connections as you need — even across different providers:
+
+```json
+{
+  "connections": [
+    { "id": "ing-main", "provider": "enable-banking", "..." : "..." },
+    { "id": "chase-checking", "provider": "plaid", "..." : "..." },
+    { "id": "revolut", "provider": "tink", "..." : "..." }
+  ]
+}
+```
+
+All tools accept an optional `connectionId` parameter to target a specific connection. When omitted, every connection is queried and results are merged — so "show all my balances" works across banks automatically.
+
+## Security
+
+### Design Principles
+
+bank-mcp handles sensitive financial credentials. Its security posture is built on minimizing attack surface:
+
+- **Read-only by design** — the `BankProvider` interface exposes only read methods (`listAccounts`, `listTransactions`, `getBalance`). There are no write methods — no transfers, no account modifications, no payment initiation. This is enforced at the type level, not by convention.
+- **No network listener** — bank-mcp runs as a stdio process (stdin/stdout), not an HTTP server. There is no open port, no attack surface from the network.
+- **Minimal dependencies** — only 3 runtime dependencies (`@modelcontextprotocol/sdk`, `jsonwebtoken`, `zod`). Fewer dependencies means fewer supply chain risks.
+- **Open source** — every line is auditable. No obfuscated code, no compiled blobs, no telemetry.
+
+### Credential Storage
+
+- Config file at `~/.bank-mcp/config.json` is created with **`600` permissions** (owner read/write only)
+- RSA keys and certificates are stored in `~/.bank-mcp/keys/` with the same restrictive permissions
+- Credentials are **never logged** — the server sanitizes config objects before any debug output
+- No credential caching beyond the process lifetime — when the server stops, credentials exist only on disk
+
+### Data Flow
+
+```
+Your Bank's API ← HTTPS → bank-mcp (local process) ← stdio → MCP Client (local)
+```
+
+- Transaction data flows directly from your bank's API to your local MCP client
+- **Nothing is stored remotely** — no cloud relay, no proxy server, no intermediate storage
+- **No telemetry** — zero analytics, no crash reports, no usage tracking, no phone-home
+- In-memory cache is per-process and dies when the server stops
+
+### What Your MCP Client Sees
+
+The MCP client (Claude, Cursor, etc.) receives structured tool results containing:
+- Account names, types, and balances
+- Transaction descriptions, amounts, dates, and categories
+- Spending summaries
+
+The LLM processes this in its context window. Be aware that cloud-hosted LLMs send your conversation (including tool results) to their servers. If this is a concern, use a local model or review your provider's data retention policy.
+
+### Recommendations
+
+- **Rotate tokens** — if your banking provider supports token rotation, enable it
+- **Use sandbox first** — test your setup with mock data or Plaid sandbox before connecting live accounts
+- **Review permissions** — ensure `~/.bank-mcp/` is not world-readable (`ls -la ~/.bank-mcp/`)
+- **Scope access** — if your provider supports it, request the minimum scopes needed (read-only account and transaction access)
+
+### Reporting Vulnerabilities
+
+If you discover a security issue, please email the maintainer directly rather than opening a public issue. See [CONTRIBUTING.md](CONTRIBUTING.md) for contact details.
+
+## Adding a New Provider
+
+The pluggable architecture makes it straightforward to add support for additional banking APIs:
+
+1. **Create your provider** at `src/providers/your-provider/index.ts`
+2. **Extend `BankProvider`** — implement `listAccounts`, `listTransactions`, `getBalance`, and `getConfigSchema`
+3. **Register it** in `src/providers/registry.ts`
+4. **Add config fields** for the init wizard (the schema drives the interactive prompts automatically)
+
+See [`src/providers/enable-banking/`](src/providers/enable-banking/) as a reference implementation. The mock provider at [`src/providers/mock/`](src/providers/mock/) is also useful for understanding the expected data shapes.
+
+## Troubleshooting
+
+**`npx` is running an old version**
+
+npx caches packages. Force the latest:
+
+```bash
+npx @bank-mcp/server@latest
+```
+
+**"Permission denied" reading config**
+
+The config file should be readable by your user:
+
+```bash
+ls -la ~/.bank-mcp/config.json
+# Should show: -rw------- (600)
+# Fix: chmod 600 ~/.bank-mcp/config.json
+```
+
+**"Session expired" (Enable Banking)**
+
+PSD2 sessions expire after 90 days. Re-run the init wizard:
+
+```bash
+npx @bank-mcp/server init
+# Select your existing Enable Banking connection to update the session
+```
+
+**Tools not showing up in your MCP client**
+
+1. Verify the server starts: `npx @bank-mcp/server --mock` (should output MCP protocol on stdout)
+2. Check your config file path matches your client's expected location
+3. Restart your MCP client after adding the config
+4. Check your client's MCP logs for connection errors
+
+**"ETLS" or certificate errors (Teller)**
+
+Teller requires mTLS. Verify your certificate files:
+
+```bash
+ls -la ~/.bank-mcp/keys/teller/
+# Should contain: certificate.pem, private_key.pem
+# Both should be chmod 600
+```
+
+## Development
+
+```bash
+git clone https://github.com/elcukro/bank-mcp.git
+cd bank-mcp
+npm install
+npm test          # Run tests (vitest)
+npm run build     # Compile TypeScript
+npm run dev       # Watch mode (recompile on change)
+npm run lint      # ESLint
+```
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+If you're adding a new provider, open an issue first to discuss the approach — we want to make sure the integration fits the project's architecture.
+
+## License
+
+[MIT](LICENSE) — use it however you want.
+
+---
+
+<p align="center">
+  Built for the <a href="https://modelcontextprotocol.io">Model Context Protocol</a> ecosystem
+</p>

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+import type { AppConfig, ConnectionConfig } from "./types.js";
+export declare function getConfigPath(): string;
+export declare function loadConfig(): AppConfig;
+export declare function saveConfig(config: AppConfig): void;
+export declare function getConnection(config: AppConfig, connectionId?: string): ConnectionConfig;
+export declare function getAllConnections(config: AppConfig): ConnectionConfig[];
+/**
+ * Expand ~ in paths within a config object.
+ */
+export declare function expandPaths(config: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAW9D,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,UAAU,IAAI,SAAS,CAuBtC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAMlD;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAkBlB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWpF"}

package/dist/config.js

@@ -0,0 +1,79 @@
+import { readFileSync, writeFileSync, mkdirSync, chmodSync } from "node:fs";
+import { resolve } from "node:path";
+import { homedir } from "node:os";
+const CONFIG_DIR = resolve(homedir(), ".bank-mcp");
+const CONFIG_PATH = resolve(CONFIG_DIR, "config.json");
+const DEFAULT_CONFIG = {
+    version: 1,
+    connections: [],
+    defaults: { transactionDays: 90, currency: "PLN" },
+};
+export function getConfigPath() {
+    return CONFIG_PATH;
+}
+export function loadConfig() {
+    // Mock mode: return a synthetic config with mock provider
+    if (process.env.BANK_MCP_MOCK === "1") {
+        return {
+            version: 1,
+            connections: [
+                {
+                    id: "mock",
+                    provider: "mock",
+                    label: "Mock Bank (Demo)",
+                    config: {},
+                },
+            ],
+            defaults: { transactionDays: 90, currency: "PLN" },
+        };
+    }
+    try {
+        const raw = readFileSync(CONFIG_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return { ...DEFAULT_CONFIG, connections: [] };
+    }
+}
+export function saveConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    const data = JSON.stringify(config, null, 2) + "\n";
+    writeFileSync(CONFIG_PATH, data, { mode: 0o600 });
+    // Ensure permissions even if file existed
+    chmodSync(CONFIG_PATH, 0o600);
+}
+export function getConnection(config, connectionId) {
+    if (config.connections.length === 0) {
+        throw new Error("No connections configured. Run: npx @bank-mcp/server init");
+    }
+    if (connectionId) {
+        const conn = config.connections.find((c) => c.id === connectionId);
+        if (!conn) {
+            const ids = config.connections.map((c) => c.id).join(", ");
+            throw new Error(`Connection "${connectionId}" not found. Available: ${ids}`);
+        }
+        return conn;
+    }
+    // Default to first connection
+    return config.connections[0];
+}
+export function getAllConnections(config) {
+    return config.connections;
+}
+/**
+ * Expand ~ in paths within a config object.
+ */
+export function expandPaths(config) {
+    const home = homedir();
+    const result = {};
+    for (const [key, value] of Object.entries(config)) {
+        if (typeof value === "string" && value.startsWith("~")) {
+            result[key] = value.replace(/^~/, home);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * bank-mcp — Banking data MCP server
+ *
+ * Usage:
+ *   npx @bank-mcp/server          Start MCP server (for MCP clients)
+ *   npx @bank-mcp/server init     Interactive setup wizard
+ *   npx @bank-mcp/server --mock   Start with mock data (no config needed)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map