@energio/holded-mcp 1.0.0

package/dist/tools/invoicing/expenses-accounts.js

@@ -0,0 +1,111 @@
+/**
+ * Expenses Account tools for Holded API
+ */
+import { ListExpensesAccountsInputSchema, GetExpensesAccountInputSchema, CreateExpensesAccountInputSchema, UpdateExpensesAccountInputSchema, DeleteExpensesAccountInputSchema, } from "../../schemas/invoicing/expenses-accounts.js";
+import { registerCrudTools } from "../factory.js";
+/**
+ * Format expenses accounts as markdown
+ */
+export function formatExpensesAccountsMarkdown(accounts) {
+    if (!accounts.length) {
+        return "No expenses accounts found.";
+    }
+    const lines = ["# Expenses Accounts", "", `Found ${accounts.length} expenses accounts:`, ""];
+    for (const account of accounts) {
+        lines.push(`## ${account.name}`);
+        lines.push(`- **ID**: ${account.id}`);
+        if (account.code)
+            lines.push(`- **Code**: ${account.code}`);
+        if (account.description)
+            lines.push(`- **Description**: ${account.description}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a single expenses account as markdown
+ */
+export function formatExpensesAccountMarkdown(account) {
+    const lines = [`# ${account.name}`, "", `**ID**: ${account.id}`, ""];
+    if (account.code)
+        lines.push(`- **Code**: ${account.code}`);
+    if (account.description)
+        lines.push(`- **Description**: ${account.description}`);
+    return lines.join("\n");
+}
+/**
+ * Register all expenses account-related tools
+ */
+export function registerExpensesAccountTools(server) {
+    registerCrudTools(server, {
+        module: "invoicing",
+        toolPrefix: "holded_invoicing",
+        resource: "expenses_account",
+        resourcePlural: "expenses_accounts",
+        endpoint: "expensesaccounts",
+        idParam: "expenses_account_id",
+        schemas: {
+            list: ListExpensesAccountsInputSchema,
+            get: GetExpensesAccountInputSchema,
+            create: CreateExpensesAccountInputSchema,
+            update: UpdateExpensesAccountInputSchema,
+            delete: DeleteExpensesAccountInputSchema,
+        },
+        titles: {
+            list: "List Holded Expenses Accounts",
+            get: "Get Holded Expenses Account",
+            create: "Create Holded Expenses Account",
+            update: "Update Holded Expenses Account",
+            delete: "Delete Holded Expenses Account",
+        },
+        descriptions: {
+            list: `List all expenses accounts from Holded.
+
+Args:
+  - page (number): Page number for pagination (default: 1, max 500 items per page)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of expenses accounts with id, name, code, and description.`,
+            get: `Get a specific expenses account by ID from Holded.
+
+Args:
+  - expenses_account_id (string): The expenses account ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Expenses account details including name, code, and description.`,
+            create: `Create a new expenses account in Holded.
+
+Args:
+  - name (string): Expenses account name (required)
+  - code (string): Account code
+  - description (string): Account description
+
+Returns:
+  The created expenses account with its assigned ID.`,
+            update: `Update an existing expenses account in Holded.
+
+Args:
+  - expenses_account_id (string): The expenses account ID to update (required)
+  - name (string): Expenses account name
+  - code (string): Account code
+  - description (string): Account description
+
+Returns:
+  The updated expenses account.`,
+            delete: `Delete an expenses account from Holded.
+
+Args:
+  - expenses_account_id (string): The expenses account ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        },
+        formatters: {
+            list: formatExpensesAccountsMarkdown,
+            single: formatExpensesAccountMarkdown,
+        },
+    });
+}
+//# sourceMappingURL=expenses-accounts.js.map

package/dist/tools/invoicing/expenses-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expenses-accounts.js","sourceRoot":"","sources":["../../../src/tools/invoicing/expenses-accounts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC7B,gCAAgC,EAChC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUlD;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,QAA2B;IACxE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,6BAA6B,CAAC;IACvC,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,qBAAqB,EAAE,EAAE,EAAE,SAAS,QAAQ,CAAC,MAAM,qBAAqB,EAAE,EAAE,CAAC,CAAC;IAE7F,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,IAAI,OAAO,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAwB;IACpE,MAAM,KAAK,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEjF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,iBAAiB,CAAkB,MAAM,EAAE;QACzC,MAAM,EAAE,WAAW;QACnB,UAAU,EAAE,kBAAkB;QAC9B,QAAQ,EAAE,kBAAkB;QAC5B,cAAc,EAAE,mBAAmB;QACnC,QAAQ,EAAE,kBAAkB;QAC5B,OAAO,EAAE,qBAAqB;QAC9B,OAAO,EAAE;YACP,IAAI,EAAE,+BAA+B;YACrC,GAAG,EAAE,6BAA6B;YAClC,MAAM,EAAE,gCAAgC;YACxC,MAAM,EAAE,gCAAgC;YACxC,MAAM,EAAE,gCAAgC;SACzC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,+BAA+B;YACrC,GAAG,EAAE,6BAA6B;YAClC,MAAM,EAAE,gCAAgC;YACxC,MAAM,EAAE,gCAAgC;YACxC,MAAM,EAAE,gCAAgC;SACzC;QACD,YAAY,EAAE;YACZ,IAAI,EAAE;;;;;;;mEAOuD;YAC7D,GAAG,EAAE;;;;;;;kEAOuD;YAC5D,MAAM,EAAE;;;;;;;;qDAQuC;YAC/C,MAAM,EAAE;;;;;;;;;gCASkB;YAC1B,MAAM,EAAE;;;;;;4BAMc;SACvB;QACD,UAAU,EAAE;YACV,IAAI,EAAE,8BAA8B;YACpC,MAAM,EAAE,6BAA6B;SACtC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/invoicing/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Invoicing module tools registration
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all invoicing-related tools
+ */
+export declare function registerInvoicingTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/invoicing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/invoicing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAa9D"}

package/dist/tools/invoicing/index.js

@@ -0,0 +1,33 @@
+/**
+ * Invoicing module tools registration
+ */
+import { registerContactTools } from "./contacts.js";
+import { registerProductTools } from "./products.js";
+import { registerDocumentTools } from "./documents.js";
+import { registerPaymentTools } from "./payments.js";
+import { registerTreasuryTools } from "./treasury.js";
+import { registerNumberingSeriesTools } from "./numbering-series.js";
+import { registerWarehouseTools } from "./warehouses.js";
+import { registerServicesTools } from "./services.js";
+import { registerTaxesTools } from "./taxes.js";
+import { registerSalesChannelTools } from "./sales-channels.js";
+import { registerExpensesAccountTools } from "./expenses-accounts.js";
+import { registerRemittanceTools } from "./remittances.js";
+/**
+ * Register all invoicing-related tools
+ */
+export function registerInvoicingTools(server) {
+    registerContactTools(server);
+    registerProductTools(server);
+    registerDocumentTools(server);
+    registerPaymentTools(server);
+    registerTreasuryTools(server);
+    registerNumberingSeriesTools(server);
+    registerWarehouseTools(server);
+    registerServicesTools(server);
+    registerTaxesTools(server);
+    registerSalesChannelTools(server);
+    registerExpensesAccountTools(server);
+    registerRemittanceTools(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/invoicing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/invoicing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/invoicing/numbering-series.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Numbering Series tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register all numbering series-related tools
+ */
+export declare function registerNumberingSeriesTools(server: McpServer): void;
+//# sourceMappingURL=numbering-series.d.ts.map

package/dist/tools/invoicing/numbering-series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-series.d.ts","sourceRoot":"","sources":["../../../src/tools/invoicing/numbering-series.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBpE;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2LpE"}

package/dist/tools/invoicing/numbering-series.js

@@ -0,0 +1,161 @@
+/**
+ * Numbering Series tools for Holded API
+ */
+import { makeApiRequest, toStructuredContent } from "../../services/api.js";
+import { ResponseFormat } from "../../constants.js";
+import { withErrorHandling } from "../utilities.js";
+import { GetNumberingSeriesInputSchema, CreateNumberingSeriesInputSchema, UpdateNumberingSeriesInputSchema, DeleteNumberingSeriesInputSchema, } from "../../schemas/invoicing/numbering-series.js";
+/**
+ * Register all numbering series-related tools
+ */
+export function registerNumberingSeriesTools(server) {
+    // Get Numbering Series
+    server.registerTool("holded_invoicing_get_numbering_series", {
+        title: "Get Holded Numbering Series",
+        description: `Get numbering series for a document type in Holded.
+
+Args:
+  - doc_type (string): Document type (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of numbering series with id, name, prefix, suffix, and next number.`,
+        inputSchema: GetNumberingSeriesInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { doc_type, response_format } = params;
+        const series = await makeApiRequest("invoicing", `numberseries/${doc_type}`, "GET");
+        let textContent;
+        if (response_format === ResponseFormat.MARKDOWN) {
+            if (!series.length) {
+                textContent = `No numbering series found for ${doc_type}.`;
+            }
+            else {
+                const lines = [`# Numbering Series for ${doc_type}`, "", `Found ${series.length} series:`, ""];
+                for (const s of series) {
+                    lines.push(`## ${s.name}`);
+                    lines.push(`- **ID**: ${s.id}`);
+                    if (s.prefix)
+                        lines.push(`- **Prefix**: ${s.prefix}`);
+                    if (s.suffix)
+                        lines.push(`- **Suffix**: ${s.suffix}`);
+                    lines.push(`- **Next Number**: ${s.nextNumber}`);
+                    lines.push("");
+                }
+                textContent = lines.join("\n");
+            }
+        }
+        else {
+            textContent = JSON.stringify(series, null, 2);
+        }
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: { series, count: series.length, docType: doc_type },
+        };
+    }));
+    // Create Numbering Series
+    server.registerTool("holded_invoicing_create_numbering_serie", {
+        title: "Create Holded Numbering Series",
+        description: `Create a new numbering series for a document type in Holded.
+
+Args:
+  - doc_type (string): Document type (required)
+  - name (string): Series name (required)
+  - format (string): Format string for document numbers (e.g., 'F17%%%%')
+  - last (integer): Last number used in the series
+  - type (string): Document type (optional, already in path)
+
+Returns:
+  The created numbering series.`,
+        inputSchema: CreateNumberingSeriesInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { doc_type, ...seriesData } = params;
+        const series = await makeApiRequest("invoicing", `numberseries/${doc_type}`, "POST", seriesData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Numbering series created successfully.\n\n${JSON.stringify(series, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(series),
+        };
+    }));
+    // Update Numbering Series
+    server.registerTool("holded_invoicing_update_numbering_serie", {
+        title: "Update Holded Numbering Series",
+        description: `Update an existing numbering series in Holded.
+
+Args:
+  - doc_type (string): Document type (required)
+  - numbering_series_id (string): The numbering series ID to update (required)
+  - name (string): Series name
+  - format (string): Format string for document numbers
+  - last (string): Last number used in the series (string format)
+
+Returns:
+  The updated numbering series.`,
+        inputSchema: UpdateNumberingSeriesInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { doc_type, numbering_series_id, ...updateData } = params;
+        const series = await makeApiRequest("invoicing", `numberseries/${doc_type}/${numbering_series_id}`, "PUT", updateData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Numbering series updated successfully.\n\n${JSON.stringify(series, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(series),
+        };
+    }));
+    // Delete Numbering Series
+    server.registerTool("holded_invoicing_delete_numbering_serie", {
+        title: "Delete Holded Numbering Series",
+        description: `Delete a numbering series from Holded.
+
+Args:
+  - doc_type (string): Document type (required)
+  - numbering_series_id (string): The numbering series ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        inputSchema: DeleteNumberingSeriesInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { doc_type, numbering_series_id } = params;
+        await makeApiRequest("invoicing", `numberseries/${doc_type}/${numbering_series_id}`, "DELETE");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Numbering series ${numbering_series_id} deleted successfully.`,
+                },
+            ],
+            structuredContent: { deleted: true, id: numbering_series_id, docType: doc_type },
+        };
+    }));
+}
+//# sourceMappingURL=numbering-series.js.map

