@bank-mcp/server 0.1.0

package/dist/tools/spending-summary.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import { listTransactions } from "./list-transactions.js";
+export const spendingSummarySchema = z.object({
+    connectionId: z.string().optional(),
+    dateFrom: z.string().optional(),
+    dateTo: z.string().optional(),
+    groupBy: z
+        .enum(["merchant", "category"])
+        .optional()
+        .describe('Group expenses by "merchant" (default) or "category".'),
+    limit: z
+        .number()
+        .optional()
+        .describe("Max groups to return (default 20, sorted by total spent)."),
+});
+export async function spendingSummary(args) {
+    const transactions = await listTransactions({
+        connectionId: args.connectionId,
+        dateFrom: args.dateFrom,
+        dateTo: args.dateTo,
+        type: "debit",
+    });
+    const groupBy = args.groupBy || "merchant";
+    const limit = args.limit || 20;
+    // Group expenses
+    const groups = new Map();
+    for (const tx of transactions) {
+        const key = groupBy === "merchant"
+            ? tx.merchantName || tx.description || "Unknown"
+            : tx.category || "uncategorized";
+        const existing = groups.get(key) || { total: 0, count: 0, currency: tx.currency };
+        existing.total += Math.abs(tx.amount);
+        existing.count += 1;
+        groups.set(key, existing);
+    }
+    // Sort by total spent descending
+    const sorted = [...groups.entries()]
+        .map(([name, data]) => ({
+        name,
+        totalSpent: Math.round(data.total * 100) / 100,
+        transactionCount: data.count,
+        currency: data.currency,
+    }))
+        .sort((a, b) => b.totalSpent - a.totalSpent)
+        .slice(0, limit);
+    const totalSpent = Math.round(transactions.reduce((sum, t) => sum + Math.abs(t.amount), 0) * 100) / 100;
+    const currency = transactions[0]?.currency || "PLN";
+    const dateFrom = args.dateFrom || defaultDateFrom(90);
+    const dateTo = args.dateTo || today();
+    return {
+        groups: sorted,
+        totalSpent,
+        currency,
+        period: `${dateFrom} to ${dateTo}`,
+    };
+}
+function defaultDateFrom(days) {
+    const d = new Date();
+    d.setDate(d.getDate() - days);
+    return d.toISOString().slice(0, 10);
+}
+function today() {
+    return new Date().toISOString().slice(0, 10);
+}
+//# sourceMappingURL=spending-summary.js.map

package/dist/tools/spending-summary.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Normalized banking types — all providers map to these.
+ */
+export interface BankAccount {
+    uid: string;
+    iban: string;
+    name: string;
+    currency: string;
+    connectionId: string;
+}
+export interface Transaction {
+    id: string;
+    accountId: string;
+    date: string;
+    amount: number;
+    currency: string;
+    description: string;
+    merchantName?: string;
+    category?: string;
+    type: "debit" | "credit";
+    reference?: string;
+    rawData?: Record<string, unknown>;
+}
+export interface Balance {
+    accountId: string;
+    amount: number;
+    currency: string;
+    type: string;
+}
+export interface TransactionFilter {
+    dateFrom?: string;
+    dateTo?: string;
+    amountMin?: number;
+    amountMax?: number;
+    type?: "debit" | "credit";
+    limit?: number;
+}
+export interface ConfigField {
+    name: string;
+    label: string;
+    type: "string" | "path" | "select";
+    required: boolean;
+    secret?: boolean;
+    options?: string[];
+    default?: string;
+}
+export interface ConnectionConfig {
+    id: string;
+    provider: string;
+    label: string;
+    config: Record<string, unknown>;
+}
+export interface AppConfig {
+    version: number;
+    connections: ConnectionConfig[];
+    defaults: {
+        transactionDays: number;
+        currency: string;
+    };
+}
+export declare const EXPENSE_CATEGORIES: readonly ["housing", "transportation", "food", "utilities", "insurance", "healthcare", "entertainment", "other"];
+export declare const INCOME_CATEGORIES: readonly ["salary", "freelance", "investments", "rental", "other"];
+export type ExpenseCategory = (typeof EXPENSE_CATEGORIES)[number];
+export type IncomeCategory = (typeof INCOME_CATEGORIES)[number];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,QAAQ,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,eAAO,MAAM,kBAAkB,kHASrB,CAAC;AAEX,eAAO,MAAM,iBAAiB,oEAMpB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * Normalized banking types — all providers map to these.
+ */
+export const EXPENSE_CATEGORIES = [
+    "housing",
+    "transportation",
+    "food",
+    "utilities",
+    "insurance",
+    "healthcare",
+    "entertainment",
+    "other",
+];
+export const INCOME_CATEGORIES = [
+    "salary",
+    "freelance",
+    "investments",
+    "rental",
+    "other",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS;IACT,gBAAgB;IAChB,MAAM;IACN,WAAW;IACX,WAAW;IACX,YAAY;IACZ,eAAe;IACf,OAAO;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ;IACR,WAAW;IACX,aAAa;IACb,QAAQ;IACR,OAAO;CACC,CAAC"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Simple in-memory TTL cache.
+ *
+ * Dies with the process — no disk persistence.
+ * TTLs: balances 5min, transactions 15min, accounts 1hr.
+ */
+export declare class Cache {
+    private store;
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T, ttlMs: number): void;
+    clear(): void;
+}
+export declare const cache: Cache;
+export declare const TTL: {
+    readonly ACCOUNTS: number;
+    readonly TRANSACTIONS: number;
+    readonly BALANCES: number;
+};
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAA0C;IAEvD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAUlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlD,KAAK,IAAI,IAAI;CAGd;AAGD,eAAO,MAAM,KAAK,OAAc,CAAC;AAEjC,eAAO,MAAM,GAAG;;;;CAIN,CAAC"}

