@bank-mcp/server 0.1.0

package/dist/providers/tink/index.js

@@ -0,0 +1,169 @@
+import { BankProvider } from "../base.js";
+import { httpFetch } from "../../utils/http.js";
+const BASE_URL = "https://api.tink.com";
+function parseConfig(raw) {
+    const accessToken = raw.accessToken;
+    if (!accessToken) {
+        throw new Error("Tink config requires: accessToken");
+    }
+    return { accessToken };
+}
+/**
+ * GET request to Tink API with Bearer token auth.
+ */
+async function tinkGet(config, path, params) {
+    let url = `${BASE_URL}${path}`;
+    if (params) {
+        const qs = new URLSearchParams(params).toString();
+        if (qs)
+            url += `?${qs}`;
+    }
+    return httpFetch(url, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${config.accessToken}`,
+        },
+        timeoutMs: 30000,
+        retries: 2,
+    });
+}
+/**
+ * Parse Tink's fixed-point decimal amount.
+ *
+ * Tink represents amounts as { unscaledValue, scale } where
+ * actual = unscaledValue * 10^(-scale).
+ *
+ * Example: { unscaledValue: "15099", scale: 2 } → 150.99
+ */
+function parseAmount(amount) {
+    const unscaled = parseFloat(amount.unscaledValue);
+    return unscaled * Math.pow(10, -(amount.scale ?? 0));
+}
+export class TinkProvider extends BankProvider {
+    name = "tink";
+    displayName = "Tink (EU Open Banking)";
+    validateConfig(config) {
+        parseConfig(config);
+    }
+    getConfigSchema() {
+        return [
+            {
+                name: "accessToken",
+                label: "Access token (from Tink Console)",
+                type: "string",
+                required: true,
+                secret: true,
+            },
+        ];
+    }
+    async listAccounts(config) {
+        const tc = parseConfig(config);
+        const data = (await tinkGet(tc, "/data/v2/accounts"));
+        return data.accounts.map((a) => ({
+            uid: a.id,
+            iban: a.identifiers?.iban?.iban || a.id,
+            name: a.name,
+            currency: a.balances?.booked?.amount?.currencyCode || "EUR",
+            connectionId: "",
+        }));
+    }
+    async listTransactions(config, accountId, filter) {
+        const tc = parseConfig(config);
+        const allTx = [];
+        let pageToken;
+        // nextPageToken cursor pagination
+        do {
+            const params = {
+                accountIdIn: accountId,
+                pageSize: "100",
+            };
+            if (filter?.dateFrom)
+                params.bookedDateGte = filter.dateFrom;
+            if (filter?.dateTo)
+                params.bookedDateLte = filter.dateTo;
+            if (pageToken)
+                params.pageToken = pageToken;
+            const data = (await tinkGet(tc, "/data/v2/transactions", params));
+            for (const raw of data.transactions) {
+                allTx.push(normalizeTransaction(raw));
+            }
+            pageToken = data.nextPageToken || undefined;
+        } while (pageToken);
+        // Apply local filters
+        let filtered = allTx;
+        if (filter?.amountMin !== undefined) {
+            filtered = filtered.filter((t) => Math.abs(t.amount) >= filter.amountMin);
+        }
+        if (filter?.amountMax !== undefined) {
+            filtered = filtered.filter((t) => Math.abs(t.amount) <= filter.amountMax);
+        }
+        if (filter?.type) {
+            filtered = filtered.filter((t) => t.type === filter.type);
+        }
+        if (filter?.limit) {
+            filtered = filtered.slice(0, filter.limit);
+        }
+        return filtered;
+    }
+    async getBalance(config, accountId) {
+        const tc = parseConfig(config);
+        const data = (await tinkGet(tc, `/data/v2/accounts/${accountId}/balances`));
+        const balances = [];
+        if (data.balances?.bookedBalance) {
+            const amt = data.balances.bookedBalance.amount;
+            balances.push({
+                accountId,
+                amount: parseAmount(amt),
+                currency: amt.currencyCode,
+                type: "booked",
+            });
+        }
+        if (data.balances?.availableBalance) {
+            const amt = data.balances.availableBalance.amount;
+            balances.push({
+                accountId,
+                amount: parseAmount(amt),
+                currency: amt.currencyCode,
+                type: "available",
+            });
+        }
+        return balances;
+    }
+}
+/**
+ * Normalize a Tink transaction to our standard format.
+ *
+ * Amount: Tink uses fixed-point { unscaledValue, scale }.
+ * Sign: Tink amounts are always positive; the `types.type` field
+ * indicates DEBIT (money out) vs CREDIT (money in).
+ * We negate DEBIT amounts to match our convention (negative = expense).
+ *
+ * Descriptions: Tink provides three levels:
+ *   display (cleanest) > original (raw) > detailed.unstructured
+ */
+function normalizeTransaction(raw) {
+    const absAmount = parseAmount(raw.amount);
+    const isDebit = raw.types?.type === "DEBIT";
+    const amount = isDebit ? -absAmount : absAmount;
+    const merchantName = raw.merchantInformation?.merchantName || undefined;
+    const category = raw.categories?.pfm?.name || undefined;
+    // Best description: display > original > detailed
+    const description = raw.descriptions.display ||
+        raw.descriptions.original ||
+        raw.descriptions.detailed?.unstructured ||
+        "Unknown";
+    return {
+        id: raw.id,
+        accountId: raw.accountId,
+        date: raw.dates.booked,
+        amount,
+        currency: raw.amount.currencyCode,
+        description: merchantName || description,
+        merchantName,
+        category,
+        type: isDebit ? "debit" : "credit",
+        reference: raw.reference || description,
+        rawData: raw,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/tink/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAqEA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAqDjD"}

package/dist/server.js

@@ -0,0 +1,90 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { listAccountsSchema, listAccounts } from "./tools/list-accounts.js";
+import { listTransactionsSchema, listTransactions, } from "./tools/list-transactions.js";
+import { searchTransactionsSchema, searchTransactions, } from "./tools/search-transactions.js";
+import { getBalanceSchema, getBalance } from "./tools/get-balance.js";
+import { spendingSummarySchema, spendingSummary, } from "./tools/spending-summary.js";
+const TOOLS = [
+    {
+        name: "list_accounts",
+        description: "List all bank accounts across configured connections. Returns account UIDs, IBANs, names, and currencies.",
+        inputSchema: z.toJSONSchema(listAccountsSchema),
+    },
+    {
+        name: "list_transactions",
+        description: "List bank transactions with optional filters. Defaults to last 90 days. Supports date range, amount range, and debit/credit type filtering.",
+        inputSchema: z.toJSONSchema(listTransactionsSchema),
+    },
+    {
+        name: "search_transactions",
+        description: "Full-text search across transaction descriptions, merchant names, and references. Use for finding specific payments or payees.",
+        inputSchema: z.toJSONSchema(searchTransactionsSchema),
+    },
+    {
+        name: "get_balance",
+        description: "Get current account balance(s). Returns closing booked balance and expected balance when available.",
+        inputSchema: z.toJSONSchema(getBalanceSchema),
+    },
+    {
+        name: "spending_summary",
+        description: 'Group expenses by merchant or category with totals. Shows where money is being spent. Use groupBy "merchant" for vendor breakdown, "category" for category breakdown.',
+        inputSchema: z.toJSONSchema(spendingSummarySchema),
+    },
+];
+const handlers = {
+    list_accounts: (args) => listAccounts(listAccountsSchema.parse(args)),
+    list_transactions: (args) => listTransactions(listTransactionsSchema.parse(args)),
+    search_transactions: (args) => searchTransactions(searchTransactionsSchema.parse(args)),
+    get_balance: (args) => getBalance(getBalanceSchema.parse(args)),
+    spending_summary: (args) => spendingSummary(spendingSummarySchema.parse(args)),
+};
+export async function startServer() {
+    const server = new Server({ name: "bank-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOLS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const handler = handlers[name];
+        if (!handler) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: true, code: "unknown_tool", message: `Unknown tool: ${name}` }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await handler(args || {});
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            // Return structured error as text so LLMs can explain it
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ error: true, code: "tool_error", message }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // All logging to stderr — stdout is the MCP wire protocol
+    console.error("[bank-mcp] Server started");
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/get-balance.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+import type { Balance } from "../types.js";
+export declare const getBalanceSchema: z.ZodObject<{
+    connectionId: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function getBalance(args: z.infer<typeof getBalanceSchema>): Promise<Balance[]>;
+//# sourceMappingURL=get-balance.d.ts.map

package/dist/tools/get-balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-balance.d.ts","sourceRoot":"","sources":["../../src/tools/get-balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAEH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,GACrC,OAAO,CAAC,OAAO,EAAE,CAAC,CAmCpB"}

package/dist/tools/get-balance.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { loadConfig, getConnection, getAllConnections } from "../config.js";
+import { getProvider } from "../providers/registry.js";
+import { cache, TTL } from "../utils/cache.js";
+export const getBalanceSchema = z.object({
+    connectionId: z.string().optional(),
+    accountId: z.string().optional().describe("Account UID. If omitted, returns balances for all accounts."),
+});
+export async function getBalance(args) {
+    const config = loadConfig();
+    const connections = args.connectionId
+        ? [getConnection(config, args.connectionId)]
+        : getAllConnections(config);
+    const allBalances = [];
+    for (const conn of connections) {
+        const provider = getProvider(conn.provider);
+        let accountIds;
+        if (args.accountId) {
+            accountIds = [args.accountId];
+        }
+        else {
+            const accounts = await provider.listAccounts(conn.config);
+            accountIds = accounts.map((a) => a.uid);
+        }
+        for (const accId of accountIds) {
+            const cacheKey = `bal:${conn.id}:${accId}`;
+            const cached = cache.get(cacheKey);
+            if (cached) {
+                allBalances.push(...cached);
+                continue;
+            }
+            const balances = await provider.getBalance(conn.config, accId);
+            cache.set(cacheKey, balances, TTL.BALANCES);
+            allBalances.push(...balances);
+        }
+    }
+    return allBalances;
+}
+//# sourceMappingURL=get-balance.js.map

package/dist/tools/get-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-balance.js","sourceRoot":"","sources":["../../src/tools/get-balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;CACzG,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAsC;IAEtC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY;QACnC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE9B,MAAM,WAAW,GAAc,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE5C,IAAI,UAAoB,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,UAAU,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1D,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAY,QAAQ,CAAC,CAAC;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;gBAC5B,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/D,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/tools/list-accounts.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import type { BankAccount } from "../types.js";
+export declare const listAccountsSchema: z.ZodObject<{
+    connectionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function listAccounts(args: z.infer<typeof listAccountsSchema>): Promise<BankAccount[]>;
+//# sourceMappingURL=list-accounts.d.ts.map

package/dist/tools/list-accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-accounts.d.ts","sourceRoot":"","sources":["../../src/tools/list-accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,kBAAkB;;iBAK7B,CAAC;AAEH,wBAAsB,YAAY,CAChC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACvC,OAAO,CAAC,WAAW,EAAE,CAAC,CA2BxB"}

package/dist/tools/list-accounts.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { loadConfig, getConnection, getAllConnections } from "../config.js";
+import { getProvider } from "../providers/registry.js";
+import { cache, TTL } from "../utils/cache.js";
+export const listAccountsSchema = z.object({
+    connectionId: z
+        .string()
+        .optional()
+        .describe("Connection ID to query. If omitted, queries all connections."),
+});
+export async function listAccounts(args) {
+    const config = loadConfig();
+    const connections = args.connectionId
+        ? [getConnection(config, args.connectionId)]
+        : getAllConnections(config);
+    const allAccounts = [];
+    for (const conn of connections) {
+        const cacheKey = `accounts:${conn.id}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            allAccounts.push(...cached);
+            continue;
+        }
+        const provider = getProvider(conn.provider);
+        const accounts = await provider.listAccounts(conn.config);
+        // Tag each account with its connection
+        const tagged = accounts.map((a) => ({ ...a, connectionId: conn.id }));
+        cache.set(cacheKey, tagged, TTL.ACCOUNTS);
+        allAccounts.push(...tagged);
+    }
+    return allAccounts;
+}
+//# sourceMappingURL=list-accounts.js.map

