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

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"}

package/dist/tools/onboarding.js

@@ -0,0 +1,63 @@
+/**
+ * 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 { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, mutateContent, READ_ONLY_ANNOTATIONS, UPDATE_ANNOTATIONS, onboardingStatusOutput, onboardingPersonaResultOutput, } from "./shared.js";
+export function registerOnboardingTools(server, client) {
+    // -- onboarding_status --
+    server.registerTool("onboarding_status", {
+        title: "Onboarding Status",
+        description: "Return the current workspace onboarding state — persona, completed steps, pending steps, " +
+            "percent complete. Useful to drive in-app guidance, sales follow-up triggers, " +
+            "and partner program tracking. " +
+            "/ Devuelve el estado actual del onboarding del workspace (persona, pasos completados/pendientes).",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {},
+        outputSchema: onboardingStatusOutput,
+    }, async () => withToolLogging("onboarding_status", async () => {
+        const result = await client.getOnboardingStatus();
+        return {
+            content: [getContent(formatRecord("Onboarding status", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- onboarding_persona_set --
+    server.registerTool("onboarding_persona_set", {
+        title: "Set Onboarding Persona",
+        description: "Set the workspace persona. Drives module visibility, default chart-of-accounts, " +
+            "and onboarding checklist. Personas:\n" +
+            "  - 'autonomo' — self-employed (autonomo Spain)\n" +
+            "  - 'empresa'  — small/medium business\n" +
+            "  - 'agencia'  — agency / consultancy\n" +
+            "  - 'gestoria' — accounting firm (manages multiple client workspaces)\n" +
+            "\n" +
+            "Idempotent: setting the same persona again is a no-op. " +
+            "/ Define la persona del workspace. Determina modulos visibles, plan contable y checklist.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            persona: z
+                .enum(["autonomo", "empresa", "agencia", "gestoria"])
+                .describe("Workspace persona / Persona del workspace"),
+        },
+        outputSchema: onboardingPersonaResultOutput,
+    }, async ({ persona }) => withToolLogging("onboarding_persona_set", async () => {
+        const result = await client.setOnboardingPersona({ persona });
+        return {
+            content: [mutateContent(formatRecord("Persona set", result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/tools/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/tools/onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAqB;IAC9E,0BAA0B;IAE1B,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,2FAA2F;YAC3F,+EAA+E;YAC/E,gCAAgC;YAChC,mGAAmG;QACrG,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,sBAAsB;KACrC,EACD,KAAK,IAAI,EAAE,CAAC,eAAe,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAClD,OAAO;YACL,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;YAChE,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,+BAA+B;IAE/B,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,kFAAkF;YAClF,uCAAuC;YACvC,mDAAmD;YACnD,0CAA0C;YAC1C,yCAAyC;YACzC,yEAAyE;YACzE,IAAI;YACJ,yDAAyD;YACzD,2FAA2F;QAC7F,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;iBACpD,QAAQ,CAAC,2CAA2C,CAAC;SACzD;QACD,YAAY,EAAE,6BAA6B;KAC5C,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9D,OAAO;YACL,OAAO,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;YAC7D,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/payroll.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Payroll preparation tools for the Frihet MCP server — D4-B megasprint (2 tools).
+ *
+ * Tools:
+ *   1. payroll_export    — export payroll for a month in gestoria format (A3, Contasol, Sage, Holded, Siltra)
+ *   2. payroll_checklist — list employees with status (ready / missing_data / blocked) for a month
+ *
+ * REST surface: /v1/payroll/prep/export, /v1/payroll/prep/employees
+ *
+ * Frihet does NOT process payroll. It exports to gestoria-compatible formats so
+ * the asesoria handles SS/IRPF/contracts. Output formats track the most common
+ * Spanish payroll software clusters.
+ *
+ * NOTE: ERP backend endpoints land in parallel D4-A wave. 404s propagate as isError
+ * until backend ships. TODO: confirm A3 columns + SILTRA file extension.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerPayrollTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=payroll.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payroll.d.ts","sourceRoot":"","sources":["../../src/tools/payroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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,CAkEnF"}

package/dist/tools/payroll.js

@@ -0,0 +1,73 @@
+/**
+ * Payroll preparation tools for the Frihet MCP server — D4-B megasprint (2 tools).
+ *
+ * Tools:
+ *   1. payroll_export    — export payroll for a month in gestoria format (A3, Contasol, Sage, Holded, Siltra)
+ *   2. payroll_checklist — list employees with status (ready / missing_data / blocked) for a month
+ *
+ * REST surface: /v1/payroll/prep/export, /v1/payroll/prep/employees
+ *
+ * Frihet does NOT process payroll. It exports to gestoria-compatible formats so
+ * the asesoria handles SS/IRPF/contracts. Output formats track the most common
+ * Spanish payroll software clusters.
+ *
+ * NOTE: ERP backend endpoints land in parallel D4-A wave. 404s propagate as isError
+ * until backend ships. TODO: confirm A3 columns + SILTRA file extension.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, READ_ONLY_ANNOTATIONS, payrollExportOutput, payrollChecklistOutput, } from "./shared.js";
+export function registerPayrollTools(server, client) {
+    // -- payroll_export --
+    server.registerTool("payroll_export", {
+        title: "Export Payroll (Gestoria Format)",
+        description: "Export payroll data for a month in gestoria-compatible format. " +
+            "Supported formats:\n" +
+            "  - 'a3'       — Wolters Kluwer A3 (CSV with Spanish payroll columns)\n" +
+            "  - 'contasol' — Sage Contasol\n" +
+            "  - 'sage'     — Sage 50/200\n" +
+            "  - 'holded'   — Holded import format\n" +
+            "  - 'siltra'   — SILTRA Seguridad Social XML\n" +
+            "\n" +
+            "Frihet does NOT calculate payroll — it exports staged data for the gestoria. " +
+            "Month format: 'YYYY-MM'. " +
+            "/ Exporta datos de nominas en formato compatible con gestoria. Mes en formato 'YYYY-MM'.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            format: z
+                .enum(["a3", "contasol", "sage", "holded", "siltra"])
+                .describe("Gestoria payroll software format / Formato del software de gestoria"),
+            month: z.string().regex(/^\d{4}-\d{2}$/).describe("Month in 'YYYY-MM' format / Mes formato 'YYYY-MM'"),
+        },
+        outputSchema: payrollExportOutput,
+    }, async ({ format, month }) => withToolLogging("payroll_export", async () => {
+        const result = await client.exportPayroll({ format, month });
+        return {
+            content: [getContent(formatRecord("Payroll export", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- payroll_checklist --
+    server.registerTool("payroll_checklist", {
+        title: "Payroll Readiness Checklist",
+        description: "List all employees for a given month with their payroll readiness status. " +
+            "Status values:\n" +
+            "  - 'ready'         — all required data present, ready to export\n" +
+            "  - 'missing_data'  — some required fields missing (see missingFields[])\n" +
+            "  - 'blocked'       — manually blocked or data inconsistency detected\n" +
+            "\n" +
+            "Use BEFORE payroll_export to identify gaps. Month format: 'YYYY-MM'. " +
+            "/ Lista empleados con estado de preparacion para nomina. Usar antes de payroll_export.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            month: z.string().regex(/^\d{4}-\d{2}$/).describe("Month in 'YYYY-MM' format / Mes formato 'YYYY-MM'"),
+        },
+        outputSchema: payrollChecklistOutput,
+    }, async ({ month }) => withToolLogging("payroll_checklist", async () => {
+        const result = await client.getPayrollChecklist({ month });
+        return {
+            content: [getContent(formatRecord("Payroll checklist", result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=payroll.js.map

package/dist/tools/payroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payroll.js","sourceRoot":"","sources":["../../src/tools/payroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAqB;IAC3E,uBAAuB;IAEvB,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,kCAAkC;QACzC,WAAW,EACT,iEAAiE;YACjE,sBAAsB;YACtB,yEAAyE;YACzE,kCAAkC;YAClC,gCAAgC;YAChC,yCAAyC;YACzC,gDAAgD;YAChD,IAAI;YACJ,+EAA+E;YAC/E,2BAA2B;YAC3B,0FAA0F;QAC5F,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;iBACpD,QAAQ,CAAC,qEAAqE,CAAC;YAClF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;SACvG;QACD,YAAY,EAAE,mBAAmB;KAClC,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,OAAO;YACL,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;YAC7D,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,0BAA0B;IAE1B,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,4EAA4E;YAC5E,kBAAkB;YAClB,oEAAoE;YACpE,4EAA4E;YAC5E,yEAAyE;YACzE,IAAI;YACJ,uEAAuE;YACvE,wFAAwF;QAC1F,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;SACvG;QACD,YAAY,EAAE,sBAAsB;KACrC,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;YAChE,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/permissions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Permissions tools for the Frihet MCP server — D4-B megasprint (2 tools).
+ *
+ * Tools:
+ *   1. permissions_matrix — full role/permission matrix for the workspace
+ *   2. permissions_me     — caller's own role + permissions
+ *
+ * REST surface: /v1/permissions/matrix, /v1/permissions/me
+ *
+ * Permissions are derived from role + workspace overrides. Tools are read-only —
+ * mutating roles is done via team_invite / team_role_update (existing).
+ *
+ * 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 registerPermissionsTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=permissions.d.ts.map

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

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

package/dist/tools/permissions.js

@@ -0,0 +1,52 @@
+/**
+ * Permissions tools for the Frihet MCP server — D4-B megasprint (2 tools).
+ *
+ * Tools:
+ *   1. permissions_matrix — full role/permission matrix for the workspace
+ *   2. permissions_me     — caller's own role + permissions
+ *
+ * REST surface: /v1/permissions/matrix, /v1/permissions/me
+ *
+ * Permissions are derived from role + workspace overrides. Tools are read-only —
+ * mutating roles is done via team_invite / team_role_update (existing).
+ *
+ * NOTE: ERP backend endpoints land in parallel D4-A wave. 404s propagate as isError
+ * until backend ships.
+ */
+import { withToolLogging, formatRecord, getContent, READ_ONLY_ANNOTATIONS, permissionsMatrixOutput, permissionsMeOutput, } from "./shared.js";
+export function registerPermissionsTools(server, client) {
+    // -- permissions_matrix --
+    server.registerTool("permissions_matrix", {
+        title: "Permissions Matrix",
+        description: "Return the full role-to-permission matrix for the workspace. " +
+            "Lists every role with the permissions it grants and every protected resource. " +
+            "Useful for security audits, role design, and compliance reporting. " +
+            "/ Devuelve la matriz completa de roles y permisos del workspace.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {},
+        outputSchema: permissionsMatrixOutput,
+    }, async () => withToolLogging("permissions_matrix", async () => {
+        const result = await client.getPermissionsMatrix();
+        return {
+            content: [getContent(formatRecord("Permissions matrix", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- permissions_me --
+    server.registerTool("permissions_me", {
+        title: "My Permissions",
+        description: "Return the caller's effective role + permissions in the current workspace. " +
+            "Useful for client-side UI gating, debugging access errors, and capability discovery. " +
+            "/ Devuelve el rol efectivo y los permisos del llamante en el workspace actual.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {},
+        outputSchema: permissionsMeOutput,
+    }, async () => withToolLogging("permissions_me", async () => {
+        const result = await client.getMyPermissions();
+        return {
+            content: [getContent(formatRecord("My permissions", result))],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=permissions.js.map

package/dist/tools/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/tools/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,MAAqB;IAC/E,2BAA2B;IAE3B,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,+DAA+D;YAC/D,gFAAgF;YAChF,qEAAqE;YACrE,kEAAkE;QACpE,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,uBAAuB;KACtC,EACD,KAAK,IAAI,EAAE,CAAC,eAAe,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,oBAAoB,EAAE,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;YACjE,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,uBAAuB;IAEvB,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,6EAA6E;YAC7E,uFAAuF;YACvF,gFAAgF;QAClF,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,mBAAmB;KAClC,EACD,KAAK,IAAI,EAAE,CAAC,eAAe,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/C,OAAO;YACL,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;YAC7D,iBAAiB,EAAE,MAA4C;SAChE,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}