package/dist/utils/cache.js

@@ -0,0 +1,33 @@
+/**
+ * Simple in-memory TTL cache.
+ *
+ * Dies with the process — no disk persistence.
+ * TTLs: balances 5min, transactions 15min, accounts 1hr.
+ */
+export class Cache {
+    store = new Map();
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(key, value, ttlMs) {
+        this.store.set(key, { value, expiresAt: Date.now() + ttlMs });
+    }
+    clear() {
+        this.store.clear();
+    }
+}
+// Singleton + TTL constants
+export const cache = new Cache();
+export const TTL = {
+    ACCOUNTS: 60 * 60 * 1000, // 1 hour
+    TRANSACTIONS: 15 * 60 * 1000, // 15 minutes
+    BALANCES: 5 * 60 * 1000, // 5 minutes
+};
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,OAAO,KAAK;IACR,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEvD,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAa;QACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;AAEjC,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IACnC,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;CAC7B,CAAC"}

package/dist/utils/http.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Minimal fetch wrapper with timeout and retry for banking APIs.
+ */
+export interface FetchOptions {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    timeoutMs?: number;
+    retries?: number;
+}
+export declare function httpFetch(url: string, opts?: FetchOptions): Promise<unknown>;
+//# sourceMappingURL=http.d.ts.map

package/dist/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,OAAO,CAAC,CAqClB"}

package/dist/utils/http.js