package/dist/tools/list-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-accounts.js","sourceRoot":"","sources":["../../src/tools/list-accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAwC;IAExC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY;QACnC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE9B,MAAM,WAAW,GAAkB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,YAAY,IAAI,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAgB,QAAQ,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1D,uCAAuC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACtE,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/tools/list-transactions.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import type { Transaction } from "../types.js";
+export declare const listTransactionsSchema: z.ZodObject<{
+    connectionId: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    amountMin: z.ZodOptional<z.ZodNumber>;
+    amountMax: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodOptional<z.ZodEnum<{
+        debit: "debit";
+        credit: "credit";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function listTransactions(args: z.infer<typeof listTransactionsSchema>): Promise<Transaction[]>;
+//# sourceMappingURL=list-transactions.d.ts.map

package/dist/tools/list-transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-transactions.d.ts","sourceRoot":"","sources":["../../src/tools/list-transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC;AAElE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAiCjC,CAAC;AAEH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAC3C,OAAO,CAAC,WAAW,EAAE,CAAC,CAwDxB"}

package/dist/tools/list-transactions.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { loadConfig, getConnection, getAllConnections } from "../config.js";
+import { getProvider } from "../providers/registry.js";
+import { cache, TTL } from "../utils/cache.js";
+export const listTransactionsSchema = z.object({
+    connectionId: z
+        .string()
+        .optional()
+        .describe("Connection ID. If omitted, queries all connections."),
+    accountId: z
+        .string()
+        .optional()
+        .describe("Account UID. If omitted, queries all accounts."),
+    dateFrom: z
+        .string()
+        .optional()
+        .describe('Start date (YYYY-MM-DD). Defaults to 90 days ago.'),
+    dateTo: z
+        .string()
+        .optional()
+        .describe('End date (YYYY-MM-DD). Defaults to today.'),
+    amountMin: z
+        .number()
+        .optional()
+        .describe("Minimum absolute amount."),
+    amountMax: z
+        .number()
+        .optional()
+        .describe("Maximum absolute amount."),
+    type: z
+        .enum(["debit", "credit"])
+        .optional()
+        .describe("Filter by transaction type."),
+    limit: z
+        .number()
+        .optional()
+        .describe("Maximum number of transactions to return."),
+});
+export async function listTransactions(args) {
+    const config = loadConfig();
+    const dateFrom = args.dateFrom || defaultDateFrom(config.defaults.transactionDays);
+    const dateTo = args.dateTo || today();
+    const filter = {
+        dateFrom,
+        dateTo,
+        amountMin: args.amountMin,
+        amountMax: args.amountMax,
+        type: args.type,
+        limit: args.limit,
+    };
+    // Resolve which connections and accounts to query
+    const connections = args.connectionId
+        ? [getConnection(config, args.connectionId)]
+        : getAllConnections(config);
+    const allTx = [];
+    for (const conn of connections) {
+        const provider = getProvider(conn.provider);
+        // Get account list (may come from cache)
+        let accountIds;
+        if (args.accountId) {
+            accountIds = [args.accountId];
+        }
+        else {
+            const accounts = await provider.listAccounts(conn.config);
+            accountIds = accounts.map((a) => a.uid);
+        }
+        for (const accId of accountIds) {
+            const cacheKey = `tx:${conn.id}:${accId}:${dateFrom}:${dateTo}`;
+            const cached = cache.get(cacheKey);
+            if (cached) {
+                allTx.push(...applyLocalFilters(cached, filter));
+                continue;
+            }
+            const transactions = await provider.listTransactions(conn.config, accId, { dateFrom, dateTo });
+            cache.set(cacheKey, transactions, TTL.TRANSACTIONS);
+            allTx.push(...applyLocalFilters(transactions, filter));
+        }
+    }
+    // Sort by date descending (most recent first)
+    allTx.sort((a, b) => b.date.localeCompare(a.date));
+    return args.limit ? allTx.slice(0, args.limit) : allTx;
+}
+function applyLocalFilters(txs, f) {
+    let result = txs;
+    if (f.amountMin !== undefined) {
+        result = result.filter((t) => Math.abs(t.amount) >= f.amountMin);
+    }
+    if (f.amountMax !== undefined) {
+        result = result.filter((t) => Math.abs(t.amount) <= f.amountMax);
+    }
+    if (f.type) {
+        result = result.filter((t) => t.type === f.type);
+    }
+    return result;
+}
+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=list-transactions.js.map

package/dist/tools/list-transactions.js.map

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

package/dist/tools/search-transactions.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const searchTransactionsSchema: z.ZodObject<{
+    query: z.ZodString;
+    connectionId: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function searchTransactions(args: z.infer<typeof searchTransactionsSchema>): Promise<unknown>;
+//# sourceMappingURL=search-transactions.d.ts.map

package/dist/tools/search-transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-transactions.d.ts","sourceRoot":"","sources":["../../src/tools/search-transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,wBAAwB;;;;;;iBAQnC,CAAC;AAEH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,GAC7C,OAAO,CAAC,OAAO,CAAC,CAiBlB"}

package/dist/tools/search-transactions.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { listTransactions } from "./list-transactions.js";
+export const searchTransactionsSchema = z.object({
+    query: z
+        .string()
+        .describe("Search text — matched against description, merchant name, and reference."),
+    connectionId: z.string().optional(),
+    dateFrom: z.string().optional(),
+    dateTo: z.string().optional(),
+    limit: z.number().optional().describe("Max results. Default 50."),
+});
+export async function searchTransactions(args) {
+    // Fetch all transactions for the date range, then filter locally
+    const transactions = await listTransactions({
+        connectionId: args.connectionId,
+        dateFrom: args.dateFrom,
+        dateTo: args.dateTo,
+    });
+    const q = args.query.toLowerCase();
+    const limit = args.limit || 50;
+    const matches = transactions.filter((t) => {
+        const fields = [t.description, t.merchantName, t.reference].filter(Boolean);
+        return fields.some((f) => f.toLowerCase().includes(q));
+    });
+    return matches.slice(0, limit);
+}
+//# sourceMappingURL=search-transactions.js.map

package/dist/tools/search-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-transactions.js","sourceRoot":"","sources":["../../src/tools/search-transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,0EAA0E,CAAC;IACvF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAA8C;IAE9C,iEAAiE;IACjE,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC;QAC1C,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACxC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5E,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/tools/spending-summary.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export declare const spendingSummarySchema: z.ZodObject<{
+    connectionId: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    groupBy: z.ZodOptional<z.ZodEnum<{
+        merchant: "merchant";
+        category: "category";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+interface SpendingGroup {
+    name: string;
+    totalSpent: number;
+    transactionCount: number;
+    currency: string;
+}
+export declare function spendingSummary(args: z.infer<typeof spendingSummarySchema>): Promise<{
+    groups: SpendingGroup[];
+    totalSpent: number;
+    currency: string;
+    period: string;
+}>;
+export {};
+//# sourceMappingURL=spending-summary.d.ts.map

package/dist/tools/spending-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spending-summary.d.ts","sourceRoot":"","sources":["../../src/tools/spending-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB;;;;;;;;;iBAYhC,CAAC;AAEH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAC1C,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAkD5F"}