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

package/dist/tools/hr.js

@@ -0,0 +1,219 @@
+/**
+ * HR (Human Resources) tools for the Frihet MCP server — D4-B megasprint (9 tools).
+ *
+ * Tools:
+ *   1. leave_request_create — create a leave/PTO request
+ *   2. leave_approve        — approve a pending leave (logs decision)
+ *   3. leave_reject         — reject a pending leave with reason
+ *   4. leave_cancel         — cancel own leave request
+ *   5. leave_list           — list leaves (filter: employee, status, period)
+ *   6. attendance_clock_in  — clock in with optional mood + location
+ *   7. attendance_clock_out — close an open time entry
+ *   8. overtime_report      — aggregated overtime by period
+ *   9. anomaly_list         — list HR/operational anomalies
+ *
+ * REST surface: /v1/leaves, /v1/time-entries, /v1/anomalies
+ *
+ * NOTE: ERP backend endpoints land in parallel D4-A wave. Tools wired —
+ * 404s propagate as isError until backend ships. TODO: wire to CF
+ * logLeaveDecision callable when REST shell lands.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, getContent, mutateContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, UPDATE_ANNOTATIONS, paginatedOutput, leaveRequestItemOutput, attendanceEntryItemOutput, overtimeReportOutput, anomalyItemOutput, } from "./shared.js";
+export function registerHrTools(server, client) {
+    // -- leave_request_create --
+    server.registerTool("leave_request_create", {
+        title: "Create Leave Request",
+        description: "Create a new leave/PTO request for an employee. " +
+            "Types: 'vacation', 'sick', 'personal', 'parental', 'unpaid', 'training'. " +
+            "Dates must be ISO 8601 (YYYY-MM-DD). Status starts as 'pending' awaiting manager approval. " +
+            "/ Crea una nueva solicitud de vacaciones/permiso. Estado inicial 'pending' pendiente aprobacion.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            employeeId: z.string().describe("Employee ID / ID del empleado"),
+            type: z.string().describe("Leave type slug (vacation, sick, personal, parental, unpaid, training) / Tipo de permiso"),
+            startDate: z.string().describe("Start date ISO 8601 (YYYY-MM-DD) / Fecha inicio"),
+            endDate: z.string().describe("End date ISO 8601 (YYYY-MM-DD) / Fecha fin"),
+            reason: z.string().optional().describe("Optional reason / Motivo opcional"),
+        },
+        outputSchema: leaveRequestItemOutput,
+    }, async (input) => withToolLogging("leave_request_create", async () => {
+        const result = await client.createLeaveRequest(input);
+        return {
+            content: [mutateContent(formatRecord("Leave request created", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- leave_approve --
+    server.registerTool("leave_approve", {
+        title: "Approve Leave Request",
+        description: "TRUST AREA — HR DECISION. Approve a pending leave request. Logs decision with timestamp and approver. " +
+            "Idempotent: re-approving an already approved leave is a no-op. " +
+            "/ AREA DE CONFIANZA — DECISION RRHH. Aprueba una solicitud de permiso pendiente. Registra la decision.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            leaveId: z.string().describe("Leave request ID / ID de la solicitud"),
+            reason: z.string().optional().describe("Optional approval note / Nota de aprobacion opcional"),
+        },
+        outputSchema: leaveRequestItemOutput,
+    }, async ({ leaveId, reason }) => withToolLogging("leave_approve", async () => {
+        const result = await client.approveLeave(leaveId, { reason });
+        return {
+            content: [mutateContent(formatRecord("Leave approved", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- leave_reject --
+    server.registerTool("leave_reject", {
+        title: "Reject Leave Request",
+        description: "TRUST AREA — HR DECISION. Reject a pending leave request with a required reason. " +
+            "Reason is mandatory for transparency and labor-law compliance. " +
+            "/ AREA DE CONFIANZA — DECISION RRHH. Rechaza una solicitud con motivo obligatorio.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            leaveId: z.string().describe("Leave request ID / ID de la solicitud"),
+            reason: z.string().min(1).describe("Required rejection reason / Motivo obligatorio de rechazo"),
+        },
+        outputSchema: leaveRequestItemOutput,
+    }, async ({ leaveId, reason }) => withToolLogging("leave_reject", async () => {
+        const result = await client.rejectLeave(leaveId, { reason });
+        return {
+            content: [mutateContent(formatRecord("Leave rejected", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- leave_cancel --
+    server.registerTool("leave_cancel", {
+        title: "Cancel Leave Request",
+        description: "Cancel a leave request. Typically used by the requesting employee before approval, " +
+            "or by HR after approval (which may trigger schedule rollback). " +
+            "/ Cancela una solicitud de permiso (por el empleado o RRHH).",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            leaveId: z.string().describe("Leave request ID / ID de la solicitud"),
+        },
+        outputSchema: leaveRequestItemOutput,
+    }, async ({ leaveId }) => withToolLogging("leave_cancel", async () => {
+        const result = await client.cancelLeave(leaveId);
+        return {
+            content: [mutateContent(formatRecord("Leave cancelled", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- leave_list --
+    server.registerTool("leave_list", {
+        title: "List Leave Requests",
+        description: "List leave/PTO requests with optional filters. " +
+            "Filter by employee, status (pending/approved/rejected/cancelled), or period (date range). " +
+            "Useful for HR dashboards, calendar views, balance tracking. " +
+            "/ Lista solicitudes de permisos con filtros opcionales (empleado, estado, periodo).",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            employeeId: z.string().optional().describe("Filter by employee ID / Filtrar por empleado"),
+            status: z
+                .enum(["pending", "approved", "rejected", "cancelled"])
+                .optional()
+                .describe("Filter by status / Filtrar por estado"),
+            from: z.string().optional().describe("Period start ISO 8601 (YYYY-MM-DD) / Inicio periodo"),
+            to: z.string().optional().describe("Period end ISO 8601 (YYYY-MM-DD) / Fin periodo"),
+            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"),
+        },
+        outputSchema: paginatedOutput(leaveRequestItemOutput),
+    }, async ({ employeeId, status, from, to, limit, offset, after }) => withToolLogging("leave_list", async () => {
+        const result = await client.listLeaves({ employeeId, status, from, to, limit, offset, after });
+        return {
+            content: [listContent(formatPaginatedResponse("leaves", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- attendance_clock_in --
+    server.registerTool("attendance_clock_in", {
+        title: "Clock In (Attendance)",
+        description: "Record an employee clock-in. Optionally captures mood (employee well-being tracking) " +
+            "and location (remote/office/site). Returns an attendance entry with status='open'. " +
+            "Pair with attendance_clock_out to close the entry. " +
+            "/ Registra una entrada de fichaje. Captura opcionalmente estado de animo y ubicacion.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            employeeId: z.string().describe("Employee ID / ID del empleado"),
+            mood: z.string().optional().describe("Optional mood slug (e.g. 'great','ok','tired') / Estado de animo"),
+            location: z.string().optional().describe("Optional location ('remote','office','site') / Ubicacion"),
+        },
+        outputSchema: attendanceEntryItemOutput,
+    }, async (input) => withToolLogging("attendance_clock_in", async () => {
+        const result = await client.attendanceClockIn(input);
+        return {
+            content: [mutateContent(formatRecord("Clocked in", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- attendance_clock_out --
+    server.registerTool("attendance_clock_out", {
+        title: "Clock Out (Attendance)",
+        description: "Close an open attendance entry. Stamps clockOutAt and computes durationMinutes. " +
+            "Idempotent: clocking out an already-closed entry is a no-op. " +
+            "/ Cierra una entrada de fichaje abierta. Calcula la duracion en minutos.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            entryId: z.string().describe("Open attendance entry ID / ID de la entrada abierta"),
+        },
+        outputSchema: attendanceEntryItemOutput,
+    }, async ({ entryId }) => withToolLogging("attendance_clock_out", async () => {
+        const result = await client.attendanceClockOut(entryId);
+        return {
+            content: [mutateContent(formatRecord("Clocked out", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- overtime_report --
+    server.registerTool("overtime_report", {
+        title: "Overtime Report",
+        description: "Generate an overtime report for a period. Aggregates regular vs overtime hours " +
+            "per employee + total estimated cost in EUR. Useful for payroll prep and labor-law audits. " +
+            "Period format: 'YYYY-MM' (monthly) or 'YYYY-QN' (quarterly) or 'YYYY' (annual). " +
+            "/ Informe de horas extra por periodo. Agrega horas regulares vs extra por empleado + coste estimado.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            period: z.string().describe("Period (YYYY-MM, YYYY-QN, or YYYY) / Periodo"),
+            employeeId: z.string().optional().describe("Optional filter by employee / Filtrar por empleado opcional"),
+        },
+        outputSchema: overtimeReportOutput,
+    }, async ({ period, employeeId }) => withToolLogging("overtime_report", async () => {
+        const result = await client.getOvertimeReport({ period, employeeId });
+        return {
+            content: [getContent(formatRecord("Overtime report", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- anomaly_list --
+    server.registerTool("anomaly_list", {
+        title: "List Anomalies",
+        description: "List HR / operational / financial anomalies detected by the system. " +
+            "Filter by type (duplicate_clock_in, overtime_spike, missing_clock_out, expense_outlier, etc.), " +
+            "severity (low/medium/high/critical), or period. " +
+            "Useful for daily HR review and compliance audits. " +
+            "/ Lista anomalias detectadas (RRHH/operativas/financieras) con filtros opcionales.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            type: z.string().optional().describe("Filter by anomaly type slug / Tipo"),
+            severity: z
+                .enum(["low", "medium", "high", "critical"])
+                .optional()
+                .describe("Filter by severity / Severidad"),
+            from: z.string().optional().describe("Period start ISO 8601 / Inicio"),
+            to: z.string().optional().describe("Period end ISO 8601 / Fin"),
+            limit: z.number().int().min(1).max(100).optional().describe("Max results / Maximos"),
+            offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+        },
+        outputSchema: paginatedOutput(anomalyItemOutput),
+    }, async ({ type, severity, from, to, limit, offset }) => withToolLogging("anomaly_list", async () => {
+        const result = await client.listAnomalies({ type, severity, from, to, limit, offset });
+        return {
+            content: [listContent(formatPaginatedResponse("anomalies", result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=hr.js.map

package/dist/tools/hr.js.map

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

package/dist/tools/igic.d.ts

@@ -0,0 +1,19 @@
+/**
+ * IGIC (Canary Islands indirect tax) tools for the Frihet MCP server — Day 1 Megasprint (4 tools).
+ *
+ * Tools:
+ *   1. frihet_modelo_415_summary — M415 operations >€3,005 annual (Canarias)
+ *   2. frihet_modelo_425_summary — M425 resumen anual IGIC (Canarias)
+ *   3. frihet_modelo_418_summary — M418 mensual grandes empresas IGIC (Canarias)
+ *   4. frihet_aiem_calculate     — Arbitrio sobre Importaciones y Entrega de Mercancías calculation
+ *
+ * NOTE: ATC SOAP integration skipped — internal infrastructure, not exposed via MCP.
+ *
+ * REST surface: /v1/igic/* — service-layer reads of workspace fiscal data.
+ *   Backend callables: #390 IGIC services (Frihet-ERP PR #390).
+ *   Tools surface 404 until REST shell ships.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerIgicTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=igic.d.ts.map

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

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

package/dist/tools/igic.js

@@ -0,0 +1,102 @@
+/**
+ * IGIC (Canary Islands indirect tax) tools for the Frihet MCP server — Day 1 Megasprint (4 tools).
+ *
+ * Tools:
+ *   1. frihet_modelo_415_summary — M415 operations >€3,005 annual (Canarias)
+ *   2. frihet_modelo_425_summary — M425 resumen anual IGIC (Canarias)
+ *   3. frihet_modelo_418_summary — M418 mensual grandes empresas IGIC (Canarias)
+ *   4. frihet_aiem_calculate     — Arbitrio sobre Importaciones y Entrega de Mercancías calculation
+ *
+ * NOTE: ATC SOAP integration skipped — internal infrastructure, not exposed via MCP.
+ *
+ * REST surface: /v1/igic/* — service-layer reads of workspace fiscal data.
+ *   Backend callables: #390 IGIC services (Frihet-ERP PR #390).
+ *   Tools surface 404 until REST shell ships.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, READ_ONLY_ANNOTATIONS, } from "./shared.js";
+export function registerIgicTools(server, client) {
+    // -- frihet_modelo_415_summary -------------------------------------------
+    server.registerTool("frihet_modelo_415_summary", {
+        title: "Get Modelo 415 Summary (IGIC Annual Operations >€3,005)",
+        description: "Get IGIC Modelo 415 summary — annual declaration of operations with third parties exceeding €3,005. " +
+            "Canary Islands equivalent of Modelo 347 (peninsular Spain). " +
+            "Returns counterparty list, operation totals, and filing deadline. " +
+            "Example: year='2025'. " +
+            "/ Resumen del Modelo 415 IGIC — declaracion anual de operaciones con terceros > €3.005. " +
+            "Equivalente canario del Modelo 347. Devuelve listado de contrapartes, totales y plazo.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            year: z.string().optional().describe("Tax year (e.g. '2025', defaults to previous year) / Ejercicio fiscal (ej. '2025', por defecto ejercicio anterior)"),
+        },
+    }, async ({ year }) => withToolLogging("frihet_modelo_415_summary", async () => {
+        const result = await client.getIgicModeloSummary("415", { year });
+        return {
+            content: [getContent(formatRecord("Modelo 415 Summary (IGIC)", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- frihet_modelo_425_summary -------------------------------------------
+    server.registerTool("frihet_modelo_425_summary", {
+        title: "Get Modelo 425 Summary (IGIC Annual Recap)",
+        description: "Get IGIC Modelo 425 summary — annual IGIC recap for Canary Islands businesses. " +
+            "Returns aggregated IGIC collected, deductible IGIC, net payable, and filing status. " +
+            "Example: year='2025'. " +
+            "/ Resumen del Modelo 425 IGIC — resumen anual IGIC para empresas canarias. " +
+            "Devuelve IGIC repercutido, IGIC soportado, cuota neta y estado de presentacion.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            year: z.string().optional().describe("Tax year (e.g. '2025', defaults to previous year) / Ejercicio fiscal (ej. '2025', por defecto ejercicio anterior)"),
+        },
+    }, async ({ year }) => withToolLogging("frihet_modelo_425_summary", async () => {
+        const result = await client.getIgicModeloSummary("425", { year });
+        return {
+            content: [getContent(formatRecord("Modelo 425 Summary (IGIC)", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- frihet_modelo_418_summary -------------------------------------------
+    server.registerTool("frihet_modelo_418_summary", {
+        title: "Get Modelo 418 Summary (IGIC Monthly Large Enterprises)",
+        description: "Get IGIC Modelo 418 summary — monthly IGIC return for large enterprises (grandes empresas) in the Canary Islands. " +
+            "Returns monthly IGIC collected, deductible, net due, and any carryover. " +
+            "Applicable when annual turnover exceeds the grandes empresas threshold. " +
+            "Example: period='2026-04'. " +
+            "/ Resumen del Modelo 418 IGIC — declaracion mensual para grandes empresas en Canarias. " +
+            "Devuelve IGIC repercutido, soportado, cuota a ingresar y saldo a compensar.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            period: z.string().optional().describe("Period in YYYY-MM format (defaults to last month) / Periodo YYYY-MM (por defecto mes anterior)"),
+        },
+    }, async ({ period }) => withToolLogging("frihet_modelo_418_summary", async () => {
+        const result = await client.getIgicModeloSummary("418", { period });
+        return {
+            content: [getContent(formatRecord("Modelo 418 Summary (IGIC Monthly)", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- frihet_aiem_calculate ------------------------------------------------
+    server.registerTool("frihet_aiem_calculate", {
+        title: "Calculate AIEM (Arbitrio Importación Canarias)",
+        description: "Calculate the AIEM (Arbitrio sobre Importaciones y Entrega de Mercancias) for goods imported " +
+            "to or produced in the Canary Islands. " +
+            "Returns applicable AIEM rate, tax base, and amount due for the given product. " +
+            "AIEM is a Canarian surcharge on top of IGIC for protected local industries. " +
+            "Example: ncCode='8471', amount=1000, description='Ordenadores portatiles'. " +
+            "/ Calcula el AIEM para mercancias importadas o producidas en Canarias. " +
+            "Devuelve tipo aplicable, base imponible y cuota. El AIEM protege la industria local canaria.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            ncCode: z.string().describe("Nomenclatura Combinada (NC) tariff code / Codigo NC (nomenclatura combinada)"),
+            amount: z.number().describe("Taxable base amount in EUR / Base imponible en EUR"),
+            description: z.string().optional().describe("Product description for audit reference / Descripcion del producto (referencia auditoria)"),
+        },
+    }, async ({ ncCode, amount, description }) => withToolLogging("frihet_aiem_calculate", async () => {
+        const result = await client.calculateAiem({ ncCode, amount, description });
+        return {
+            content: [getContent(formatRecord(`AIEM Calculation (NC: ${ncCode})`, result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=igic.js.map

package/dist/tools/igic.js.map

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

package/dist/tools/impuesto_sociedades.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Impuesto sobre Sociedades (IS) tools for the Frihet MCP server — Day 1 Megasprint (2 tools).
+ *
+ * Tools:
+ *   1. frihet_modelo_200_summary — Modelo 200 IS anual (annual corporate tax return)
+ *   2. frihet_modelo_202_summary — Modelo 202 IS pagos fraccionados (3 installment payments)
+ *
+ * REST surface: /v1/is/* — service-layer reads of workspace IS data.
+ *   Backend callables: #392 Modelo 200/202 IS (Frihet-ERP PR #392).
+ *   Tools surface 404 until REST shell ships.
+ *
+ * Scope: Spanish SLs (Sociedad Limitada) and SAs filing corporate tax with AEAT.
+ * Canary Islands variant: same models apply; ATC collects IS with territorial adjustments.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerImpuestoSociedadesTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=impuesto_sociedades.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"impuesto_sociedades.d.ts","sourceRoot":"","sources":["../../src/tools/impuesto_sociedades.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAQ5D,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA2D9F"}

package/dist/tools/impuesto_sociedades.js

@@ -0,0 +1,64 @@
+/**
+ * Impuesto sobre Sociedades (IS) tools for the Frihet MCP server — Day 1 Megasprint (2 tools).
+ *
+ * Tools:
+ *   1. frihet_modelo_200_summary — Modelo 200 IS anual (annual corporate tax return)
+ *   2. frihet_modelo_202_summary — Modelo 202 IS pagos fraccionados (3 installment payments)
+ *
+ * REST surface: /v1/is/* — service-layer reads of workspace IS data.
+ *   Backend callables: #392 Modelo 200/202 IS (Frihet-ERP PR #392).
+ *   Tools surface 404 until REST shell ships.
+ *
+ * Scope: Spanish SLs (Sociedad Limitada) and SAs filing corporate tax with AEAT.
+ * Canary Islands variant: same models apply; ATC collects IS with territorial adjustments.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, READ_ONLY_ANNOTATIONS, } from "./shared.js";
+export function registerImpuestoSociedadesTools(server, client) {
+    // -- frihet_modelo_200_summary -------------------------------------------
+    server.registerTool("frihet_modelo_200_summary", {
+        title: "Get Modelo 200 Summary (Corporate Tax — Annual IS)",
+        description: "Get Modelo 200 summary — annual corporate income tax return (Impuesto sobre Sociedades) " +
+            "for Spanish SLs and SAs. Returns taxable base, deductions, tax rate, withholdings, " +
+            "installment payments made (M202), and net payable/refundable. " +
+            "Filing deadline: 25 days after 6 months from fiscal year end (typically 25 July for Dec FY). " +
+            "Example: year='2025'. " +
+            "/ Resumen Modelo 200 — declaracion anual del Impuesto sobre Sociedades para SL/SA. " +
+            "Devuelve base imponible, deducciones, tipo, retenciones, pagos fraccionados y cuota.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            year: z.string().optional().describe("Fiscal year (e.g. '2025', defaults to last closed year) / Ejercicio fiscal (ej. '2025', por defecto ultimo ejercicio cerrado)"),
+        },
+    }, async ({ year }) => withToolLogging("frihet_modelo_200_summary", async () => {
+        const result = await client.getISSummary("200", { year });
+        return {
+            content: [getContent(formatRecord("Modelo 200 Summary (IS Anual)", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- frihet_modelo_202_summary -------------------------------------------
+    server.registerTool("frihet_modelo_202_summary", {
+        title: "Get Modelo 202 Summary (Corporate Tax — Installment Payments)",
+        description: "Get Modelo 202 summary — installment payments (pagos fraccionados) for Impuesto sobre Sociedades. " +
+            "Three annual payments: April (1P), October (2P), December (3P). " +
+            "Returns each installment amount, due date, payment status, and cumulative total vs M200 projection. " +
+            "Example: year='2026', installment='1P'. " +
+            "/ Resumen Modelo 202 — pagos fraccionados del Impuesto sobre Sociedades. " +
+            "Tres plazos: abril (1P), octubre (2P), diciembre (3P). Devuelve importes, plazos y estado de pago.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            year: z.string().optional().describe("Fiscal year of the installments (e.g. '2026') / Ejercicio de los pagos fraccionados (ej. '2026')"),
+            installment: z.enum(["1P", "2P", "3P"]).optional().describe("Specific installment (1P=April, 2P=October, 3P=December) or omit for all three / Plazo especifico (1P=abril, 2P=octubre, 3P=diciembre) u omitir para los tres"),
+        },
+    }, async ({ year, installment }) => withToolLogging("frihet_modelo_202_summary", async () => {
+        const result = await client.getISSummary("202", { year, installment });
+        const label = installment
+            ? `Modelo 202 Summary (${installment} ${year ?? ""})`
+            : `Modelo 202 Summary (all installments ${year ?? ""})`;
+        return {
+            content: [getContent(formatRecord(label.trim(), result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=impuesto_sociedades.js.map

package/dist/tools/impuesto_sociedades.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impuesto_sociedades.js","sourceRoot":"","sources":["../../src/tools/impuesto_sociedades.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,UAAU,EACV,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,MAAqB;IACtF,2EAA2E;IAE3E,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,oDAAoD;QAC3D,WAAW,EACT,0FAA0F;YAC1F,qFAAqF;YACrF,gEAAgE;YAChE,+FAA+F;YAC/F,wBAAwB;YACxB,qFAAqF;YACrF,sFAAsF;QACxF,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+HAA+H,CAAC;SACtK;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO;YACL,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,+BAA+B,EAAE,MAAM,CAAC,CAAC,CAAC;YAC5E,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,2EAA2E;IAE3E,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,+DAA+D;QACtE,WAAW,EACT,oGAAoG;YACpG,kEAAkE;YAClE,sGAAsG;YACtG,0CAA0C;YAC1C,2EAA2E;YAC3E,oGAAoG;QACtG,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kGAAkG,CAAC;YACxI,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+JAA+J,CAAC;SAC7N;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,WAAW;YACvB,CAAC,CAAC,uBAAuB,WAAW,IAAI,IAAI,IAAI,EAAE,GAAG;YACrD,CAAC,CAAC,wCAAwC,IAAI,IAAI,EAAE,GAAG,CAAC;QAC1D,OAAO;YACL,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;YACzD,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/onboard_vies.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Self-onboard & VIES tools for the Frihet MCP server — Day 1 Megasprint (2 tools).
+ *
+ * Tools:
+ *   1. frihet_portal_onboard_link_generate — generate a self-onboard link (gestor admin side)
+ *   2. frihet_tax_id_vies_lookup           — validate an EU tax ID via VIES
+ *
+ * Skipped (public portal flows, not appropriate for MCP):
+ *   - validatePortalOnboardToken  — public token validation
+ *   - selfOnboardClient           — self-service client registration (browser flow)
+ *
+ * REST surface: /v1/portal/onboard/* proxies Firebase callables:
+ *   generatePortalOnboardLink, lookupTaxIdViaVIES (eu-west1)
+ *
+ * Backend status (post-Day 1 Megasprint, May 2026):
+ *   Frihet-ERP PR #398 — Self-onboard VIES 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 registerOnboardViesTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=onboard_vies.d.ts.map

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

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

package/dist/tools/onboard_vies.js

@@ -0,0 +1,74 @@
+/**
+ * Self-onboard & VIES tools for the Frihet MCP server — Day 1 Megasprint (2 tools).
+ *
+ * Tools:
+ *   1. frihet_portal_onboard_link_generate — generate a self-onboard link (gestor admin side)
+ *   2. frihet_tax_id_vies_lookup           — validate an EU tax ID via VIES
+ *
+ * Skipped (public portal flows, not appropriate for MCP):
+ *   - validatePortalOnboardToken  — public token validation
+ *   - selfOnboardClient           — self-service client registration (browser flow)
+ *
+ * REST surface: /v1/portal/onboard/* proxies Firebase callables:
+ *   generatePortalOnboardLink, lookupTaxIdViaVIES (eu-west1)
+ *
+ * Backend status (post-Day 1 Megasprint, May 2026):
+ *   Frihet-ERP PR #398 — Self-onboard VIES MERGED.
+ *   Tools will surface 404 errors until backend REST shell ships.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, mutateContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, } from "./shared.js";
+export function registerOnboardViesTools(server, client) {
+    // -- frihet_portal_onboard_link_generate ----------------------------------
+    server.registerTool("frihet_portal_onboard_link_generate", {
+        title: "Generate Portal Self-Onboard Link",
+        description: "Generate a time-limited, single-use self-onboard invitation link for a prospective client. " +
+            "The client follows the link to register their company details (CIF, address, contact) " +
+            "without requiring manual data entry by the gestor. " +
+            "Requires gestor/admin role. " +
+            "Example: email='cliente@empresa.com', expiresInHours=72. " +
+            "/ Genera un enlace de auto-registro para un cliente potencial. " +
+            "El cliente completa sus datos sin que el gestor tenga que introducirlos manualmente. " +
+            "Requiere rol gestor/admin.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            email: z.string().describe("Prospective client email address / Email del cliente potencial"),
+            name: z.string().optional().describe("Prospective client name (pre-fills the form) / Nombre del cliente (pre-rellena el formulario)"),
+            expiresInHours: z.number().int().min(1).max(168).optional()
+                .describe("Link expiry in hours, 1-168 (default 72h) / Caducidad del enlace en horas (por defecto 72h)"),
+            workspaceId: z.string().optional().describe("Target gestor workspace ID / ID del workspace del gestor"),
+        },
+    }, async ({ email, name, expiresInHours, workspaceId }) => withToolLogging("frihet_portal_onboard_link_generate", async () => {
+        const result = await client.generatePortalOnboardLink({ email, name, expiresInHours, workspaceId });
+        return {
+            content: [
+                mutateContent(formatRecord(`Self-onboard link generated for ${email}`, result) +
+                    "\n\nSend this link to the client via email or chat. It is single-use and time-limited." +
+                    "\nEnvia este enlace al cliente por email o chat. Es de uso único y tiene caducidad."),
+            ],
+            structuredContent: result,
+        };
+    }));
+    // -- frihet_tax_id_vies_lookup --------------------------------------------
+    server.registerTool("frihet_tax_id_vies_lookup", {
+        title: "Lookup Tax ID via VIES (EU VAT Validation)",
+        description: "Validate an EU VAT number (CIF intracomunitario) via the VIES (VAT Information Exchange System). " +
+            "Returns company name, address, and validity status from the official EU registry. " +
+            "Essential for intra-EU invoicing compliance — always validate before adding a EU client. " +
+            "Example: vatNumber='ES12345678A', countryCode='ES'. " +
+            "/ Valida un numero de IVA intracomunitario (CIF) via el sistema VIES de la UE. " +
+            "Devuelve nombre, direccion y validez desde el registro oficial europeo.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            vatNumber: z.string().describe("EU VAT number to validate (without country prefix) / Numero de IVA intracomunitario (sin prefijo de pais)"),
+            countryCode: z.string().length(2).describe("ISO 3166-1 alpha-2 country code (e.g. 'ES', 'DE', 'FR') / Codigo de pais ISO (ej. 'ES', 'DE', 'FR')"),
+        },
+    }, async ({ vatNumber, countryCode }) => withToolLogging("frihet_tax_id_vies_lookup", async () => {
+        const result = await client.lookupTaxIdViaVIES({ vatNumber, countryCode });
+        return {
+            content: [getContent(formatRecord(`VIES lookup: ${countryCode}${vatNumber}`, result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=onboard_vies.js.map

package/dist/tools/onboard_vies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard_vies.js","sourceRoot":"","sources":["../../src/tools/onboard_vies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,MAAqB;IAC/E,4EAA4E;IAE5E,MAAM,CAAC,YAAY,CACjB,qCAAqC,EACrC;QACE,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EACT,6FAA6F;YAC7F,wFAAwF;YACxF,qDAAqD;YACrD,8BAA8B;YAC9B,2DAA2D;YAC3D,iEAAiE;YACjE,uFAAuF;YACvF,4BAA4B;QAC9B,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;YAC5F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+FAA+F,CAAC;YACrI,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;iBACxD,QAAQ,CAAC,6FAA6F,CAAC;YAC1G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;SACxG;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACxH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;QACpG,OAAO;YACL,OAAO,EAAE;gBACP,aAAa,CACX,YAAY,CAAC,mCAAmC,KAAK,EAAE,EAAE,MAAM,CAAC;oBAChE,wFAAwF;oBACxF,qFAAqF,CACtF;aACF;YACD,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,4EAA4E;IAE5E,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,4CAA4C;QACnD,WAAW,EACT,mGAAmG;YACnG,oFAAoF;YACpF,2FAA2F;YAC3F,sDAAsD;YACtD,iFAAiF;YACjF,yEAAyE;QAC3E,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2GAA2G,CAAC;YAC3I,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qGAAqG,CAAC;SAClJ;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAC3E,OAAO;YACL,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,gBAAgB,WAAW,GAAG,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;YACtF,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/onboarding.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Onboarding tools for the Frihet MCP server — D4-B megasprint (2 tools).
+ *
+ * Tools:
+ *   1. onboarding_status      — current workspace onboarding state (completed/pending steps)
+ *   2. onboarding_persona_set — set workspace persona (autonomo/empresa/agencia/gestoria)
+ *
+ * REST surface: /v1/onboarding/status, /v1/onboarding/persona
+ *
+ * Persona drives module visibility + default chart-of-accounts + onboarding checklist.
+ * Persona can only be set once during onboarding; later changes require workspace admin.
+ *
+ * NOTE: ERP backend endpoints land in parallel D4-A wave. 404s propagate as isError
+ * until backend ships.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerOnboardingTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=onboarding.d.ts.map

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

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