@@ -0,0 +1,34 @@
+/**
+ * Minimal fetch wrapper with timeout and retry for banking APIs.
+ */
+export async function httpFetch(url, opts = {}) {
+    const { method = "GET", headers, body, timeoutMs = 30000, retries = 1 } = opts;
+    let lastError;
+    for (let attempt = 0; attempt < retries; attempt++) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(url, {
+                method,
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            if (!res.ok) {
+                const text = await res.text().catch(() => "");
+                throw new Error(`HTTP ${res.status} ${res.statusText}: ${text.slice(0, 200)}`);
+            }
+            return await res.json();
+        }
+        catch (err) {
+            clearTimeout(timer);
+            lastError = err instanceof Error ? err : new Error(String(err));
+            // Don't retry on 4xx (client errors)
+            if (lastError.message.includes("HTTP 4"))
+                break;
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=http.js.map

package/dist/utils/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,OAAqB,EAAE;IAEvB,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAE/E,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAE9D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,MAAM;gBACN,OAAO;gBACP,IAAI;gBACJ,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9C,MAAM,IAAI,KAAK,CACb,QAAQ,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC9D,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAEhE,qCAAqC;YACrC,IAAI,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,MAAM;QAClD,CAAC;IACH,CAAC;IAED,MAAM,SAAU,CAAC;AACnB,CAAC"}

package/dist/utils/zod-to-json.d.ts

@@ -0,0 +1,9 @@
+import type { ZodObject, ZodRawShape } from "zod";
+/**
+ * Minimal Zod → JSON Schema converter for MCP tool inputSchema.
+ *
+ * Handles the subset we actually use: objects with string, number,
+ * enum, and optional fields. No need for a full library.
+ */
+export declare function zodToJsonSchema(schema: ZodObject<ZodRawShape>): Record<string, unknown>;
+//# sourceMappingURL=zod-to-json.d.ts.map

package/dist/utils/zod-to-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.d.ts","sourceRoot":"","sources":["../../src/utils/zod-to-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAc,MAAM,KAAK,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB"}

package/dist/utils/zod-to-json.js

@@ -0,0 +1,62 @@
+/**
+ * Minimal Zod → JSON Schema converter for MCP tool inputSchema.
+ *
+ * Handles the subset we actually use: objects with string, number,
+ * enum, and optional fields. No need for a full library.
+ */
+export function zodToJsonSchema(schema) {
+    const shape = schema.shape;
+    const properties = {};
+    const required = [];
+    for (const [key, fieldDef] of Object.entries(shape)) {
+        const field = fieldDef;
+        const prop = zodFieldToJson(field);
+        properties[key] = prop;
+        if (!field.isOptional()) {
+            required.push(key);
+        }
+    }
+    const result = {
+        type: "object",
+        properties,
+    };
+    if (required.length > 0) {
+        result.required = required;
+    }
+    return result;
+}
+function zodFieldToJson(field) {
+    const def = field._def;
+    // Unwrap optional
+    if (def.typeName === "ZodOptional") {
+        return zodFieldToJson(def.innerType);
+    }
+    // Unwrap default
+    if (def.typeName === "ZodDefault") {
+        return zodFieldToJson(def.innerType);
+    }
+    const result = {};
+    // Extract description
+    if (def.description) {
+        result.description = def.description;
+    }
+    switch (def.typeName) {
+        case "ZodString":
+            result.type = "string";
+            break;
+        case "ZodNumber":
+            result.type = "number";
+            break;
+        case "ZodBoolean":
+            result.type = "boolean";
+            break;
+        case "ZodEnum":
+            result.type = "string";
+            result.enum = def.values;
+            break;
+        default:
+            result.type = "string";
+    }
+    return result;
+}
+//# sourceMappingURL=zod-to-json.js.map

package/dist/utils/zod-to-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json.js","sourceRoot":"","sources":["../../src/utils/zod-to-json.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA8B;IAE9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,UAAU,GAA4C,EAAE,CAAC;IAC/D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,QAAsB,CAAC;QACrC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACnC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAEvB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAA4B;QACtC,IAAI,EAAE,QAAQ;QACd,UAAU;KACX,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,KAAiB;IACvC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;IAEvB,kBAAkB;IAClB,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,iBAAiB;IACjB,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAClC,OAAO,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,sBAAsB;IACtB,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACvC,CAAC;IAED,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,WAAW;YACd,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;YACvB,MAAM;QACR,KAAK,WAAW;YACd,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;YACvB,MAAM;QACR,KAAK,YAAY;YACf,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC;YACxB,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;YACvB,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC;YACzB,MAAM;QACR;YACE,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@bank-mcp/server",
+  "version": "0.1.0",
+  "description": "Banking data MCP server — give your AI assistant read-only access to bank accounts via pluggable providers",
+  "type": "module",
+  "bin": {
+    "bank-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/ tests/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "banking",
+    "psd2",
+    "enable-banking",
+    "ai",
+    "llm",
+    "claude"
+  ],
+  "author": "Luke",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elcukro/bank-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/elcukro/bank-mcp/issues"
+  },
+  "homepage": "https://github.com/elcukro/bank-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.0",
+    "jsonwebtoken": "^9.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jsonwebtoken": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}