mcp-server-acube 0.1.0

package/dist/tools/verify.js

@@ -0,0 +1,69 @@
+/**
+ * @module tools/verify
+ *
+ * Italian company and fiscal ID verification tools.
+ *
+ * Provides 4 tools:
+ * - `verify_fiscal_id` -- Validate a codice fiscale or P.IVA against the
+ *   Agenzia delle Entrate registry.
+ * - `verify_company` -- Full company lookup: denominazione, PEC, codice
+ *   destinatario, address, ATECO, shareholders, and more.
+ * - `verify_simple_company` -- Lightweight company info (subset of `verify_company`).
+ * - `verify_split_payment` -- Check if a P.IVA is subject to split payment
+ *   (scissione dei pagamenti) for public administration invoicing.
+ *
+ * @see https://docs.acubeapi.com/ -- A-Cube verification endpoints
+ */
+import { z } from "zod";
+import { formatResponse, errorResponse } from "../response.js";
+export function registerVerifyTools(server, client) {
+    // ---------- verify_fiscal_id ----------
+    server.tool("verify_fiscal_id", "Verify an Italian codice fiscale or P.IVA with Agenzia delle Entrate.", {
+        id: z.string().describe("Codice fiscale or P.IVA"),
+    }, async (params) => {
+        try {
+            const result = await client.get(`/verify/fiscal/${encodeURIComponent(params.id)}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ---------- verify_company ----------
+    server.tool("verify_company", "Full company data by P.IVA/CF: denominazione, PEC, codice destinatario, indirizzo, ATECO, soci.", {
+        id: z.string().describe("P.IVA or codice fiscale"),
+    }, async (params) => {
+        try {
+            const result = await client.get(`/verify/company/${encodeURIComponent(params.id)}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ---------- verify_simple_company ----------
+    server.tool("verify_simple_company", "Basic company info by P.IVA/CF (simplified view).", {
+        id: z.string().describe("P.IVA or codice fiscale"),
+    }, async (params) => {
+        try {
+            const result = await client.get(`/verify/simple-company/${encodeURIComponent(params.id)}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ---------- verify_split_payment ----------
+    server.tool("verify_split_payment", "Check split payment (scissione pagamenti) status for a P.IVA.", {
+        id: z.string().describe("P.IVA to check"),
+    }, async (params) => {
+        try {
+            const result = await client.get(`/verify/split-payment/${encodeURIComponent(params.id)}`);
+            return formatResponse(result.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=verify.js.map

package/dist/tools/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/tools/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,UAAU,mBAAmB,CACjC,MAAiB,EACjB,MAAmB;IAEnB,yCAAyC;IACzC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,uEAAuE,EACvE;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACnD,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACnF,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,uCAAuC;IACvC,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,iGAAiG,EACjG;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACnD,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACpF,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8CAA8C;IAC9C,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,mDAAmD,EACnD;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACnD,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,0BAA0B,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3F,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,6CAA6C;IAC7C,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,+DAA+D,EAC/D;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;KAC1C,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,yBAAyB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1F,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/webhooks.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module tools/webhooks
+ *
+ * Webhook configuration tools.
+ *
+ * Provides 5 tools:
+ * - `list_webhook_configs` -- List all webhook subscriptions.
+ * - `create_webhook_config` -- Subscribe to one of 13 event types.
+ * - `get_webhook_config` -- Get a subscription by ID.
+ * - `update_webhook_config` -- Update event type, URL, or authentication.
+ * - `delete_webhook_config` -- Remove a subscription.
+ *
+ * Supported event types: `supplier-invoice`, `customer-invoice`,
+ * `customer-notification`, `invoice-status-quarantena`, `invoice-status-invoice-error`,
+ * `legal-storage-missing-vat`, `legal-storage-receipt`, `receipt`, `receipt-retry`,
+ * `receipt-error`, `appointee`, `sistemats-receipt-ready`, `job`.
+ *
+ * @see https://docs.acubeapi.com/ -- A-Cube webhook endpoints
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AcubeClient } from "../client.js";
+export declare function registerWebhookTools(server: McpServer, client: AcubeClient): void;

package/dist/tools/webhooks.js

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { formatResponse, errorResponse } from "../response.js";
+export function registerWebhookTools(server, client) {
+    // ── list_webhook_configs ────────────────────────────────────────────
+    server.tool("list_webhook_configs", "List all webhook configurations.", {}, async () => {
+        try {
+            const response = await client.get("/api-configurations");
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── create_webhook_config ───────────────────────────────────────────
+    server.tool("create_webhook_config", "Create a webhook for A-Cube events.", {
+        event: z
+            .enum([
+            "supplier-invoice", "customer-invoice", "customer-notification",
+            "invoice-status-quarantena", "invoice-status-invoice-error",
+            "legal-storage-missing-vat", "legal-storage-receipt",
+            "receipt", "receipt-retry", "receipt-error",
+            "appointee", "sistemats-receipt-ready", "job",
+        ])
+            .describe("Event type"),
+        target_url: z.string().url().describe("Callback URL"),
+        authentication_type: z.enum(["header", "query"]).optional().describe("Auth method"),
+        authentication_key: z.string().optional().describe("Auth header/param name"),
+        authentication_token: z.string().optional().describe("Auth token"),
+    }, async (params) => {
+        try {
+            const body = {
+                event: params.event,
+                target_url: params.target_url,
+            };
+            if (params.authentication_type !== undefined)
+                body.authentication_type = params.authentication_type;
+            if (params.authentication_key !== undefined)
+                body.authentication_key = params.authentication_key;
+            if (params.authentication_token !== undefined)
+                body.authentication_token = params.authentication_token;
+            const response = await client.post("/api-configurations", body);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── get_webhook_config ──────────────────────────────────────────────
+    server.tool("get_webhook_config", "Get a webhook configuration by ID.", {
+        id: z.string().describe("Webhook config ID"),
+    }, async (params) => {
+        try {
+            const response = await client.get(`/api-configurations/${encodeURIComponent(params.id)}`);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── update_webhook_config ───────────────────────────────────────────
+    server.tool("update_webhook_config", "Update a webhook configuration.", {
+        id: z.string().describe("Webhook config ID"),
+        config: z.record(z.unknown()).describe("Fields to update"),
+    }, async (params) => {
+        try {
+            const response = await client.put(`/api-configurations/${encodeURIComponent(params.id)}`, params.config);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+    // ── delete_webhook_config ───────────────────────────────────────────
+    server.tool("delete_webhook_config", "Delete a webhook configuration.", {
+        id: z.string().describe("Webhook config ID to delete"),
+    }, async (params) => {
+        try {
+            const response = await client.delete(`/api-configurations/${encodeURIComponent(params.id)}`);
+            return formatResponse(response.data);
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "mcp-server-acube",
+  "version": "0.1.0",
+  "description": "MCP server for A-Cube API - Italian electronic invoicing (SDI/FatturaPA), smart receipts, company verification, and more",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-server-acube": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "acube",
+    "fattura-elettronica",
+    "fatturapa",
+    "sdi",
+    "e-invoicing",
+    "italian-invoicing",
+    "agenzia-entrate",
+    "claude",
+    "ai"
+  ],
+  "author": "Cipay Srl <dev@cipay.it> (https://www.cipay.it)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nick-preda/mcp-server-acube.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nick-preda/mcp-server-acube/issues"
+  },
+  "homepage": "https://github.com/nick-preda/mcp-server-acube#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.7.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  }
+}