@energio/holded-mcp 1.0.0

package/dist/tools/factory.js

@@ -0,0 +1,145 @@
+/**
+ * CRUD tool factory — registerCrudTools
+ *
+ * Generates standard list / get / create / update / delete MCP tools
+ * from a declarative CrudToolConfig, eliminating boilerplate.
+ */
+import { makeApiRequest, toStructuredContent } from "../services/api.js";
+import { buildToolResponse, withErrorHandling } from "./utilities.js";
+/**
+ * Register CRUD tools for a resource on the given MCP server.
+ *
+ * Only tools whose schemas are provided in the config will be registered.
+ */
+export function registerCrudTools(server, config) {
+    const { module, toolPrefix, resource, resourcePlural, endpoint, listEndpoint, idParam, schemas, titles, descriptions, formatters, listQueryParams, bodyTransform, } = config;
+    // ── List ───────────────────────────────────────────────
+    if (schemas.list) {
+        server.registerTool(`${toolPrefix}_list_${resourcePlural}`, {
+            title: titles.list,
+            description: descriptions.list,
+            inputSchema: schemas.list,
+            annotations: {
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        }, withErrorHandling(async (params) => {
+            const queryParams = {};
+            if (params.page > 1) {
+                queryParams.page = params.page;
+            }
+            if (listQueryParams) {
+                Object.assign(queryParams, listQueryParams(params));
+            }
+            const items = await makeApiRequest(module, listEndpoint ?? endpoint, "GET", undefined, queryParams);
+            return buildToolResponse(items, params.response_format, formatters.list, {
+                [resourcePlural]: items,
+                count: items.length,
+                page: params.page,
+            });
+        }));
+    }
+    // ── Get ────────────────────────────────────────────────
+    if (schemas.get) {
+        server.registerTool(`${toolPrefix}_get_${resource}`, {
+            title: titles.get,
+            description: descriptions.get,
+            inputSchema: schemas.get,
+            annotations: {
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        }, withErrorHandling(async (params) => {
+            const id = params[idParam];
+            const item = await makeApiRequest(module, `${endpoint}/${id}`, "GET");
+            return buildToolResponse(item, params.response_format, formatters.single);
+        }));
+    }
+    const Resource = resource.charAt(0).toUpperCase() + resource.slice(1);
+    // ── Create ─────────────────────────────────────────────
+    if (schemas.create) {
+        server.registerTool(`${toolPrefix}_create_${resource}`, {
+            title: titles.create,
+            description: descriptions.create,
+            inputSchema: schemas.create,
+            annotations: {
+                readOnlyHint: false,
+                destructiveHint: false,
+                idempotentHint: false,
+                openWorldHint: true,
+            },
+        }, withErrorHandling(async (params) => {
+            const { response_format: _response_format, ...body } = params;
+            const requestBody = bodyTransform ? bodyTransform(body) : body;
+            const item = await makeApiRequest(module, endpoint, "POST", requestBody);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${Resource} created successfully.\n\n${JSON.stringify(item, null, 2)}`,
+                    },
+                ],
+                structuredContent: toStructuredContent(item),
+            };
+        }));
+    }
+    // ── Update ─────────────────────────────────────────────
+    if (schemas.update) {
+        server.registerTool(`${toolPrefix}_update_${resource}`, {
+            title: titles.update,
+            description: descriptions.update,
+            inputSchema: schemas.update,
+            annotations: {
+                readOnlyHint: false,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        }, withErrorHandling(async (params) => {
+            const id = params[idParam];
+            const { [idParam]: _id, response_format: _rf, ...updateData } = params;
+            const requestBody = bodyTransform ? bodyTransform(updateData) : updateData;
+            const item = await makeApiRequest(module, `${endpoint}/${id}`, "PUT", requestBody);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${Resource} updated successfully.\n\n${JSON.stringify(item, null, 2)}`,
+                    },
+                ],
+                structuredContent: toStructuredContent(item),
+            };
+        }));
+    }
+    // ── Delete ─────────────────────────────────────────────
+    if (schemas.delete) {
+        server.registerTool(`${toolPrefix}_delete_${resource}`, {
+            title: titles.delete,
+            description: descriptions.delete,
+            inputSchema: schemas.delete,
+            annotations: {
+                readOnlyHint: false,
+                destructiveHint: true,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+        }, withErrorHandling(async (params) => {
+            const id = params[idParam];
+            await makeApiRequest(module, `${endpoint}/${id}`, "DELETE");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${Resource} ${id} deleted successfully.`,
+                    },
+                ],
+                structuredContent: { deleted: true, id },
+            };
+        }));
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/tools/factory.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * Contact and Contact Group tools for Holded API
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Contact, ContactGroup } from "../../types.js";
+/**
+ * Format contacts as markdown
+ */
+export declare function formatContactsMarkdown(contacts: Contact[]): string;
+/**
+ * Format a single contact as markdown
+ */
+export declare function formatContactMarkdown(contact: Contact): string;
+/**
+ * Format contact groups as markdown
+ */
+export declare function formatContactGroupsMarkdown(groups: ContactGroup[]): string;
+/**
+ * Format a single contact group as markdown
+ */
+export declare function formatContactGroupMarkdown(group: ContactGroup): string;
+/**
+ * Register all contact-related tools
+ */
+export declare function registerContactTools(server: McpServer): void;
+//# sourceMappingURL=contacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../../src/tools/invoicing/contacts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAsBvD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAkBlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA2B9D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAU1E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0S5D"}

package/dist/tools/invoicing/contacts.js

@@ -0,0 +1,358 @@
+/**
+ * Contact and Contact Group tools for Holded API
+ */
+import { makeApiRequest, makeMultipartApiRequest } from "../../services/api.js";
+import { ResponseFormat } from "../../constants.js";
+import { ListContactsInputSchema, GetContactInputSchema, CreateContactInputSchema, UpdateContactInputSchema, DeleteContactInputSchema, ListContactGroupsInputSchema, GetContactGroupInputSchema, CreateContactGroupInputSchema, UpdateContactGroupInputSchema, DeleteContactGroupInputSchema, ListContactAttachmentsInputSchema, GetContactAttachmentInputSchema, UploadContactAttachmentInputSchema, } from "../../schemas/invoicing/contacts.js";
+import { registerCrudTools } from "../factory.js";
+import { withErrorHandling } from "../utilities.js";
+/**
+ * Format contacts as markdown
+ */
+export function formatContactsMarkdown(contacts) {
+    if (!contacts.length) {
+        return "No contacts found.";
+    }
+    const lines = ["# Contacts", "", `Found ${contacts.length} contacts:`, ""];
+    for (const contact of contacts) {
+        lines.push(`## ${contact.name}`);
+        lines.push(`- **ID**: ${contact.id}`);
+        if (contact.email)
+            lines.push(`- **Email**: ${contact.email}`);
+        if (contact.phone)
+            lines.push(`- **Phone**: ${contact.phone}`);
+        if (contact.type)
+            lines.push(`- **Type**: ${contact.type}`);
+        if (contact.vatnumber)
+            lines.push(`- **VAT**: ${contact.vatnumber}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a single contact as markdown
+ */
+export function formatContactMarkdown(contact) {
+    const lines = [`# ${contact.name}`, "", `**ID**: ${contact.id}`, ""];
+    if (contact.code)
+        lines.push(`- **Code**: ${contact.code}`);
+    if (contact.email)
+        lines.push(`- **Email**: ${contact.email}`);
+    if (contact.phone)
+        lines.push(`- **Phone**: ${contact.phone}`);
+    if (contact.mobile)
+        lines.push(`- **Mobile**: ${contact.mobile}`);
+    if (contact.type)
+        lines.push(`- **Type**: ${contact.type}`);
+    if (contact.vatnumber)
+        lines.push(`- **VAT Number**: ${contact.vatnumber}`);
+    if (contact.tradeName)
+        lines.push(`- **Trade Name**: ${contact.tradeName}`);
+    if (contact.currency)
+        lines.push(`- **Currency**: ${contact.currency}`);
+    if (contact.billAddress) {
+        lines.push("", "### Billing Address");
+        const addr = contact.billAddress;
+        if (addr.address)
+            lines.push(`- ${addr.address}`);
+        if (addr.city)
+            lines.push(`- ${addr.city}`);
+        if (addr.postalCode)
+            lines.push(`- ${addr.postalCode}`);
+        if (addr.province)
+            lines.push(`- ${addr.province}`);
+        if (addr.country)
+            lines.push(`- ${addr.country}`);
+    }
+    if (contact.notes) {
+        lines.push("", "### Notes", contact.notes);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format contact groups as markdown
+ */
+export function formatContactGroupsMarkdown(groups) {
+    if (!groups.length) {
+        return "No contact groups found.";
+    }
+    const lines = ["# Contact Groups", "", `Found ${groups.length} groups:`, ""];
+    for (const group of groups) {
+        lines.push(`- **${group.name}** (ID: ${group.id})`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format a single contact group as markdown
+ */
+export function formatContactGroupMarkdown(group) {
+    return `# ${group.name}\n\n**ID**: ${group.id}`;
+}
+/**
+ * Register all contact-related tools
+ */
+export function registerContactTools(server) {
+    // ── Contacts CRUD via factory ─────────────────────────
+    registerCrudTools(server, {
+        module: "invoicing",
+        toolPrefix: "holded_invoicing",
+        resource: "contact",
+        resourcePlural: "contacts",
+        endpoint: "contacts",
+        idParam: "contact_id",
+        schemas: {
+            list: ListContactsInputSchema,
+            get: GetContactInputSchema,
+            create: CreateContactInputSchema,
+            update: UpdateContactInputSchema,
+            delete: DeleteContactInputSchema,
+        },
+        titles: {
+            list: "List Holded Contacts",
+            get: "Get Holded Contact",
+            create: "Create Holded Contact",
+            update: "Update Holded Contact",
+            delete: "Delete Holded Contact",
+        },
+        descriptions: {
+            list: `List all contacts from Holded (clients, suppliers, etc.).
+
+Returns paginated list of contacts (max 500 per page). Use page parameter to navigate through results.
+
+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 contacts with id, name, email, phone, type, and other details.`,
+            get: `Get a specific contact by ID from Holded.
+
+Args:
+  - contact_id (string): The contact ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Contact details including name, email, phone, addresses, and custom fields.`,
+            create: `Create a new contact in Holded.
+
+Args:
+  - name (string): Contact name (required)
+  - email (string): Email address
+  - phone (string): Phone number
+  - type ('client' | 'supplier' | 'lead' | 'debtor' | 'creditor'): Contact type
+  - And other optional fields for address, social networks, defaults, etc.
+
+Returns:
+  The created contact with its assigned ID.`,
+            update: `Update an existing contact in Holded. Only provided fields will be updated.
+
+Args:
+  - contact_id (string): The contact ID to update (required)
+  - name (string): Contact name
+  - email (string): Email address
+  - phone (string): Phone number
+  - And other optional fields to update
+
+Returns:
+  The updated contact.`,
+            delete: `Delete a contact from Holded.
+
+Args:
+  - contact_id (string): The contact ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        },
+        formatters: {
+            list: formatContactsMarkdown,
+            single: formatContactMarkdown,
+        },
+    });
+    // ── Contact Groups CRUD via factory ───────────────────
+    registerCrudTools(server, {
+        module: "invoicing",
+        toolPrefix: "holded_invoicing",
+        resource: "contact_group",
+        resourcePlural: "contact_groups",
+        endpoint: "contactgroups",
+        idParam: "group_id",
+        schemas: {
+            list: ListContactGroupsInputSchema,
+            get: GetContactGroupInputSchema,
+            create: CreateContactGroupInputSchema,
+            update: UpdateContactGroupInputSchema,
+            delete: DeleteContactGroupInputSchema,
+        },
+        titles: {
+            list: "List Holded Contact Groups",
+            get: "Get Holded Contact Group",
+            create: "Create Holded Contact Group",
+            update: "Update Holded Contact Group",
+            delete: "Delete Holded Contact Group",
+        },
+        descriptions: {
+            list: `List all contact groups from Holded.
+
+Args:
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of contact groups with id and name.`,
+            get: `Get a specific contact group by ID from Holded.
+
+Args:
+  - group_id (string): The contact group ID to retrieve (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Contact group details.`,
+            create: `Create a new contact group in Holded.
+
+Args:
+  - name (string): Contact group name (required)
+  - pos (number): Position/order in the list
+
+Returns:
+  The created contact group with its assigned ID.`,
+            update: `Update an existing contact group in Holded. Only provided fields will be updated.
+
+Args:
+  - group_id (string): The contact group ID to update (required)
+  - name (string): Contact group name
+  - pos (number): Position/order in the list
+
+Returns:
+  The updated contact group.`,
+            delete: `Delete a contact group from Holded.
+
+Args:
+  - group_id (string): The contact group ID to delete (required)
+
+Returns:
+  Confirmation of deletion.`,
+        },
+        formatters: {
+            list: formatContactGroupsMarkdown,
+            single: formatContactGroupMarkdown,
+        },
+    });
+    // ── Manual tools (attachment-specific endpoints) ──────
+    // List Contact Attachments
+    server.registerTool("holded_invoicing_list_contact_attachments", {
+        title: "List Holded Contact Attachments",
+        description: `Get attachments list for a given contact from Holded.
+
+Args:
+  - contact_id (string): The contact ID to list attachments for (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Array of attachment file names.`,
+        inputSchema: ListContactAttachmentsInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const typedParams = params;
+        const attachments = await makeApiRequest("invoicing", `contacts/${typedParams.contact_id}/attachments/list`, "GET");
+        let textContent;
+        if (typedParams.response_format === ResponseFormat.MARKDOWN) {
+            if (!attachments.length) {
+                textContent = `No attachments found for contact ${typedParams.contact_id}.`;
+            }
+            else {
+                const lines = ["# Contact Attachments", "", `Found ${attachments.length} attachments:`, ""];
+                for (const attachment of attachments) {
+                    lines.push(`- ${attachment}`);
+                }
+                textContent = lines.join("\n");
+            }
+        }
+        else {
+            textContent = JSON.stringify(attachments, null, 2);
+        }
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: { attachments, count: attachments.length, contactId: typedParams.contact_id },
+        };
+    }));
+    // Get Contact Attachment
+    server.registerTool("holded_invoicing_get_contact_attachment", {
+        title: "Get Holded Contact Attachment",
+        description: `Get a specific attachment for a contact from Holded.
+
+Args:
+  - contact_id (string): The contact ID (required)
+  - filename (string): The attachment filename (required)
+  - response_format ('json' | 'markdown'): Output format (default: 'json')
+
+Returns:
+  Attachment file data (binary format, base64 encoded or URL).`,
+        inputSchema: GetContactAttachmentInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const typedParams = params;
+        const result = await makeApiRequest("invoicing", `contacts/${typedParams.contact_id}/attachments/get`, "GET", undefined, { filename: typedParams.filename });
+        let textContent;
+        if (typedParams.response_format === ResponseFormat.MARKDOWN) {
+            if (typeof result === "string") {
+                textContent = `# Contact Attachment\n\n**File**: ${typedParams.filename}\n**Data**: ${result.substring(0, 100)}...`;
+            }
+            else {
+                textContent = result.url
+                    ? `# Contact Attachment\n\n**File**: ${typedParams.filename}\n**URL**: ${result.url}`
+                    : `# Contact Attachment\n\n**File**: ${typedParams.filename}\nAttachment data available.`;
+            }
+        }
+        else {
+            textContent = JSON.stringify(result, null, 2);
+        }
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent: { contactId: typedParams.contact_id, filename: typedParams.filename, data: result },
+        };
+    }));
+    // Upload Contact Attachment
+    server.registerTool("holded_invoicing_upload_contact_attachment", {
+        title: "Upload Holded Contact Attachment",
+        description: `Upload an attachment to a contact in Holded.
+
+Args:
+  - contact_id (string): The contact ID to upload attachment to (required)
+  - file_content (string): File content as base64 encoded string (required)
+  - file_name (string): File name (required)
+
+Returns:
+  Confirmation of attachment upload with status and info.`,
+        inputSchema: UploadContactAttachmentInputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (params) => {
+        const { contact_id, file_content, file_name } = params;
+        // Convert base64 to buffer
+        const fileBuffer = Buffer.from(file_content, "base64");
+        const result = await makeMultipartApiRequest("invoicing", `contacts/${contact_id}/attachments`, fileBuffer, file_name);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Contact attachment uploaded successfully.\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+            structuredContent: { uploaded: true, contactId: contact_id, fileName: file_name, ...result },
+        };
+    }));
+}
+//# sourceMappingURL=contacts.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Document tools for Holded API (invoices, estimates, purchases, etc.)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Document } from "../../types.js";
+/**
+ * Format documents as markdown
+ */
+export declare function formatDocumentsMarkdown(documents: Document[], docType: string): string;
+/**
+ * Format a single document as markdown
+ */
+export declare function formatDocumentMarkdown(doc: Document): string;
+/**
+ * Register all document-related tools
+ */
+export declare function registerDocumentTools(server: McpServer): void;
+//# sourceMappingURL=documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../src/tools/invoicing/documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAiC1C;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBtF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAgC5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwpB7D"}