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

package/dist/tools/einvoice.js

@@ -0,0 +1,400 @@
+/**
+ * E-Invoicing tools for the Frihet MCP server.
+ *
+ * Wired to real CF endpoints at api.frihet.io/v1/einvoice/*.
+ * 404-fallback: if the CF endpoint is not yet deployed, returns a stub with
+ * { _stub: true, _note: "CF endpoint pending deploy", _plannedEndpoint: "..." }
+ * so the MCP server remains usable while the transport Wave ships.
+ *
+ * All 4 tools use the shared withToolLogging wrapper (Langfuse tracing applied
+ * globally via patchServerWithTracing in register-all.ts).
+ *
+ * Trace names prefix: mcp.einvoice.*
+ * CF endpoints: https://api.frihet.io/v1/einvoice/{send,status,validate,export-datev}
+ */
+import { z } from "zod/v4";
+import { withToolLogging, mutateContent, getContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, } from "./shared.js";
+/* ------------------------------------------------------------------ */
+/*  Shared format union                                                 */
+/* ------------------------------------------------------------------ */
+/**
+ * All supported e-invoice formats.
+ *
+ * | Format                  | Standard  | Markets                  | Notes                                              |
+ * |-------------------------|-----------|--------------------------|---------------------------------------------------|
+ * | xrechnung-cii           | EN16931   | Germany (DE mandatory)   | CII syntax, official DE B2G format                |
+ * | xrechnung-ubl           | EN16931   | Germany (DE mandatory)   | UBL 2.1 syntax, alternative DE B2G                |
+ * | facturx-en16931         | EN16931   | France, EU               | PDF/A-3 embedded XML, Factur-X EN16931 profile     |
+ * | facturx-extended        | EN16931+  | France, EU               | Factur-X Extended — extra logistics/trade fields   |
+ * | facturx-basic           | EN16931   | France, EU               | Factur-X Basic — reduced field set                 |
+ * | facturx-minimum         | EN16931   | France, EU               | Factur-X Minimum — summary invoices only           |
+ * | fatturapa               | SDI       | Italy (IT mandatory)     | XML FatturaPA — sent via SDI interchange hub       |
+ * | ubl                     | UBL 2.1   | EU/global                | Generic UBL — use when no country-specific needed  |
+ * | cii                     | UN/CEFACT | EU/global                | Generic CII — Cross Industry Invoice XML           |
+ * | peppol-bis-3            | PEPPOL    | EU/Nordic/AU/SG          | PEPPOL BIS Billing 3.0 — B2B/B2G network          |
+ * | facturae               | Facturae  | Spain (ES B2G mandatory) | Facturae 3.2.x — AEAT/FACe submission              |
+ */
+export const eInvoiceFormatSchema = z.enum([
+    "xrechnung-cii",
+    "xrechnung-ubl",
+    "facturx-en16931",
+    "facturx-extended",
+    "facturx-basic",
+    "facturx-minimum",
+    "fatturapa",
+    "ubl",
+    "cii",
+    "peppol-bis-3",
+    "facturae",
+]);
+/* ------------------------------------------------------------------ */
+/*  Output schemas                                                      */
+/* ------------------------------------------------------------------ */
+export const sendEInvoiceOutput = z.object({
+    workflowRunId: z.string().describe("Hatchet workflow run ID for polling status"),
+    status: z.literal("queued").describe("Always 'queued' for async dispatch"),
+    estimatedCompletionSec: z.number().describe("Estimated seconds until the workflow completes"),
+}).passthrough();
+export const eInvoiceStatusOutput = z.object({
+    status: z.enum(["queued", "running", "succeeded", "failed", "cancelled"]),
+    step: z.string().describe("Current or last workflow step name"),
+    error: z.string().optional().describe("Error message if status is 'failed'"),
+    ackId: z.string().optional().describe("Network acknowledgement ID (PEPPOL SBDH / SDI protocol ID / etc.)"),
+    pdfA3Url: z.string().optional().describe("Signed URL to download the PDF/A-3 envelope (Factur-X only)"),
+    xmlUrl: z.string().optional().describe("Signed URL to download the raw XML file"),
+}).passthrough();
+export const validateEInvoiceOutput = z.object({
+    valid: z.boolean().describe("Whether the XML passes all validation rules"),
+    errors: z.array(z.object({
+        severity: z.string().describe("'error' | 'warning' | 'info'"),
+        location: z.string().describe("XPath or element path where the issue was found"),
+        message: z.string().describe("Human-readable validation message"),
+        rule: z.string().describe("Rule ID (e.g. 'BR-01', 'PEPPOL-EN16931-R001')"),
+    })).describe("List of validation findings (empty if valid)"),
+    validator: z.enum(["kosit", "mustang", "xsd", "schematron"]).describe("Validation engine used"),
+    durationMs: z.number().describe("Validation duration in milliseconds"),
+}).passthrough();
+export const exportDatevOutput = z.object({
+    fileUrl: z.string().describe("Signed URL to download the DATEV EXTF file"),
+    filename: z.string().describe("Suggested filename (e.g. EXTF_Buchungsstapel_2026-01.csv)"),
+    rowCount: z.number().describe("Number of accounting rows in the export"),
+    fiscalPeriod: z.string().describe("Fiscal period covered (e.g. '2026-01' or '2026-Q1')"),
+    encoding: z.literal("cp1252").describe("File encoding — always CP1252 per DATEV EXTF spec"),
+}).passthrough();
+/* ------------------------------------------------------------------ */
+/*  Tool registration                                                   */
+/* ------------------------------------------------------------------ */
+export function registerEInvoiceTools(server, _client) {
+    // -- send_einvoice --
+    server.registerTool("send_einvoice", {
+        title: "Send E-Invoice",
+        description: "Dispatch an e-invoice to the recipient via the selected transport channel. " +
+            "Returns immediately with a workflowRunId — use get_einvoice_status to poll until completion. " +
+            "\n\n" +
+            "Supported formats (11 total):\n" +
+            "  • xrechnung-cii — XRechnung CII syntax (Germany B2G mandatory)\n" +
+            "  • xrechnung-ubl — XRechnung UBL 2.1 syntax (Germany B2G alternative)\n" +
+            "  • facturx-en16931 — Factur-X EN16931 PDF/A-3 (France, EU)\n" +
+            "  • facturx-extended — Factur-X Extended with trade/logistics fields (France, EU)\n" +
+            "  • facturx-basic — Factur-X Basic reduced field set (France, EU)\n" +
+            "  • facturx-minimum — Factur-X Minimum for summary invoices (France, EU)\n" +
+            "  • fatturapa — FatturaPA XML via SDI hub (Italy mandatory)\n" +
+            "  • ubl — Generic UBL 2.1 XML (EU/global)\n" +
+            "  • cii — Generic CII Cross Industry Invoice (EU/global)\n" +
+            "  • peppol-bis-3 — PEPPOL BIS Billing 3.0 network (EU/Nordic/AU/SG)\n" +
+            "  • facturae — Facturae 3.2.x (Spain B2G via FACe/AEAT mandatory)\n" +
+            "\n" +
+            "Dispatch modes:\n" +
+            "  • email — attach XML/PDF and send via Resend to client email on file\n" +
+            "  • chorus_pro — submit to French Chorus Pro portal (facturx-* only)\n" +
+            "  • sdi — submit to Italian SDI hub (fatturapa only)\n" +
+            "  • peppol — transmit via PEPPOL access point (peppol-bis-3 only)\n" +
+            "  • download — generate and return a signed download URL only\n" +
+            "\n" +
+            "NOTE: Stub response — real CF endpoint https://api.frihet.io/v1/einvoice/send wired in transport Wave. " +
+            "/ Envia una factura electronica al destinatario mediante el canal de transporte seleccionado. " +
+            "Devuelve de forma asincrona — consultar get_einvoice_status para seguimiento.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            invoiceId: z.string().describe("Frihet invoice ID to dispatch / ID de la factura a enviar"),
+            format: eInvoiceFormatSchema.describe("E-invoice format. Choose based on recipient country and channel: " +
+                "DE→xrechnung-cii/ubl, FR→facturx-*, IT→fatturapa, ES B2G→facturae, EU PEPPOL→peppol-bis-3, " +
+                "generic→ubl or cii / Formato de factura electronica."),
+            dispatchMode: z.enum(["email", "chorus_pro", "sdi", "peppol", "download"]).describe("Transport channel: email=send via Resend, chorus_pro=French portal, sdi=Italian SDI hub, " +
+                "peppol=PEPPOL network, download=generate URL only / Canal de transporte."),
+        },
+        outputSchema: sendEInvoiceOutput,
+    }, async ({ invoiceId, format, dispatchMode }) => withToolLogging("send_einvoice", async () => {
+        const plannedEndpoint = "/v1/einvoice/send";
+        try {
+            const result = await _client.sendEInvoice({ invoiceId, format, dispatchMode });
+            return {
+                content: [
+                    mutateContent(`E-invoice queued:\n` +
+                        `  Invoice: ${invoiceId}\n` +
+                        `  Format: ${format}\n` +
+                        `  Dispatch: ${dispatchMode}\n` +
+                        `  WorkflowRunId: ${result.workflowRunId}\n` +
+                        `  Status: ${result.status}\n` +
+                        `  Estimated: ~${result.estimatedCompletionSec}s\n\n` +
+                        `Use get_einvoice_status with the workflowRunId to poll for completion.`),
+                ],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                const stubResult = {
+                    workflowRunId: `wfr_stub_${Date.now()}`,
+                    status: "queued",
+                    estimatedCompletionSec: 15,
+                    _stub: true,
+                    _note: "CF endpoint pending deploy",
+                    _plannedEndpoint: plannedEndpoint,
+                };
+                return {
+                    content: [
+                        mutateContent(`E-invoice queued (stub — CF pending deploy):\n` +
+                            `  Invoice: ${invoiceId}\n` +
+                            `  Format: ${format}\n` +
+                            `  Dispatch: ${dispatchMode}\n` +
+                            `  WorkflowRunId: ${stubResult.workflowRunId}\n` +
+                            `  Status: queued\n` +
+                            `  Estimated: ~${stubResult.estimatedCompletionSec}s\n\n` +
+                            `Use get_einvoice_status with the workflowRunId to poll for completion.`),
+                    ],
+                    structuredContent: stubResult,
+                };
+            }
+            throw err;
+        }
+    }));
+    // -- get_einvoice_status --
+    server.registerTool("get_einvoice_status", {
+        title: "Get E-Invoice Status",
+        description: "Poll the status of an e-invoice dispatch workflow. " +
+            "Returns current step, ack ID (network confirmation), and download URLs once complete. " +
+            "Poll every 5–10 seconds until status is 'succeeded', 'failed', or 'cancelled'. " +
+            "\n\n" +
+            "NOTE: Stub response — real CF endpoint https://api.frihet.io/v1/einvoice/status wired in transport Wave. " +
+            "/ Consulta el estado de un flujo de envio de factura electronica.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            workflowRunId: z.string().describe("Hatchet workflow run ID returned by send_einvoice / ID del run de workflow"),
+        },
+        outputSchema: eInvoiceStatusOutput,
+    }, async ({ workflowRunId }) => withToolLogging("get_einvoice_status", async () => {
+        const plannedEndpoint = `/v1/einvoice/status/${workflowRunId}`;
+        try {
+            const result = await _client.getEInvoiceStatus(workflowRunId);
+            return {
+                content: [
+                    getContent(`E-invoice status:\n` +
+                        `  WorkflowRunId: ${workflowRunId}\n` +
+                        `  Status: ${result.status}\n` +
+                        `  Step: ${result.step}\n` +
+                        (result.ackId ? `  AckId: ${result.ackId}\n` : "") +
+                        (result.xmlUrl ? `  XML URL: ${result.xmlUrl}\n` : "") +
+                        (result.pdfA3Url ? `  PDF/A-3 URL: ${result.pdfA3Url}\n` : "")),
+                ],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                const stubResult = {
+                    status: "succeeded",
+                    step: "dispatch_complete",
+                    ackId: `ack_stub_${workflowRunId.slice(-8)}`,
+                    pdfA3Url: undefined,
+                    xmlUrl: `https://storage.frihet.io/stub/${workflowRunId}.xml`,
+                    _stub: true,
+                    _note: "CF endpoint pending deploy",
+                    _plannedEndpoint: plannedEndpoint,
+                };
+                return {
+                    content: [
+                        getContent(`E-invoice status (stub — CF pending deploy):\n` +
+                            `  WorkflowRunId: ${workflowRunId}\n` +
+                            `  Status: ${stubResult.status}\n` +
+                            `  Step: ${stubResult.step}\n` +
+                            `  AckId: ${stubResult.ackId}\n` +
+                            `  XML URL: ${stubResult.xmlUrl}`),
+                    ],
+                    structuredContent: stubResult,
+                };
+            }
+            throw err;
+        }
+    }));
+    // -- validate_einvoice_xml --
+    server.registerTool("validate_einvoice_xml", {
+        title: "Validate E-Invoice XML",
+        description: "Validate an e-invoice XML document against the specified format's schema and schematron rules. " +
+            "Returns a list of errors with severity, XPath location, message, and rule ID. " +
+            "Runs KOSIT validator (XRechnung), Mustang (EN16931), XSD, or Schematron depending on format. " +
+            "\n\n" +
+            "Use before dispatch to catch errors early without incurring network transmission costs. " +
+            "A valid=true response means the document passes all schema + business rule checks. " +
+            "\n\n" +
+            "NOTE: Stub response — real CF endpoint https://api.frihet.io/v1/einvoice/validate wired in transport Wave. " +
+            "/ Valida un documento XML de factura electronica contra el esquema y reglas schematron del formato especificado.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            xml: z.string().describe("Raw XML string of the e-invoice document to validate / Contenido XML de la factura electronica"),
+            format: eInvoiceFormatSchema.describe("Format to validate against. Determines which validator and ruleset to apply. " +
+                "/ Formato a validar. Determina el validador y conjunto de reglas a aplicar."),
+        },
+        outputSchema: validateEInvoiceOutput,
+    }, async ({ xml, format }) => withToolLogging("validate_einvoice_xml", async () => {
+        const plannedEndpoint = "/v1/einvoice/validate";
+        const validatorMap = {
+            "xrechnung-cii": "kosit",
+            "xrechnung-ubl": "kosit",
+            "facturx-en16931": "mustang",
+            "facturx-extended": "mustang",
+            "facturx-basic": "mustang",
+            "facturx-minimum": "mustang",
+            "fatturapa": "xsd",
+            "ubl": "schematron",
+            "cii": "schematron",
+            "peppol-bis-3": "schematron",
+            "facturae": "xsd",
+        };
+        try {
+            const result = await _client.validateEInvoiceXml({ xml, format });
+            return {
+                content: [
+                    getContent(`E-invoice validation result:\n` +
+                        `  Format: ${format}\n` +
+                        `  Valid: ${result.valid}\n` +
+                        `  Errors: ${result.errors.length}\n` +
+                        `  Validator: ${result.validator}\n` +
+                        `  Duration: ${result.durationMs}ms`),
+                ],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                const stubResult = {
+                    valid: true,
+                    errors: [],
+                    validator: validatorMap[format],
+                    durationMs: 42,
+                    _stub: true,
+                    _note: "CF endpoint pending deploy",
+                    _plannedEndpoint: plannedEndpoint,
+                };
+                return {
+                    content: [
+                        getContent(`E-invoice validation result (stub — CF pending deploy):\n` +
+                            `  Format: ${format}\n` +
+                            `  Valid: ${stubResult.valid}\n` +
+                            `  Errors: ${stubResult.errors.length}\n` +
+                            `  Validator: ${stubResult.validator}\n` +
+                            `  Duration: ${stubResult.durationMs}ms`),
+                    ],
+                    structuredContent: stubResult,
+                };
+            }
+            throw err;
+        }
+    }));
+    // -- export_datev --
+    server.registerTool("export_datev", {
+        title: "Export DATEV",
+        description: "Export accounting data in DATEV EXTF format for import into DATEV Kanzlei-Rechnungswesen or compatible systems. " +
+            "Returns a signed download URL valid for 24 hours. " +
+            "\n\n" +
+            "Supported EXTF formats:\n" +
+            "  • extf-buchungsstapel — Journal entries (Buchungsstapel) — most common, use for P&L/tax\n" +
+            "  • extf-debitoren — Accounts receivable master data (Debitoren-/Kreditorenstamm AR)\n" +
+            "  • extf-kreditoren — Accounts payable master data (Debitoren-/Kreditorenstamm AP)\n" +
+            "\n" +
+            "Output encoding is always CP1252 per DATEV EXTF specification. " +
+            "Date range: both periodStart and periodEnd must be ISO 8601 dates (YYYY-MM-DD). " +
+            "\n\n" +
+            "NOTE: Stub response — real CF endpoint https://api.frihet.io/v1/datev/export wired in transport Wave. " +
+            "/ Exporta datos contables en formato DATEV EXTF para importacion en DATEV o sistemas compatibles.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            periodStart: z.string().describe("Start of the export period (ISO 8601 YYYY-MM-DD). Inclusive. " +
+                "/ Inicio del periodo de exportacion (YYYY-MM-DD). Inclusivo."),
+            periodEnd: z.string().describe("End of the export period (ISO 8601 YYYY-MM-DD). Inclusive. " +
+                "/ Fin del periodo de exportacion (YYYY-MM-DD). Inclusivo."),
+            format: z.enum(["extf-buchungsstapel", "extf-debitoren", "extf-kreditoren"]).describe("DATEV EXTF export format: extf-buchungsstapel (journal entries), " +
+                "extf-debitoren (AR master), extf-kreditoren (AP master) / Formato EXTF de DATEV."),
+        },
+        outputSchema: exportDatevOutput,
+    }, async ({ periodStart, periodEnd, format }) => withToolLogging("export_datev", async () => {
+        const plannedEndpoint = "/v1/einvoice/export-datev";
+        const formatFileMap = {
+            "extf-buchungsstapel": "EXTF_Buchungsstapel",
+            "extf-debitoren": "EXTF_Debitoren",
+            "extf-kreditoren": "EXTF_Kreditoren",
+        };
+        const periodLabel = periodStart.slice(0, 7); // YYYY-MM
+        try {
+            const result = await _client.exportDatev({ periodStart, periodEnd, format });
+            return {
+                content: [
+                    getContent(`DATEV export ready:\n` +
+                        `  Format: ${format}\n` +
+                        `  Period: ${periodStart} → ${periodEnd}\n` +
+                        `  Filename: ${result.filename}\n` +
+                        `  Rows: ${result.rowCount}\n` +
+                        `  Encoding: ${result.encoding}\n` +
+                        `  Download URL: ${result.fileUrl}`),
+                ],
+                structuredContent: result,
+            };
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                const filename = `${formatFileMap[format]}_${periodLabel}.csv`;
+                const stubResult = {
+                    fileUrl: `https://storage.frihet.io/stub/datev/${filename}`,
+                    filename,
+                    rowCount: 0,
+                    fiscalPeriod: periodLabel,
+                    encoding: "cp1252",
+                    _stub: true,
+                    _note: "CF endpoint pending deploy",
+                    _plannedEndpoint: plannedEndpoint,
+                };
+                return {
+                    content: [
+                        getContent(`DATEV export ready (stub — CF pending deploy):\n` +
+                            `  Format: ${format}\n` +
+                            `  Period: ${periodStart} → ${periodEnd}\n` +
+                            `  Filename: ${stubResult.filename}\n` +
+                            `  Rows: ${stubResult.rowCount}\n` +
+                            `  Encoding: ${stubResult.encoding}\n` +
+                            `  Download URL: ${stubResult.fileUrl}`),
+                    ],
+                    structuredContent: stubResult,
+                };
+            }
+            throw err;
+        }
+    }));
+}
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                             */
+/* ------------------------------------------------------------------ */
+/**
+ * Returns true if the error is a 404 Not Found, indicating the CF endpoint
+ * is not yet deployed. Detects both FrihetApiError shape and generic HTTP errors.
+ */
+function isNotFoundError(err) {
+    if (err && typeof err === "object") {
+        const e = err;
+        if (e["statusCode"] === 404)
+            return true;
+        if (e["status"] === 404)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=einvoice.js.map

package/dist/tools/einvoice.js.map

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

package/dist/tools/fiscal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Fiscal tools for the Frihet MCP server — Wave 6 (8 tools).
+ *
+ * Tools:
+ *   1. get_modelo_303_summary   — IVA quarterly Spain
+ *   2. get_modelo_130_summary   — IRPF estimated payment Spain
+ *   3. get_modelo_390_summary   — IVA annual recap Spain
+ *   4. get_modelo_180_summary   — IRPF rentals annual Spain
+ *   5. get_modelo_347_summary   — Operations >€3005 annual third-party recap
+ *   6. verifactu_status         — VeriFactu submission status for an invoice
+ *   7. verifactu_resubmit       — Re-submit a failed VeriFactu submission (TRUST AREA)
+ *   8. ticketbai_status         — Basque Country e-invoicing status
+ *
+ * REST surface: /v1/fiscal/* (documented: pending — backend ships separately)
+ *
+ * NOTE: ERP backend endpoints /v1/fiscal/* are planned. Tools are wired
+ * and will surface 404 errors until the backend ships.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerFiscalTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=fiscal.d.ts.map

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

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