@frihet/mcp-server 1.7.0-beta.1 → 1.12.0-beta.1

package/dist/tools/accountingClose.js

@@ -0,0 +1,119 @@
+/**
+ * Period close tools for the Frihet MCP server — D4-B megasprint (3 tools).
+ *
+ * Tools:
+ *   1. period_close_status — get the current accounting period state (open/closing/closed)
+ *   2. period_close        — close a monthly or quarterly period (TRUST AREA)
+ *   3. period_reopen       — reopen a closed period with required reason (TRUST AREA)
+ *
+ * REST surface: /v1/periods/current, /v1/periods/{id}, /v1/periods/close, /v1/periods/{id}/reopen
+ *
+ * Closing a period freezes invoices/expenses/journal entries. Reopening requires a
+ * compliance reason logged for audit. These are TRUST AREA operations.
+ *
+ * NOTE: ERP backend endpoints land in parallel D4-A wave. 404s propagate as isError
+ * until backend ships. TODO: confirm callable boundary vs REST shell for closePeriod.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, mutateContent, READ_ONLY_ANNOTATIONS, periodStatusOutput, } from "./shared.js";
+export function registerAccountingCloseTools(server, client) {
+    // -- period_close_status --
+    server.registerTool("period_close_status", {
+        title: "Period Close Status",
+        description: "Get the current accounting period state (open / closing / closed / reopened). " +
+            "Without periodId returns the current open or most recently closed period. " +
+            "/ Devuelve el estado del periodo contable actual (abierto/cerrando/cerrado/reabierto).",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            periodId: z.string().optional().describe("Specific period ID (default: current) / ID periodo especifico"),
+        },
+        outputSchema: periodStatusOutput,
+    }, async ({ periodId }) => withToolLogging("period_close_status", async () => {
+        const result = await client.getCurrentPeriod({ periodId });
+        return {
+            content: [getContent(formatRecord("Period status", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- period_close --
+    server.registerTool("period_close", {
+        title: "Close Accounting Period",
+        description: "TRUST AREA — FISCAL CLOSE. Close a monthly or quarterly accounting period. " +
+            "Freezes invoices, expenses, journal entries and bank reconciliations for the period. " +
+            "Requires confirm=true. Idempotent: re-closing an already closed period is a no-op. " +
+            "Closed periods can be reopened with period_reopen + audit reason. " +
+            "/ AREA DE CONFIANZA — CIERRE FISCAL. Cierra un periodo contable mensual o trimestral. " +
+            "Congela facturas, gastos, asientos. Requiere confirm=true.",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+        inputSchema: {
+            type: z
+                .enum(["monthly", "quarterly"])
+                .describe("Period type: monthly or quarterly / Tipo: mensual o trimestral"),
+            confirm: z
+                .boolean()
+                .describe("Must be true to perform the close / Debe ser true para ejecutar el cierre"),
+        },
+        outputSchema: periodStatusOutput,
+    }, async ({ type, confirm }) => withToolLogging("period_close", async () => {
+        if (!confirm) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: confirm=true is required to close an accounting period. " +
+                            "This freezes all invoices, expenses, journal entries and bank reconciliations for the period. " +
+                            "Set confirm=true when you are certain. / " +
+                            "Se requiere confirm=true para cerrar un periodo contable.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = await client.closePeriod({ type });
+        return {
+            content: [mutateContent(formatRecord("Period closed", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- period_reopen --
+    server.registerTool("period_reopen", {
+        title: "Reopen Accounting Period",
+        description: "TRUST AREA — FISCAL REOPEN. Reopen a closed accounting period. " +
+            "Requires a compliance reason (audit log) and confirm=true. " +
+            "Reopening allows backdated edits to invoices/expenses — use with extreme caution. " +
+            "/ AREA DE CONFIANZA — REAPERTURA FISCAL. Reabre un periodo cerrado. Requiere motivo (auditoria) y confirm=true.",
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
+        inputSchema: {
+            periodId: z.string().describe("Closed period ID to reopen / ID del periodo cerrado"),
+            reason: z
+                .string()
+                .min(1)
+                .describe("Required audit reason (logged) / Motivo obligatorio (auditoria)"),
+            confirm: z
+                .boolean()
+                .describe("Must be true to reopen / Debe ser true para reabrir"),
+        },
+        outputSchema: periodStatusOutput,
+    }, async ({ periodId, reason, confirm }) => withToolLogging("period_reopen", async () => {
+        if (!confirm) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: confirm=true is required to reopen a closed accounting period. " +
+                            "This allows backdated edits and may affect fiscal reporting. " +
+                            "Set confirm=true when you are certain. / " +
+                            "Se requiere confirm=true para reabrir un periodo cerrado.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = await client.reopenPeriod({ periodId, reason });
+        return {
+            content: [mutateContent(formatRecord("Period reopened", result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=accountingClose.js.map

package/dist/tools/accountingClose.js.map

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

package/dist/tools/audit_gl.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Audit GL tools for the Frihet MCP server — Day 1 Megasprint (3 tools).
+ *
+ * Tools:
+ *   1. frihet_gl_entry_approve    — approve a GL journal entry (TRUST AREA)
+ *   2. frihet_gl_entry_reject     — reject a GL journal entry with reason (TRUST AREA)
+ *   3. frihet_gl_entry_audit_log  — retrieve the audit trail for a GL entry
+ *
+ * REST surface: /v1/gl/* proxies Firebase callables:
+ *   approveGLEntry, rejectGLEntry, getGLEntryAuditLog (eu-west1)
+ *
+ * Backend status (post-Day 1 Megasprint, May 2026):
+ *   Frihet-ERP PR #395 — Audit GL approval workflow MERGED.
+ *   Tools will surface 404 errors until backend REST shell ships.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerAuditGLTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=audit_gl.d.ts.map

package/dist/tools/audit_gl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit_gl.d.ts","sourceRoot":"","sources":["../../src/tools/audit_gl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAU5D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA2FnF"}

package/dist/tools/audit_gl.js

@@ -0,0 +1,86 @@
+/**
+ * Audit GL tools for the Frihet MCP server — Day 1 Megasprint (3 tools).
+ *
+ * Tools:
+ *   1. frihet_gl_entry_approve    — approve a GL journal entry (TRUST AREA)
+ *   2. frihet_gl_entry_reject     — reject a GL journal entry with reason (TRUST AREA)
+ *   3. frihet_gl_entry_audit_log  — retrieve the audit trail for a GL entry
+ *
+ * REST surface: /v1/gl/* proxies Firebase callables:
+ *   approveGLEntry, rejectGLEntry, getGLEntryAuditLog (eu-west1)
+ *
+ * Backend status (post-Day 1 Megasprint, May 2026):
+ *   Frihet-ERP PR #395 — Audit GL approval workflow MERGED.
+ *   Tools will surface 404 errors until backend REST shell ships.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, mutateContent, READ_ONLY_ANNOTATIONS, UPDATE_ANNOTATIONS, } from "./shared.js";
+export function registerAuditGLTools(server, client) {
+    // -- frihet_gl_entry_approve -----------------------------------------------
+    server.registerTool("frihet_gl_entry_approve", {
+        title: "Approve GL Entry",
+        description: "Approve a General Ledger journal entry pending review. " +
+            "Sets entry status to 'approved' and records the approver + timestamp in the audit trail. " +
+            "Requires gestor/admin role. This is a TRUST AREA action — double-check entry ID before calling. " +
+            "Example: entryId='gl_2026_q1_042'. " +
+            "/ Aprueba un asiento contable pendiente de revision. " +
+            "Requiere rol gestor/admin. Accion de area de confianza.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            entryId: z.string().describe("GL entry ID to approve / ID del asiento contable a aprobar"),
+            notes: z.string().optional().describe("Optional approval notes / Notas de aprobacion opcionales"),
+        },
+    }, async ({ entryId, notes }) => withToolLogging("frihet_gl_entry_approve", async () => {
+        const result = await client.approveGLEntry(entryId, notes);
+        return {
+            content: [
+                mutateContent(formatRecord(`GL Entry ${entryId} approved`, result)),
+            ],
+            structuredContent: result,
+        };
+    }));
+    // -- frihet_gl_entry_reject ------------------------------------------------
+    server.registerTool("frihet_gl_entry_reject", {
+        title: "Reject GL Entry",
+        description: "Reject a General Ledger journal entry pending review with a required reason. " +
+            "Sets entry status to 'rejected' and records the rejector + reason in the audit trail. " +
+            "Requires gestor/admin role. This is a TRUST AREA action. " +
+            "Example: entryId='gl_2026_q1_042', reason='Importe incorrecto, revisar factura F-2026-042'. " +
+            "/ Rechaza un asiento contable pendiente con una razon obligatoria. " +
+            "Requiere rol gestor/admin.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            entryId: z.string().describe("GL entry ID to reject / ID del asiento contable a rechazar"),
+            reason: z.string().describe("Mandatory rejection reason (visible to submitter) / Razon del rechazo (obligatoria, visible al emisor)"),
+        },
+    }, async ({ entryId, reason }) => withToolLogging("frihet_gl_entry_reject", async () => {
+        const result = await client.rejectGLEntry(entryId, reason);
+        return {
+            content: [
+                mutateContent(formatRecord(`GL Entry ${entryId} rejected`, result)),
+            ],
+            structuredContent: result,
+        };
+    }));
+    // -- frihet_gl_entry_audit_log ---------------------------------------------
+    server.registerTool("frihet_gl_entry_audit_log", {
+        title: "Get GL Entry Audit Log",
+        description: "Retrieve the full audit trail for a General Ledger entry — all state transitions " +
+            "(created, submitted, approved, rejected), who acted, and when. " +
+            "Use this to investigate approval history or compliance audits. " +
+            "Example: entryId='gl_2026_q1_042'. " +
+            "/ Obtiene el historial de auditoría completo de un asiento contable. " +
+            "Muestra todas las transiciones de estado, quien actuo y cuando.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            entryId: z.string().describe("GL entry ID / ID del asiento contable"),
+        },
+    }, async ({ entryId }) => withToolLogging("frihet_gl_entry_audit_log", async () => {
+        const result = await client.getGLEntryAuditLog(entryId);
+        return {
+            content: [getContent(formatRecord(`Audit Log for GL Entry ${entryId}`, result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=audit_gl.js.map

package/dist/tools/audit_gl.js.map

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

package/dist/tools/bank_rules.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Bank rules tools for the Frihet MCP server — Day 1 Megasprint (2 tools).
+ *
+ * Tools:
+ *   1. frihet_bank_rules_list  — list bank auto-categorization rules for the workspace
+ *   2. frihet_bank_rule_create — create a new bank categorization rule
+ *
+ * Skipped (external webhook handlers, not MCP-callable):
+ *   - plaidWebhook  — Plaid inbound webhook
+ *   - tinkWebhook   — Tink/Revolut inbound webhook
+ *
+ * REST surface: /v1/banking/rules — admin-side rule management.
+ *   Backend callables: #394 Banking Q3 flag (Frihet-ERP PR #394).
+ *   Tools surface 404 until backend callable wrapper ships.
+ *
+ * NOTE: Bank rules are Q3-flagged in Frihet-ERP. These tools are wired here
+ * so AI agents can read + create rules once the backend ships, without an MCP
+ * bump. Backend may still be Firestore-direct writes; tools will 404 gracefully.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerBankRulesTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=bank_rules.d.ts.map

package/dist/tools/bank_rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank_rules.d.ts","sourceRoot":"","sources":["../../src/tools/bank_rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA+B5D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA2ErF"}

package/dist/tools/bank_rules.js

@@ -0,0 +1,96 @@
+/**
+ * Bank rules tools for the Frihet MCP server — Day 1 Megasprint (2 tools).
+ *
+ * Tools:
+ *   1. frihet_bank_rules_list  — list bank auto-categorization rules for the workspace
+ *   2. frihet_bank_rule_create — create a new bank categorization rule
+ *
+ * Skipped (external webhook handlers, not MCP-callable):
+ *   - plaidWebhook  — Plaid inbound webhook
+ *   - tinkWebhook   — Tink/Revolut inbound webhook
+ *
+ * REST surface: /v1/banking/rules — admin-side rule management.
+ *   Backend callables: #394 Banking Q3 flag (Frihet-ERP PR #394).
+ *   Tools surface 404 until backend callable wrapper ships.
+ *
+ * NOTE: Bank rules are Q3-flagged in Frihet-ERP. These tools are wired here
+ * so AI agents can read + create rules once the backend ships, without an MCP
+ * bump. Backend may still be Firestore-direct writes; tools will 404 gracefully.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, mutateContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, paginatedOutput, } from "./shared.js";
+const bankRuleItemOutput = z.object({
+    id: z.string(),
+    name: z.string(),
+    conditions: z.array(z.object({
+        field: z.string(),
+        operator: z.string(),
+        value: z.string(),
+    })).optional(),
+    actions: z.array(z.object({
+        type: z.string(),
+        value: z.string(),
+    })).optional(),
+    isActive: z.boolean().optional(),
+    createdAt: z.string().optional(),
+}).passthrough();
+const CONDITION_FIELD = z.enum(["description", "amount", "counterparty", "iban", "reference"]);
+const CONDITION_OPERATOR = z.enum(["contains", "startsWith", "endsWith", "equals", "greaterThan", "lessThan"]);
+export function registerBankRulesTools(server, client) {
+    // -- frihet_bank_rules_list -----------------------------------------------
+    server.registerTool("frihet_bank_rules_list", {
+        title: "List Bank Categorization Rules",
+        description: "List all bank auto-categorization rules for the workspace. " +
+            "Rules automatically categorize transactions matching conditions (description, amount, counterparty). " +
+            "Returns rule name, conditions, actions (category/tag/client assign), and active status. " +
+            "/ Lista las reglas de categorizacion automatica de transacciones bancarias del workspace. " +
+            "Devuelve nombre, condiciones, acciones (categoria/etiqueta/cliente) y estado activo.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            isActive: z.boolean().optional().describe("Filter by active/inactive rules / Filtrar por reglas activas/inactivas"),
+            limit: z.number().int().min(1).max(100).optional().describe("Max results / Resultados maximos"),
+            offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+        },
+        outputSchema: paginatedOutput(bankRuleItemOutput),
+    }, async ({ isActive, limit, offset }) => withToolLogging("frihet_bank_rules_list", async () => {
+        const result = await client.listBankRules({ isActive, limit, offset });
+        return {
+            content: [listContent(formatPaginatedResponse("bank_rules", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- frihet_bank_rule_create ----------------------------------------------
+    server.registerTool("frihet_bank_rule_create", {
+        title: "Create Bank Categorization Rule",
+        description: "Create a new bank auto-categorization rule. " +
+            "Rules apply automatically to matching incoming transactions. " +
+            "A rule has conditions (AND logic) and actions (assign category, tag, or client). " +
+            "Example: name='Mercadona groceries', condition description contains 'MERCADONA', " +
+            "action category='groceries'. " +
+            "/ Crea una nueva regla de categorizacion automatica de transacciones bancarias. " +
+            "Las reglas aplican condiciones (logica AND) y acciones (categoria, etiqueta, cliente).",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            name: z.string().describe("Rule name for identification / Nombre de la regla"),
+            conditions: z.array(z.object({
+                field: CONDITION_FIELD.describe("Transaction field to match / Campo de transaccion a comparar"),
+                operator: CONDITION_OPERATOR.describe("Comparison operator / Operador de comparacion"),
+                value: z.string().describe("Value to match against / Valor a comparar"),
+            })).min(1).describe("Rule conditions (AND logic — all must match) / Condiciones (logica AND — todas deben cumplirse)"),
+            actions: z.array(z.object({
+                type: z.enum(["setCategory", "addTag", "assignClient"]).describe("Action type / Tipo de accion"),
+                value: z.string().describe("Action value (category name, tag name, or client ID) / Valor de la accion"),
+            })).min(1).describe("Actions to apply when rule matches / Acciones a aplicar cuando la regla se cumple"),
+            isActive: z.boolean().optional().describe("Whether the rule is active (default true) / Si la regla esta activa (por defecto true)"),
+        },
+    }, async ({ name, conditions, actions, isActive }) => withToolLogging("frihet_bank_rule_create", async () => {
+        const result = await client.createBankRule({ name, conditions, actions, isActive });
+        return {
+            content: [
+                mutateContent(formatRecord(`Bank rule created: ${name}`, result)),
+            ],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=bank_rules.js.map

package/dist/tools/bank_rules.js.map

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

package/dist/tools/banking.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Banking tools for the Frihet MCP server — Wave 6 (5 tools).
+ *
+ * Tools:
+ *   1. list_bank_accounts  — list connected bank accounts per workspace
+ *   2. get_bank_account    — get single account with balance + last sync
+ *   3. list_transactions   — list bank transactions (filter: account, dateRange, status, category)
+ *   4. categorize_transaction — apply category to a transaction (manual classification)
+ *   5. match_transaction_to_invoice — link transaction to invoice/expense (reconciliation)
+ *
+ * REST surface: /v1/banking/accounts, /v1/banking/transactions
+ *
+ * NOTE: ERP backend endpoints /v1/banking/* are planned. Tools are wired
+ * and will surface 404 errors until the backend ships (documented: pending).
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerBankingTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=banking.d.ts.map

package/dist/tools/banking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banking.d.ts","sourceRoot":"","sources":["../../src/tools/banking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAe5D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA4KnF"}

package/dist/tools/banking.js

@@ -0,0 +1,155 @@
+/**
+ * Banking tools for the Frihet MCP server — Wave 6 (5 tools).
+ *
+ * Tools:
+ *   1. list_bank_accounts  — list connected bank accounts per workspace
+ *   2. get_bank_account    — get single account with balance + last sync
+ *   3. list_transactions   — list bank transactions (filter: account, dateRange, status, category)
+ *   4. categorize_transaction — apply category to a transaction (manual classification)
+ *   5. match_transaction_to_invoice — link transaction to invoice/expense (reconciliation)
+ *
+ * REST surface: /v1/banking/accounts, /v1/banking/transactions
+ *
+ * NOTE: ERP backend endpoints /v1/banking/* are planned. Tools are wired
+ * and will surface 404 errors until the backend ships (documented: pending).
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, getContent, mutateContent, READ_ONLY_ANNOTATIONS, UPDATE_ANNOTATIONS, paginatedOutput, bankAccountItemOutput, bankTransactionItemOutput, } from "./shared.js";
+export function registerBankingTools(server, client) {
+    // -- list_bank_accounts --
+    server.registerTool("list_bank_accounts", {
+        title: "List Bank Accounts",
+        description: "List all connected bank accounts for the workspace. " +
+            "Returns alias, IBAN (last 4 digits only for security), currency, balance, and last sync timestamp. " +
+            "/ Lista todas las cuentas bancarias conectadas al espacio de trabajo. " +
+            "Devuelve alias, IBAN (solo ultimos 4 digitos por seguridad), divisa, saldo y ultima sincronizacion.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            limit: z.number().int().min(1).max(100).optional().describe("Max results (1-100) / Resultados maximos"),
+            offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+        },
+        outputSchema: paginatedOutput(bankAccountItemOutput),
+    }, async ({ limit, offset }) => withToolLogging("list_bank_accounts", async () => {
+        const result = await client.listBankAccounts({ limit, offset });
+        return {
+            content: [listContent(formatPaginatedResponse("bank_accounts", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- get_bank_account --
+    server.registerTool("get_bank_account", {
+        title: "Get Bank Account",
+        description: "Get a single connected bank account by ID. " +
+            "Returns alias, IBAN (last 4 digits), currency, current balance, and last sync timestamp. " +
+            "/ Obtiene una cuenta bancaria conectada por su ID. " +
+            "Devuelve alias, IBAN (ultimos 4 digitos), divisa, saldo actual y ultima sincronizacion.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            id: z.string().describe("Bank account ID / ID de la cuenta bancaria"),
+        },
+        outputSchema: bankAccountItemOutput,
+    }, async ({ id }) => withToolLogging("get_bank_account", async () => {
+        const result = await client.getBankAccount(id);
+        return {
+            content: [getContent(formatRecord("Bank Account", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- list_transactions --
+    server.registerTool("list_transactions", {
+        title: "List Bank Transactions",
+        description: "List bank transactions with optional filters. " +
+            "Filter by account, date range, status (pending/posted/excluded), or category. " +
+            "Useful for reconciliation, expense matching, and cash flow analysis. " +
+            "/ Lista movimientos bancarios con filtros opcionales. " +
+            "Filtra por cuenta, rango de fechas, estado (pendiente/contabilizado/excluido) o categoria. " +
+            "Util para conciliacion, asignacion de gastos y analisis de flujo de caja.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            accountId: z.string().optional().describe("Filter by bank account ID / Filtrar por ID de cuenta"),
+            from: z.string().optional().describe("Start date ISO 8601 (YYYY-MM-DD) / Fecha inicio"),
+            to: z.string().optional().describe("End date ISO 8601 (YYYY-MM-DD) / Fecha fin"),
+            status: z
+                .enum(["pending", "posted", "excluded"])
+                .optional()
+                .describe("Filter by transaction status / Filtrar por estado"),
+            category: z.string().optional().describe("Filter by category slug / Filtrar por categoria"),
+            limit: z.number().int().min(1).max(100).optional().describe("Max results (1-100) / Resultados maximos"),
+            offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+            after: z.string().optional().describe("Cursor for cursor-based pagination / Cursor para paginacion"),
+        },
+        outputSchema: paginatedOutput(bankTransactionItemOutput),
+    }, async ({ accountId, from, to, status, category, limit, offset, after }) => withToolLogging("list_transactions", async () => {
+        const result = await client.listTransactions({ accountId, from, to, status, category, limit, offset, after });
+        return {
+            content: [listContent(formatPaginatedResponse("transactions", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- categorize_transaction --
+    server.registerTool("categorize_transaction", {
+        title: "Categorize Transaction",
+        description: "Apply a category to a bank transaction for manual classification. " +
+            "Categories map to expense categories for tax deduction tracking. " +
+            "Example: id='tx_abc', category='supplies', notes='Office paper Q1' " +
+            "/ Asigna una categoria a un movimiento bancario. " +
+            "Las categorias se mapean a categorias de gastos para el control de deducciones fiscales.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            id: z.string().describe("Transaction ID / ID del movimiento"),
+            category: z.string().describe("Category slug (e.g. 'supplies', 'travel', 'software') / Categoria"),
+            notes: z.string().optional().describe("Optional notes for this classification / Notas opcionales"),
+        },
+        outputSchema: bankTransactionItemOutput,
+    }, async ({ id, category, notes }) => withToolLogging("categorize_transaction", async () => {
+        const result = await client.categorizeTransaction(id, { category, notes });
+        return {
+            content: [mutateContent(formatRecord("Transaction categorized", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- match_transaction_to_invoice --
+    server.registerTool("match_transaction_to_invoice", {
+        title: "Match Transaction to Invoice",
+        description: "TRUST AREA — RECONCILIATION. Link a bank transaction to an invoice or expense document. " +
+            "This affects fiscal reconciliation records. Requires confirm=true to proceed. " +
+            "Idempotent: re-matching to same document is a no-op. " +
+            "Example: transactionId='tx_abc', documentId='inv_xyz', documentType='invoice', confirm=true " +
+            "/ AREA DE CONFIANZA — CONCILIACION. Vincula un movimiento bancario a una factura o gasto. " +
+            "Afecta registros de conciliacion fiscal. Requiere confirm=true para ejecutar.",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        inputSchema: {
+            transactionId: z.string().describe("Bank transaction ID / ID del movimiento bancario"),
+            documentId: z.string().describe("Invoice or expense ID to link / ID de la factura o gasto a vincular"),
+            documentType: z
+                .enum(["invoice", "expense"])
+                .describe("Type of document being matched / Tipo de documento"),
+            confirm: z
+                .boolean()
+                .describe("Must be true to confirm fiscal reconciliation / Debe ser true para confirmar conciliacion fiscal"),
+            notes: z.string().optional().describe("Optional reconciliation notes / Notas de conciliacion opcionales"),
+        },
+        outputSchema: bankTransactionItemOutput,
+    }, async ({ transactionId, documentId, documentType, confirm, notes }) => withToolLogging("match_transaction_to_invoice", async () => {
+        if (!confirm) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: confirm=true is required to perform fiscal reconciliation. " +
+                            "This action links a bank transaction to a fiscal document and cannot be undone easily. " +
+                            "Set confirm=true when you are certain about the match. / " +
+                            "Se requiere confirm=true para realizar la conciliacion fiscal.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = await client.matchTransactionToDocument(transactionId, { documentId, documentType, notes });
+        return {
+            content: [mutateContent(formatRecord("Transaction matched", result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=banking.js.map

package/dist/tools/banking.js.map

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