mcp-server-acube 0.1.0

package/dist/client.js

@@ -0,0 +1,172 @@
+/**
+ * @module client
+ *
+ * HTTP client for the A-Cube API with automatic JWT authentication.
+ *
+ * The client handles:
+ * - Login via email/password and JWT token caching (24h lifetime, 23h refresh).
+ * - Automatic token injection on every request.
+ * - Content negotiation: JSON, XML, PDF (base64), HTML.
+ * - Two base URLs per environment: `common` (authentication) and `govIt` (API operations).
+ * - Error handling with clear messages including HTTP status codes.
+ *
+ * @see https://docs.acubeapi.com/
+ */
+/**
+ * Base URLs for each A-Cube environment.
+ *
+ * - `common`: Used for authentication (`POST /login`).
+ * - `govIt`: Used for all API operations (invoices, notifications, etc.).
+ */
+const BASE_URLS = {
+    production: {
+        common: "https://common.api.acubeapi.com",
+        govIt: "https://api.acubeapi.com",
+    },
+    sandbox: {
+        common: "https://common-sandbox.api.acubeapi.com",
+        govIt: "https://api-sandbox.acubeapi.com",
+    },
+};
+/**
+ * A-Cube API client with automatic JWT authentication.
+ *
+ * Usage:
+ * ```ts
+ * const client = new AcubeClient({ email: "...", password: "...", environment: "sandbox" });
+ * const invoices = await client.get("/invoices?page=1");
+ * ```
+ *
+ * The client automatically handles login and token refresh. The JWT token is
+ * cached for 23 hours (1h safety buffer before the actual 24h expiry).
+ */
+export class AcubeClient {
+    config;
+    token = null;
+    tokenExpiresAt = 0;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Returns the base URL for the given service in the configured environment. */
+    getBaseUrl(service) {
+        return BASE_URLS[this.config.environment][service];
+    }
+    /**
+     * Authenticate with A-Cube and cache the JWT token.
+     *
+     * The token has a 24h lifetime. We cache it for 23h to avoid edge-case
+     * expiry during a request. As per A-Cube best practices, we minimize
+     * login calls by reusing the cached token.
+     */
+    async login() {
+        const url = `${this.getBaseUrl("common")}/login`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                email: this.config.email,
+                password: this.config.password,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Acube login failed (${response.status}): ${error}`);
+        }
+        const data = (await response.json());
+        this.token = data.token;
+        this.tokenExpiresAt = Date.now() + 23 * 60 * 60 * 1000;
+        return this.token;
+    }
+    /** Returns a valid token, refreshing it if expired. */
+    async getToken() {
+        if (this.token && Date.now() < this.tokenExpiresAt) {
+            return this.token;
+        }
+        return this.login();
+    }
+    /**
+     * Make an authenticated API request.
+     *
+     * Handles:
+     * - Automatic Bearer token injection.
+     * - Content-Type negotiation based on body presence.
+     * - Binary responses (PDF) returned as base64 strings.
+     * - JSON parsing with fallback to raw text.
+     * - HTTP 202 treated as success (used by A-Cube for invoice submission).
+     *
+     * @param method  - HTTP method (GET, POST, PUT, DELETE).
+     * @param path    - API path (e.g., `/invoices`). Appended to the base URL.
+     * @param options - Request options: service, body, headers, accept type.
+     * @returns         Object with `status`, `data` (parsed), and optionally `raw` (for binary).
+     */
+    async request(method, path, options = {}) {
+        const { service = "govIt", body, headers: extraHeaders = {}, accept = "application/json", } = options;
+        const token = await this.getToken();
+        const url = `${this.getBaseUrl(service)}${path}`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            Accept: accept,
+            ...extraHeaders,
+        };
+        if (body && !headers["Content-Type"]) {
+            headers["Content-Type"] = "application/json";
+        }
+        const fetchOptions = {
+            method,
+            headers,
+        };
+        if (body) {
+            fetchOptions.body =
+                typeof body === "string" ? body : JSON.stringify(body);
+        }
+        const response = await fetch(url, fetchOptions);
+        // Binary responses (PDF): return as base64
+        if (accept === "application/pdf" ||
+            accept === "application/octet-stream") {
+            if (!response.ok) {
+                const error = await response.text();
+                throw new Error(`Acube API error (${response.status}): ${error}`);
+            }
+            const raw = await response.arrayBuffer();
+            return {
+                status: response.status,
+                data: Buffer.from(raw).toString("base64"),
+                raw,
+            };
+        }
+        // Text responses (JSON, XML, HTML)
+        const text = await response.text();
+        // HTTP 202 is success for A-Cube (invoice submission)
+        if (!response.ok && response.status !== 202) {
+            throw new Error(`Acube API error (${response.status}): ${text}`);
+        }
+        if (accept === "application/json" ||
+            response.headers.get("content-type")?.includes("json")) {
+            try {
+                const data = JSON.parse(text);
+                return { status: response.status, data };
+            }
+            catch {
+                return { status: response.status, data: text };
+            }
+        }
+        return { status: response.status, data: text };
+    }
+    /** Shorthand for `request("GET", path, options)`. */
+    async get(path, options) {
+        return this.request("GET", path, options);
+    }
+    /** Shorthand for `request("POST", path, { body, ...options })`. */
+    async post(path, body, options) {
+        return this.request("POST", path, { ...options, body });
+    }
+    /** Shorthand for `request("PUT", path, { body, ...options })`. */
+    async put(path, body, options) {
+        return this.request("PUT", path, { ...options, body });
+    }
+    /** Shorthand for `request("DELETE", path, options)`. */
+    async delete(path, options) {
+        return this.request("DELETE", path, options);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * @module index
+ *
+ * Entry point for the A-Cube MCP server.
+ *
+ * Reads credentials from environment variables, initializes the
+ * {@link AcubeClient}, creates an MCP server with stdio transport,
+ * and registers all 38 tools across 8 modules.
+ *
+ * Environment variables:
+ * - `ACUBE_EMAIL` (required) -- A-Cube account email.
+ * - `ACUBE_PASSWORD` (required) -- A-Cube account password.
+ * - `ACUBE_ENVIRONMENT` (optional, default `"sandbox"`) -- `"sandbox"` or `"production"`.
+ *
+ * @example
+ * ```bash
+ * ACUBE_EMAIL=me@example.com ACUBE_PASSWORD=secret node dist/index.js
+ * ```
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { AcubeClient } from "./client.js";
+import { registerInvoiceTools } from "./tools/invoices.js";
+import { registerInvoiceExtractTools } from "./tools/invoice-extract.js";
+import { registerNotificationTools } from "./tools/notifications.js";
+import { registerVerifyTools } from "./tools/verify.js";
+import { registerReceiptTools } from "./tools/receipts.js";
+import { registerWebhookTools } from "./tools/webhooks.js";
+import { registerConfigurationTools } from "./tools/configurations.js";
+import { registerCassettoFiscaleTools } from "./tools/cassetto-fiscale.js";
+// --- Validate required environment variables ---
+const email = process.env.ACUBE_EMAIL;
+const password = process.env.ACUBE_PASSWORD;
+if (!email || !password) {
+    console.error("Error: ACUBE_EMAIL and ACUBE_PASSWORD environment variables are required.\n" +
+        "Configure them in your MCP client settings:\n" +
+        '  "env": { "ACUBE_EMAIL": "...", "ACUBE_PASSWORD": "...", "ACUBE_ENVIRONMENT": "sandbox" }');
+    process.exit(1);
+}
+const environment = (process.env.ACUBE_ENVIRONMENT === "production" ? "production" : "sandbox");
+// --- Initialize API client ---
+const client = new AcubeClient({ email, password, environment });
+// --- Create MCP server ---
+const server = new McpServer({
+    name: "mcp-server-acube",
+    version: "0.1.0",
+});
+// --- Register all tools ---
+registerInvoiceTools(server, client);
+registerInvoiceExtractTools(server, client);
+registerNotificationTools(server, client);
+registerVerifyTools(server, client);
+registerReceiptTools(server, client);
+registerWebhookTools(server, client);
+registerConfigurationTools(server, client);
+registerCassettoFiscaleTools(server, client);
+// --- Graceful shutdown ---
+process.on("SIGINT", async () => {
+    await server.close();
+    process.exit(0);
+});
+// --- Start server ---
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAE3E,kDAAkD;AAClD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;AACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AAE5C,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CACX,6EAA6E;QAC7E,+CAA+C;QAC/C,4FAA4F,CAC7F,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAA6B,CAAC;AAE5H,gCAAgC;AAChC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;AAEjE,4BAA4B;AAC5B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,6BAA6B;AAC7B,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACpC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C,4BAA4B;AAC5B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,uBAAuB;AACvB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/pick-fields.js.map

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

package/dist/response.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @module response
+ *
+ * Response formatting utilities for the A-Cube MCP server.
+ *
+ * Every tool response passes through these utilities to minimize LLM token
+ * consumption. Three optimizations are applied:
+ *
+ * 1. **Field selection** (`pickFields`) -- Return only the requested fields,
+ *    with dot-notation support for nested paths (e.g., `"sender.business_name"`).
+ *
+ * 2. **Null stripping** (`stripEmpty`) -- Recursively remove `null`, `undefined`,
+ *    and empty objects. A typical A-Cube invoice has ~60 null fields across
+ *    sender and recipient objects; stripping them reduces token count by ~50%.
+ *
+ * 3. **Compact JSON** -- Serialize without indentation. The LLM reads compact
+ *    JSON just as well, and whitespace tokens add up quickly on large responses.
+ */
+/**
+ * Recursively pick only the specified fields from an object or array of objects.
+ *
+ * Supports dot-notation for nested paths. When multiple sub-fields of the same
+ * parent are requested, they are merged into a single object.
+ *
+ * @example
+ * ```ts
+ * pickFields(invoice, ["uuid", "sender.business_name", "sender.business_vat_number_code"])
+ * // => { uuid: "...", sender: { business_name: "...", business_vat_number_code: "..." } }
+ * ```
+ *
+ * When applied to an array, each element is filtered individually.
+ */
+export declare function pickFields(data: unknown, fields: string[]): unknown;
+/**
+ * Recursively strip `null`, `undefined`, and empty objects from data.
+ *
+ * - Null/undefined values are removed (the key is omitted from the parent).
+ * - Objects that become empty after stripping are also removed.
+ * - Arrays are preserved (elements are stripped individually; null elements
+ *   become `undefined` in the array, which `JSON.stringify` converts to `null`).
+ * - Primitive values (strings, numbers, booleans) are passed through unchanged.
+ *
+ * @returns The stripped data, or `undefined` if the entire input was null/empty.
+ */
+export declare function stripEmpty(data: unknown): unknown;
+/**
+ * Format data for an MCP tool response.
+ *
+ * Processing order: **pick fields → strip nulls → compact JSON**.
+ *
+ * The order matters: if we stripped first, `pickFields` could create empty
+ * nested objects (e.g., `{ sender: {} }`) that would not be cleaned up.
+ * By picking first and stripping second, any empty objects left by field
+ * selection are properly removed.
+ *
+ * @param data   - The raw API response data.
+ * @param fields - Optional list of fields to select (dot-notation supported).
+ *                 If omitted or empty, all fields are returned (nulls still stripped).
+ * @returns       MCP-compatible content response with compact JSON text.
+ */
+export declare function formatResponse(data: unknown, fields?: string[]): {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+};
+/**
+ * Format an error for an MCP tool response.
+ *
+ * Extracts the error message from `Error` instances or converts to string.
+ * Sets `isError: true` so the MCP client can distinguish errors from results.
+ */
+export declare function errorResponse(error: unknown): {
+    isError: true;
+    content: [{
+        type: "text";
+        text: string;
+    }];
+};

package/dist/response.js

@@ -0,0 +1,137 @@
+/**
+ * @module response
+ *
+ * Response formatting utilities for the A-Cube MCP server.
+ *
+ * Every tool response passes through these utilities to minimize LLM token
+ * consumption. Three optimizations are applied:
+ *
+ * 1. **Field selection** (`pickFields`) -- Return only the requested fields,
+ *    with dot-notation support for nested paths (e.g., `"sender.business_name"`).
+ *
+ * 2. **Null stripping** (`stripEmpty`) -- Recursively remove `null`, `undefined`,
+ *    and empty objects. A typical A-Cube invoice has ~60 null fields across
+ *    sender and recipient objects; stripping them reduces token count by ~50%.
+ *
+ * 3. **Compact JSON** -- Serialize without indentation. The LLM reads compact
+ *    JSON just as well, and whitespace tokens add up quickly on large responses.
+ */
+/**
+ * Recursively pick only the specified fields from an object or array of objects.
+ *
+ * Supports dot-notation for nested paths. When multiple sub-fields of the same
+ * parent are requested, they are merged into a single object.
+ *
+ * @example
+ * ```ts
+ * pickFields(invoice, ["uuid", "sender.business_name", "sender.business_vat_number_code"])
+ * // => { uuid: "...", sender: { business_name: "...", business_vat_number_code: "..." } }
+ * ```
+ *
+ * When applied to an array, each element is filtered individually.
+ */
+export function pickFields(data, fields) {
+    if (data === null || data === undefined)
+        return data;
+    if (Array.isArray(data)) {
+        return data.map((item) => pickFields(item, fields));
+    }
+    if (typeof data !== "object")
+        return data;
+    const record = data;
+    const result = {};
+    for (const field of fields) {
+        const dotIndex = field.indexOf(".");
+        if (dotIndex === -1) {
+            if (field in record) {
+                result[field] = record[field];
+            }
+        }
+        else {
+            const topKey = field.slice(0, dotIndex);
+            const rest = field.slice(dotIndex + 1);
+            if (topKey in record) {
+                const existing = result[topKey];
+                if (existing && typeof existing === "object" && !Array.isArray(existing)) {
+                    const merged = pickFields(record[topKey], [rest]);
+                    Object.assign(existing, merged);
+                }
+                else {
+                    result[topKey] = pickFields(record[topKey], [rest]);
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Recursively strip `null`, `undefined`, and empty objects from data.
+ *
+ * - Null/undefined values are removed (the key is omitted from the parent).
+ * - Objects that become empty after stripping are also removed.
+ * - Arrays are preserved (elements are stripped individually; null elements
+ *   become `undefined` in the array, which `JSON.stringify` converts to `null`).
+ * - Primitive values (strings, numbers, booleans) are passed through unchanged.
+ *
+ * @returns The stripped data, or `undefined` if the entire input was null/empty.
+ */
+export function stripEmpty(data) {
+    if (data === null || data === undefined)
+        return undefined;
+    if (Array.isArray(data)) {
+        return data.map(stripEmpty);
+    }
+    if (typeof data === "object") {
+        const record = data;
+        const result = {};
+        for (const [key, value] of Object.entries(record)) {
+            const stripped = stripEmpty(value);
+            if (stripped !== undefined) {
+                result[key] = stripped;
+            }
+        }
+        return Object.keys(result).length > 0 ? result : undefined;
+    }
+    return data;
+}
+/**
+ * Format data for an MCP tool response.
+ *
+ * Processing order: **pick fields → strip nulls → compact JSON**.
+ *
+ * The order matters: if we stripped first, `pickFields` could create empty
+ * nested objects (e.g., `{ sender: {} }`) that would not be cleaned up.
+ * By picking first and stripping second, any empty objects left by field
+ * selection are properly removed.
+ *
+ * @param data   - The raw API response data.
+ * @param fields - Optional list of fields to select (dot-notation supported).
+ *                 If omitted or empty, all fields are returned (nulls still stripped).
+ * @returns       MCP-compatible content response with compact JSON text.
+ */
+export function formatResponse(data, fields) {
+    let processed = data;
+    if (fields && fields.length > 0) {
+        processed = pickFields(processed, fields);
+    }
+    processed = stripEmpty(processed) ?? null;
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(processed) },
+        ],
+    };
+}
+/**
+ * Format an error for an MCP tool response.
+ *
+ * Extracts the error message from `Error` instances or converts to string.
+ * Sets `isError: true` so the MCP client can distinguish errors from results.
+ */
+export function errorResponse(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

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

package/dist/tools/cassetto-fiscale.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module tools/cassetto-fiscale
+ *
+ * Cassetto Fiscale (tax drawer) and rejected invoice tools.
+ *
+ * Provides 7 tools:
+ * - `schedule_invoice_download` -- Set up recurring daily downloads at 03:00 UTC.
+ * - `get_download_schedule` -- Check schedule status and last execution.
+ * - `update_download_schedule` -- Modify schedule options (e.g., auto-renewal).
+ * - `delete_download_schedule` -- Stop recurring downloads.
+ * - `download_invoices_once` -- Trigger a one-time bulk download by date range.
+ * - `count_rejected_invoices` -- Count invoices rejected during processing.
+ * - `recover_rejected_invoices` -- Reprocess rejected invoices for a fiscal ID.
+ *
+ * The Cassetto Fiscale is the Agenzia delle Entrate's digital archive where
+ * all electronic invoices (sent and received) are stored for 10 years.
+ *
+ * @see https://docs.acubeapi.com/ -- A-Cube download schedule endpoints
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AcubeClient } from "../client.js";
+export declare function registerCassettoFiscaleTools(server: McpServer, client: AcubeClient): void;

package/dist/tools/cassetto-fiscale.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { formatResponse, errorResponse } from "../response.js";
+export function registerCassettoFiscaleTools(server, client) {
+    // ── schedule_invoice_download ─────────────────────────────────────────
+    server.tool("schedule_invoice_download", "Schedule daily invoice download from Cassetto Fiscale (runs 03:00 UTC).", {
+        fiscal_id: z.string().describe("P.IVA or codice fiscale"),
+        options: z.record(z.unknown()).optional().describe("Schedule options (e.g. auto_renewal)"),
+    }, async (params) => {
+        try {
+            const result = await client.post(`/schedule/invoice-download/${encodeURIComponent(params.fiscal_id)}`, params.options);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── get_download_schedule ─────────────────────────────────────────────
+    server.tool("get_download_schedule", "Check invoice download schedule status for a fiscal ID.", {
+        fiscal_id: z.string().describe("P.IVA or codice fiscale"),
+    }, async (params) => {
+        try {
+            const result = await client.get(`/schedule/invoice-download/${encodeURIComponent(params.fiscal_id)}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── update_download_schedule ──────────────────────────────────────────
+    server.tool("update_download_schedule", "Update a Cassetto Fiscale download schedule.", {
+        fiscal_id: z.string().describe("P.IVA or codice fiscale"),
+        options: z.record(z.unknown()).describe("Fields to update"),
+    }, async (params) => {
+        try {
+            const result = await client.put(`/schedule/invoice-download/${encodeURIComponent(params.fiscal_id)}`, params.options);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── delete_download_schedule ──────────────────────────────────────────
+    server.tool("delete_download_schedule", "Delete a Cassetto Fiscale download schedule.", {
+        fiscal_id: z.string().describe("P.IVA or codice fiscale"),
+    }, async (params) => {
+        try {
+            const result = await client.delete(`/schedule/invoice-download/${encodeURIComponent(params.fiscal_id)}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── download_invoices_once ────────────────────────────────────────────
+    server.tool("download_invoices_once", "One-time invoice download from Cassetto Fiscale by date range.", {
+        fiscal_id: z.string().describe("Fiscal ID"),
+        from_date: z.string().describe("Start date (YYYY-MM-DD)"),
+        to_date: z.string().describe("End date (YYYY-MM-DD)"),
+    }, async (params) => {
+        try {
+            const result = await client.post("/jobs/invoice-download", {
+                fiscal_id: params.fiscal_id,
+                from_date: params.from_date,
+                to_date: params.to_date,
+            });
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── count_rejected_invoices ───────────────────────────────────────────
+    server.tool("count_rejected_invoices", "Count rejected invoices from Cassetto Fiscale for a fiscal ID.", {
+        fiscal_id: z.string().describe("Fiscal ID"),
+        from_date: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+        to_date: z.string().optional().describe("End date (YYYY-MM-DD)"),
+    }, async (params) => {
+        try {
+            const query = new URLSearchParams();
+            if (params.from_date)
+                query.set("from_date", params.from_date);
+            if (params.to_date)
+                query.set("to_date", params.to_date);
+            const queryString = query.toString();
+            const path = `/rejected-invoices/${encodeURIComponent(params.fiscal_id)}/count` +
+                (queryString ? `?${queryString}` : "");
+            const result = await client.get(path);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── recover_rejected_invoices ─────────────────────────────────────────
+    server.tool("recover_rejected_invoices", "Recover and reprocess rejected Cassetto Fiscale invoices.", {
+        fiscal_id: z.string().describe("Fiscal ID"),
+        from_date: z.string().describe("Start date (YYYY-MM-DD)"),
+        to_date: z.string().describe("End date (YYYY-MM-DD)"),
+    }, async (params) => {
+        try {
+            const result = await client.post(`/rejected-invoices/${encodeURIComponent(params.fiscal_id)}/recover`, { from_date: params.from_date, to_date: params.to_date });
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=cassetto-fiscale.js.map

package/dist/tools/cassetto-fiscale.js.map

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

package/dist/tools/configurations.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module tools/configurations
+ *
+ * Business registry and ADE appointee tools.
+ *
+ * Provides 8 tools:
+ * - `list_business_registries` / `create_business_registry` /
+ *   `get_business_registry` / `update_business_registry`
+ *   -- Manage company profiles (anagrafiche aziendali) used for SDI invoicing.
+ * - `list_appointees` / `create_appointee` / `get_appointee` / `update_appointee`
+ *   -- Manage ADE tax appointees (intermediari fiscali) authorized to operate
+ *     with the Agenzia delle Entrate on behalf of a company.
+ *
+ * @see https://docs.acubeapi.com/ -- A-Cube configuration endpoints
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AcubeClient } from "../client.js";
+export declare function registerConfigurationTools(server: McpServer, client: AcubeClient): void;