package/dist/tools/invoicing/numbering-series.js.map

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

package/dist/tools/invoicing/payments.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Payment tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Payment } from "../../types.js";
+/**
+ * Format payments as markdown
+ */
+export declare function formatPaymentsMarkdown(payments: Payment[]): string;
+/**
+ * Format a single payment as markdown
+ */
+export declare function formatPaymentMarkdown(payment: Payment): string;
+/**
+ * Register all payment-related tools
+ */
+export declare function registerPaymentTools(server: McpServer): void;
+//# sourceMappingURL=payments.d.ts.map

package/dist/tools/invoicing/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../../src/tools/invoicing/payments.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAazC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAmBlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAS9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuJ5D"}

package/dist/tools/invoicing/payments.js

@@ -0,0 +1,175 @@
+/**
+ * Payment tools for Holded API
+ */
+import { makeApiRequest, toStructuredContent } from "../../services/api.js";
+import { CreatePaymentInputSchema, ListPaymentsInputSchema, GetPaymentInputSchema, UpdatePaymentInputSchema, DeletePaymentInputSchema, } from "../../schemas/invoicing/payments.js";
+import { registerCrudTools } from "../factory.js";
+import { withErrorHandling } from "../utilities.js";
+/**
+ * Format payments as markdown
+ */
+export function formatPaymentsMarkdown(payments) {
+    if (!payments.length) {
+        return "No payments found.";
+    }
+    const lines = ["# Payments", "", `Found ${payments.length} payments:`, ""];
+    for (const payment of payments) {
+        lines.push(`## Payment ${payment.id}`);
+        lines.push(`- **ID**: ${payment.id}`);
+        lines.push(`- **Document ID**: ${payment.docId}`);
+        lines.push(`- **Amount**: ${payment.amount}`);
+        lines.push(`- **Date**: ${new Date(payment.date * 1000).toLocaleDateString()}`);
+        if (payment.accountId)
+            lines.push(`- **Account ID**: ${payment.accountId}`);
+        if (payment.desc)
+            lines.push(`- **Description**: ${payment.desc}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a single payment as markdown
+ */
+export function formatPaymentMarkdown(payment) {
+    const lines = [`# Payment ${payment.id}`, ""];
+    lines.push(`- **ID**: ${payment.id}`);
+    lines.push(`- **Document ID**: ${payment.docId}`);
+    lines.push(`- **Amount**: ${payment.amount}`);
+    lines.push(`- **Date**: ${new Date(payment.date * 1000).toLocaleDateString()}`);
+    if (payment.accountId)
+        lines.push(`- **Account ID**: ${payment.accountId}`);
+    if (payment.desc)
+        lines.push(`- **Description**: ${payment.desc}`);
+    return lines.join("\n");
+}
+/**
+ * Register all payment-related tools
+ */
+export function registerPaymentTools(server) {
+    // ── Standard CRUD via factory (list, get, delete) ─────
+    registerCrudTools(server, {
+        module: "invoicing",
+        toolPrefix: "holded_invoicing",
+        resource: "payment",
+        resourcePlural: "payments",
+        endpoint: "payments",
+        idParam: "payment_id",
+        schemas: {
+            list: ListPaymentsInputSchema,
+            get: GetPaymentInputSchema,
+            delete: DeletePaymentInputSchema,
+        },
+        titles: {
+            list: "List Holded Payments",
+            get: "Get Holded Payment",
+            delete: "Delete Holded Payment",
+        },
+        descriptions: {
+            list: `List all payments from Holded.
+
+Args:
+  - page (number): Page number for pagination (default: 1, max 500 items per page)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of payments with id, docId, amount, date, and account information.`,
+            get: `Get a specific payment by ID from Holded.
+
+Args:
+  - payment_id (string): The payment ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Payment details including document ID, amount, date, and account information.`,
+            delete: `Delete a payment from Holded.
+
+Args:
+  - payment_id (string): The payment ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        },
+        formatters: {
+            list: formatPaymentsMarkdown,
+            single: formatPaymentMarkdown,
+        },
+    });
+    // ── Manual tools (need snake_to_camel conversion) ─────
+    // Create Payment
+    server.registerTool("holded_invoicing_create_payment", {
+        title: "Create Holded Payment",
+        description: `Create a payment for a document in Holded.
+
+Args:
+  - doc_id (string): The document ID to apply the payment to (required)
+  - amount (number): Payment amount (required)
+  - date (number): Payment date as Unix timestamp
+  - account_id (string): Treasury/Bank account ID
+  - desc (string): Payment description
+
+Returns:
+  The created payment confirmation.`,
+        inputSchema: CreatePaymentInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { doc_id, account_id, ...paymentData } = params;
+        const requestData = {
+            ...paymentData,
+            ...(account_id ? { accountId: account_id } : {}),
+        };
+        const payment = await makeApiRequest("invoicing", "payments", "POST", { docId: doc_id, ...requestData });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Payment created successfully.\n\n${JSON.stringify(payment, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(payment),
+        };
+    }));
+    // Update Payment
+    server.registerTool("holded_invoicing_update_payment", {
+        title: "Update Holded Payment",
+        description: `Update an existing payment in Holded.
+
+Args:
+  - payment_id (string): The payment ID to update (required)
+  - amount (number): Payment amount
+  - date (number): Payment date as Unix timestamp
+  - account_id (string): Treasury/Bank account ID
+  - desc (string): Payment description
+
+Returns:
+  The updated payment.`,
+        inputSchema: UpdatePaymentInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { payment_id, account_id, ...updateData } = params;
+        const requestData = {
+            ...updateData,
+            ...(account_id ? { accountId: account_id } : {}),
+        };
+        const payment = await makeApiRequest("invoicing", `payments/${payment_id}`, "PUT", requestData);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Payment updated successfully.\n\n${JSON.stringify(payment, null, 2)}`,
+                },
+            ],
+            structuredContent: toStructuredContent(payment),
+        };
+    }));
+}
+//# sourceMappingURL=payments.js.map

package/dist/tools/invoicing/payments.js.map

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

package/dist/tools/invoicing/products.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Product tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Product } from "../../types.js";
+/**
+ * Format products as markdown
+ */
+export declare function formatProductsMarkdown(products: Product[]): string;
+/**
+ * Format a single product as markdown
+ */
+export declare function formatProductMarkdown(product: Product): string;
+/**
+ * Register all product-related tools
+ */
+export declare function registerProductTools(server: McpServer): void;
+//# sourceMappingURL=products.d.ts.map

package/dist/tools/invoicing/products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../src/tools/invoicing/products.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,OAAO,EAAgB,MAAM,gBAAgB,CAAC;AAuBvD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAkBlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA8B9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0X5D"}