mcp-server-acube 0.1.0

package/dist/tools/configurations.js

@@ -0,0 +1,101 @@
+import { z } from "zod";
+import { formatResponse, errorResponse } from "../response.js";
+export function registerConfigurationTools(server, client) {
+    // ── list_business_registries ──────────────────────────────────────────
+    server.tool("list_business_registries", "List all business registry configurations (anagrafiche aziendali).", {}, async () => {
+        try {
+            const result = await client.get("/business-registry-configurations");
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── create_business_registry ──────────────────────────────────────────
+    server.tool("create_business_registry", "Create a business registry (anagrafica aziendale) for SDI invoicing.", {
+        config: z
+            .record(z.unknown())
+            .describe("Business registry data: fiscal_id, company_name, supplier_invoice_enabled, etc."),
+    }, async (params) => {
+        try {
+            const result = await client.post("/business-registry-configurations", params.config);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── get_business_registry ─────────────────────────────────────────────
+    server.tool("get_business_registry", "Get a business registry configuration by ID.", {
+        id: z.string().describe("Business registry ID"),
+    }, async (params) => {
+        try {
+            const result = await client.get(`/business-registry-configurations/${encodeURIComponent(params.id)}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── update_business_registry ──────────────────────────────────────────
+    server.tool("update_business_registry", "Update a business registry configuration.", {
+        id: z.string().describe("Business registry ID"),
+        config: z.record(z.unknown()).describe("Fields to update"),
+    }, async (params) => {
+        try {
+            const result = await client.put(`/business-registry-configurations/${encodeURIComponent(params.id)}`, params.config);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── list_appointees ───────────────────────────────────────────────────
+    server.tool("list_appointees", "List all ADE tax appointees (intermediari fiscali).", {}, async () => {
+        try {
+            const result = await client.get("/ade-appointees");
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── create_appointee ──────────────────────────────────────────────────
+    server.tool("create_appointee", "Create an ADE appointee (intermediario fiscale).", {
+        appointee: z.record(z.unknown()).describe("Appointee data"),
+    }, async (params) => {
+        try {
+            const result = await client.post("/ade-appointees", params.appointee);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── get_appointee ─────────────────────────────────────────────────────
+    server.tool("get_appointee", "Get an ADE appointee by ID.", {
+        id: z.string().describe("Appointee ID"),
+    }, async (params) => {
+        try {
+            const result = await client.get(`/ade-appointees/${encodeURIComponent(params.id)}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── update_appointee ──────────────────────────────────────────────────
+    server.tool("update_appointee", "Update an ADE appointee.", {
+        id: z.string().describe("Appointee ID"),
+        appointee: z.record(z.unknown()).describe("Fields to update"),
+    }, async (params) => {
+        try {
+            const result = await client.put(`/ade-appointees/${encodeURIComponent(params.id)}`, params.appointee);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=configurations.js.map

package/dist/tools/configurations.js.map

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

package/dist/tools/invoice-extract.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module tools/invoice-extract
+ *
+ * AI-powered PDF-to-FatturaPA extraction tools.
+ *
+ * Provides 3 tools:
+ * - `extract_invoice_from_pdf` -- Upload a base64-encoded PDF for extraction.
+ *   Returns a job UUID to track progress.
+ * - `get_extraction_status` -- Poll the extraction job status (pending, completed, failed).
+ * - `get_extraction_result` -- Download the converted FatturaPA invoice (JSON or XML)
+ *   from a completed extraction job.
+ *
+ * Typical workflow:
+ * 1. Upload PDF with `extract_invoice_from_pdf` -> get job UUID.
+ * 2. Poll `get_extraction_status` until status is `completed`.
+ * 3. Retrieve the FatturaPA with `get_extraction_result`.
+ *
+ * @see https://docs.acubeapi.com/ -- A-Cube extraction endpoints
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AcubeClient } from "../client.js";
+export declare function registerInvoiceExtractTools(server: McpServer, client: AcubeClient): void;

package/dist/tools/invoice-extract.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { formatResponse, errorResponse } from "../response.js";
+export function registerInvoiceExtractTools(server, client) {
+    // ── extract_invoice_from_pdf ──────────────────────────────────────────
+    server.tool("extract_invoice_from_pdf", "Upload a PDF (base64) for AI extraction to FatturaPA. Returns job UUID.", {
+        pdf_base64: z.string().describe("Base64-encoded PDF content"),
+    }, async (params) => {
+        try {
+            const response = await client.post("/invoice-extract", { pdf_base64: params.pdf_base64 });
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── get_extraction_status ─────────────────────────────────────────────
+    server.tool("get_extraction_status", "Check PDF extraction job status by UUID.", {
+        uuid: z.string().describe("Extraction job UUID"),
+    }, async (params) => {
+        try {
+            const response = await client.get(`/invoice-extract/${encodeURIComponent(params.uuid)}`);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── get_extraction_result ─────────────────────────────────────────────
+    server.tool("get_extraction_result", "Get completed extraction result as FatturaPA (JSON or XML).", {
+        uuid: z.string().describe("Completed extraction job UUID"),
+        format: z.enum(["json", "xml"]).optional().default("json").describe("Output format"),
+    }, async (params) => {
+        try {
+            const acceptMap = {
+                json: "application/json",
+                xml: "application/xml",
+            };
+            const response = await client.get(`/invoice-extract/${encodeURIComponent(params.uuid)}/result`, { accept: acceptMap[params.format] });
+            if (typeof response.data === "string") {
+                return { content: [{ type: "text", text: response.data }] };
+            }
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=invoice-extract.js.map

package/dist/tools/invoice-extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-extract.js","sourceRoot":"","sources":["../../src/tools/invoice-extract.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,UAAU,2BAA2B,CACzC,MAAiB,EACjB,MAAmB;IAEnB,yEAAyE;IACzE,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,yEAAyE,EACzE;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;KAC9D,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,kBAAkB,EAClB,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAClC,CAAC;YACF,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,yEAAyE;IACzE,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,0CAA0C,EAC1C;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;KACjD,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CACtD,CAAC;YACF,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,yEAAyE;IACzE,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,6DAA6D,EAC7D;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC1D,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;KACrF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,SAAS,GAA2B;gBACxC,IAAI,EAAE,kBAAkB;gBACxB,GAAG,EAAE,iBAAiB;aACvB,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,oBAAoB,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAC5D,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CACrC,CAAC;YAEF,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACvE,CAAC;YACD,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/invoices.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module tools/invoices
+ *
+ * SDI electronic invoicing tools.
+ *
+ * Provides 4 tools:
+ * - `send_invoice` -- Submit a FatturaPA invoice to SDI.
+ * - `send_simplified_invoice` -- Submit a simplified invoice (max 400 EUR).
+ * - `list_invoices` -- Search/filter invoices with 20+ parameters and a
+ *   token-optimized compact default view.
+ * - `get_invoice` -- Retrieve a single invoice by UUID (JSON, XML, PDF, HTML).
+ *
+ * Token optimization: `list_invoices` parses the FatturaPA JSON payload on the
+ * server side to extract `invoice_number`, `invoice_date`, `total_amount`, and
+ * `currency` as top-level fields. This avoids transferring the full payload
+ * (~2000 tokens/invoice) while still exposing the most-requested data.
+ *
+ * @see https://docs.acubeapi.com/ -- A-Cube invoice endpoints
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AcubeClient } from "../client.js";
+export declare function registerInvoiceTools(server: McpServer, client: AcubeClient): void;

package/dist/tools/invoices.js

@@ -0,0 +1,223 @@
+import { z } from "zod";
+import { pickFields, formatResponse, errorResponse } from "../response.js";
+/**
+ * Default field set for `list_invoices` compact view.
+ *
+ * Covers the most common use case: "who sent what to whom, for how much,
+ * and what is the current SDI status?" The `invoice_number`, `invoice_date`,
+ * `total_amount`, and `currency` fields are computed by {@link enrichInvoices}.
+ */
+const LIST_INVOICES_DEFAULT_FIELDS = [
+    "uuid",
+    "created_at",
+    "document_type",
+    "marking",
+    "notice",
+    "invoice_number",
+    "invoice_date",
+    "total_amount",
+    "currency",
+    "sender.business_name",
+    "sender.business_vat_number_code",
+    "recipient.business_name",
+    "recipient.business_vat_number_code",
+    "notifications",
+];
+/**
+ * Parse the `payload` JSON string in each invoice and extract commonly needed
+ * fields as top-level properties, so they can be selected via `fields` without
+ * requiring the full payload blob.
+ */
+function enrichInvoices(data) {
+    if (!Array.isArray(data))
+        return data;
+    return data.map((item) => {
+        if (typeof item.payload !== "string")
+            return item;
+        try {
+            const parsed = JSON.parse(item.payload);
+            const body = parsed?.fattura_elettronica_body?.[0];
+            const doc = body?.dati_generali?.dati_generali_documento;
+            return {
+                ...item,
+                invoice_number: doc?.numero ?? null,
+                invoice_date: doc?.data ?? null,
+                total_amount: doc?.importo_totale_documento ?? null,
+                currency: doc?.divisa ?? null,
+            };
+        }
+        catch {
+            return item;
+        }
+    });
+}
+export function registerInvoiceTools(server, client) {
+    // ── send_invoice ──────────────────────────────────────────────────────
+    server.tool("send_invoice", "Send a FatturaPA invoice to SDI. Returns the assigned UUID (HTTP 202).", {
+        invoice: z
+            .record(z.unknown())
+            .describe("Complete FatturaPA JSON with fattura_elettronica_header and fattura_elettronica_body"),
+        sign: z
+            .boolean()
+            .optional()
+            .describe("Digitally sign before sending (X-SignInvoice header)"),
+    }, async (params) => {
+        try {
+            const headers = {};
+            if (params.sign !== undefined) {
+                headers["X-SignInvoice"] = params.sign ? "true" : "false";
+            }
+            const response = await client.post("/invoices", params.invoice, { headers });
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── send_simplified_invoice ───────────────────────────────────────────
+    server.tool("send_simplified_invoice", "Send a simplified FatturaPA to SDI (max 400 EUR). Returns UUID.", {
+        invoice: z
+            .record(z.unknown())
+            .describe("Simplified FatturaPA JSON"),
+    }, async (params) => {
+        try {
+            const response = await client.post("/invoices/simplified", params.invoice);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── list_invoices ─────────────────────────────────────────────────────
+    server.tool("list_invoices", "List/search SDI invoices. Filters: sender/recipient name or VAT, invoice number, " +
+        "document type, direction, status, date ranges. Default response is compact (key fields only). " +
+        "Use fields:['*'] for full data.", {
+        page: z.number().optional().default(1).describe("Page number"),
+        items_per_page: z.number().optional().default(30).describe("Items per page"),
+        marking: z
+            .string()
+            .optional()
+            .describe("Status: waiting, quarantena, sent, invoice-error, received, rejected, delivered, not-delivered"),
+        sender_name: z.string().optional().describe("Sender business name (partial match)"),
+        sender_vat: z.string().optional().describe("Sender P.IVA"),
+        sender_fiscal_code: z.string().optional().describe("Sender codice fiscale"),
+        recipient_name: z.string().optional().describe("Recipient business name (partial match)"),
+        recipient_vat: z.string().optional().describe("Recipient P.IVA"),
+        recipient_fiscal_code: z.string().optional().describe("Recipient codice fiscale"),
+        invoice_number: z.string().optional().describe("Invoice number (partial match)"),
+        document_type: z.string().optional().describe("FatturaPA type: TD01, TD04, TD05, TD06, TD07..."),
+        direction: z.enum(["outgoing", "incoming"]).optional().describe("outgoing or incoming"),
+        invoice_date_from: z.string().optional().describe("Invoice date >= (ISO date)"),
+        invoice_date_to: z.string().optional().describe("Invoice date <= (ISO date)"),
+        created_at_from: z.string().optional().describe("Created at >= (ISO date)"),
+        created_at_to: z.string().optional().describe("Created at <= (ISO date)"),
+        order_by_date: z.enum(["asc", "desc"]).optional().describe("Sort by invoice date"),
+        order_by_number: z.enum(["asc", "desc"]).optional().describe("Sort by invoice number"),
+        downloaded: z.boolean().optional().describe("Filter by download status"),
+        signed: z.boolean().optional().describe("Filter by signature status"),
+        fields: z
+            .array(z.string())
+            .optional()
+            .describe("Fields to return per invoice (dot-notation supported). " +
+            "Default: uuid, created_at, document_type, marking, notice, invoice_number, invoice_date, " +
+            "total_amount, currency, sender.business_name, sender.business_vat_number_code, " +
+            "recipient.business_name, recipient.business_vat_number_code, notifications. " +
+            "Use ['*'] for full response. Extra: payload, sender, recipient, sdi_file_name, signed, downloaded."),
+    }, async (params) => {
+        try {
+            const query = new URLSearchParams();
+            query.set("page", String(params.page));
+            query.set("itemsPerPage", String(params.items_per_page));
+            if (params.marking)
+                query.set("marking", params.marking);
+            if (params.sender_name)
+                query.set("sender.business_name", params.sender_name);
+            if (params.sender_vat)
+                query.set("sender.business_vat_number_code", params.sender_vat);
+            if (params.sender_fiscal_code)
+                query.set("sender.business_fiscal_code", params.sender_fiscal_code);
+            if (params.recipient_name)
+                query.set("recipient.business_name", params.recipient_name);
+            if (params.recipient_vat)
+                query.set("recipient.business_vat_number_code", params.recipient_vat);
+            if (params.recipient_fiscal_code)
+                query.set("recipient.business_fiscal_code", params.recipient_fiscal_code);
+            if (params.invoice_number)
+                query.set("invoice_number", params.invoice_number);
+            if (params.document_type)
+                query.set("document_type", params.document_type);
+            if (params.direction)
+                query.set("type", params.direction === "outgoing" ? "0" : "1");
+            if (params.invoice_date_from)
+                query.set("invoice_date[after]", params.invoice_date_from);
+            if (params.invoice_date_to)
+                query.set("invoice_date[before]", params.invoice_date_to);
+            if (params.created_at_from)
+                query.set("created_at[after]", params.created_at_from);
+            if (params.created_at_to)
+                query.set("created_at[before]", params.created_at_to);
+            if (params.order_by_date)
+                query.set("order[invoice_date]", params.order_by_date);
+            if (params.order_by_number)
+                query.set("order[invoice_number]", params.order_by_number);
+            if (params.downloaded !== undefined)
+                query.set("downloaded", String(params.downloaded));
+            if (params.signed !== undefined)
+                query.set("signed", String(params.signed));
+            const response = await client.get(`/invoices?${query.toString()}`);
+            let data = response.data;
+            const wantAll = params.fields?.length === 1 && params.fields[0] === "*";
+            if (wantAll) {
+                return formatResponse(data);
+            }
+            data = enrichInvoices(data);
+            const selectedFields = params.fields ?? LIST_INVOICES_DEFAULT_FIELDS;
+            data = pickFields(data, selectedFields);
+            return formatResponse(data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── get_invoice ───────────────────────────────────────────────────────
+    server.tool("get_invoice", "Get a specific invoice by UUID. Formats: json, xml, pdf (base64), html.", {
+        uuid: z.string().describe("Invoice UUID"),
+        format: z
+            .enum(["json", "xml", "pdf", "html"])
+            .optional()
+            .default("json")
+            .describe("Output format (default: json)"),
+        print_theme: z.string().optional().describe("Print theme for PDF/HTML"),
+        fields: z
+            .array(z.string())
+            .optional()
+            .describe("Fields to return (JSON only, dot-notation). Omit for all fields."),
+    }, async (params) => {
+        try {
+            const acceptMap = {
+                json: "application/json",
+                xml: "application/xml",
+                pdf: "application/pdf",
+                html: "text/html",
+            };
+            const headers = {};
+            if (params.print_theme) {
+                headers["X-PrintTheme"] = params.print_theme;
+            }
+            const response = await client.get(`/invoices/${encodeURIComponent(params.uuid)}`, {
+                accept: acceptMap[params.format],
+                headers,
+            });
+            if (typeof response.data === "string") {
+                return {
+                    content: [{ type: "text", text: response.data }],
+                };
+            }
+            return formatResponse(response.data, params.fields);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=invoices.js.map

package/dist/tools/invoices.js.map

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

package/dist/tools/notifications.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AcubeClient } from "../client.js";
+export declare function registerNotificationTools(server: McpServer, client: AcubeClient): void;

package/dist/tools/notifications.js

@@ -0,0 +1,79 @@
+/**
+ * @module tools/notifications
+ *
+ * SDI notification tools.
+ *
+ * Provides 3 tools:
+ * - `list_notifications` -- List SDI notifications with filtering by type and download status.
+ * - `get_notification` -- Retrieve a single notification by UUID (JSON or XML).
+ * - `mark_notifications_downloaded` -- Mark notifications as downloaded by UUID.
+ *
+ * SDI notification types:
+ * - `NS` (Notifica di Scarto) -- Invoice rejected by SDI.
+ * - `RC` (Ricevuta di Consegna) -- Invoice delivered to recipient.
+ * - `MC` (Mancata Consegna) -- Delivery failed.
+ * - `EC` (Esito Committente) -- Recipient accepted/refused.
+ * - `DT` (Decorrenza Termini) -- Deadline passed, invoice auto-accepted.
+ * - `MT`, `SE`, `NE`, `AT` -- Metadata, outcome rejection, outcome notification, attestation.
+ *
+ * @see https://docs.acubeapi.com/ -- A-Cube notification endpoints
+ */
+import { z } from "zod";
+import { formatResponse, errorResponse } from "../response.js";
+export function registerNotificationTools(server, client) {
+    // ---------- list_notifications ----------
+    server.tool("list_notifications", "List SDI notifications for sent invoices. Types: NS=Rejection, MT=Metadata, RC=Delivery, MC=Non-delivery, EC=Outcome, DT=Deadline.", {
+        page: z.number().optional().default(1).describe("Page number"),
+        items_per_page: z.number().optional().default(30).describe("Items per page"),
+        type: z
+            .enum(["NS", "MT", "RC", "MC", "EC", "SE", "NE", "DT", "AT"])
+            .optional()
+            .describe("Notification type filter"),
+        downloaded: z.boolean().optional().describe("Filter by downloaded flag"),
+    }, async (params) => {
+        try {
+            const query = new URLSearchParams();
+            query.set("page", String(params.page));
+            query.set("items_per_page", String(params.items_per_page));
+            if (params.type !== undefined)
+                query.set("type", params.type);
+            if (params.downloaded !== undefined)
+                query.set("downloaded", String(params.downloaded));
+            const result = await client.get(`/notifications?${query.toString()}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ---------- get_notification ----------
+    server.tool("get_notification", "Get a specific SDI notification by UUID (JSON or XML).", {
+        uuid: z.string().describe("Notification UUID"),
+        format: z.enum(["json", "xml"]).optional().default("json").describe("Response format"),
+    }, async (params) => {
+        try {
+            const accept = params.format === "xml" ? "application/xml" : "application/json";
+            const result = await client.get(`/notifications/${encodeURIComponent(params.uuid)}`, { accept });
+            if (typeof result.data === "string") {
+                return { content: [{ type: "text", text: result.data }] };
+            }
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ---------- mark_notifications_downloaded ----------
+    server.tool("mark_notifications_downloaded", "Mark SDI notifications as downloaded by UUIDs.", {
+        uuids: z.array(z.string()).describe("Notification UUIDs to mark"),
+    }, async (params) => {
+        try {
+            const result = await client.put("/notifications", params.uuids);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=notifications.js.map

package/dist/tools/notifications.js.map

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

package/dist/tools/receipts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module tools/receipts
+ *
+ * Electronic receipt (scontrino elettronico) tools.
+ *
+ * Provides 4 tools:
+ * - `send_receipt` -- Issue an electronic receipt to the Agenzia delle Entrate.
+ * - `get_receipt_details` -- Get receipt transaction details.
+ * - `void_receipt` -- Void/cancel a receipt (annullamento).
+ * - `return_receipt_items` -- Process item returns against a receipt (reso).
+ *
+ * Note: The receipt service is unavailable daily from 23:55 to 00:00 Italian
+ * time due to Agenzia delle Entrate maintenance.
+ *
+ * @see https://docs.acubeapi.com/ -- A-Cube receipt endpoints
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AcubeClient } from "../client.js";
+export declare function registerReceiptTools(server: McpServer, client: AcubeClient): void;

package/dist/tools/receipts.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { formatResponse, errorResponse } from "../response.js";
+export function registerReceiptTools(server, client) {
+    // ── send_receipt ──────────────────────────────────────────────────────
+    server.tool("send_receipt", "Send an electronic receipt (scontrino). Not available 23:55-00:00 Italian time.", {
+        receipt: z
+            .record(z.unknown())
+            .describe("Receipt data: fiscal_id, items[], cash_payment_amount, electronic_payment_amount"),
+    }, async (params) => {
+        try {
+            const response = await client.post("/receipts", params.receipt);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── get_receipt_details ─────────────────────────────────────────────
+    server.tool("get_receipt_details", "Get receipt details by ID.", {
+        id: z.string().describe("Receipt ID"),
+    }, async (params) => {
+        try {
+            const response = await client.get(`/receipts/${encodeURIComponent(params.id)}/details`);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── void_receipt ────────────────────────────────────────────────────
+    server.tool("void_receipt", "Void/cancel a receipt (annullamento scontrino).", {
+        id: z.string().describe("Receipt ID to void"),
+    }, async (params) => {
+        try {
+            const response = await client.delete(`/receipts/${encodeURIComponent(params.id)}`);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── return_receipt_items ────────────────────────────────────────────
+    server.tool("return_receipt_items", "Process item returns on a receipt (reso).", {
+        id: z.string().describe("Original receipt ID"),
+        items: z.array(z.record(z.unknown())).describe("Items to return"),
+    }, async (params) => {
+        try {
+            const response = await client.post(`/receipts/${encodeURIComponent(params.id)}/return`, params.items);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=receipts.js.map

package/dist/tools/receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.js","sourceRoot":"","sources":["../../src/tools/receipts.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,MAAmB;IAEnB,yEAAyE;IACzE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,iFAAiF,EACjF;QACE,OAAO,EAAE,CAAC;aACP,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aACnB,QAAQ,CAAC,kFAAkF,CAAC;KAChG,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAU,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACzE,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,uEAAuE;IACvE,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,4BAA4B,EAC5B;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;KACtC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,aAAa,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,CACrD,CAAC;YACF,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,uEAAuE;IACvE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,iDAAiD,EACjD;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;KAC9C,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAClC,aAAa,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAC7C,CAAC;YACF,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,uEAAuE;IACvE,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,2CAA2C,EAC3C;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAC9C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KAClE,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,aAAa,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EACnD,MAAM,CAAC,KAAK,CACb,CAAC;YACF,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/verify.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AcubeClient } from "../client.js";
+export declare function registerVerifyTools(server: McpServer, client: AcubeClient): void;