@frihet/mcp-server 1.3.2 → 1.5.0

package/dist/tools/crm.js

@@ -0,0 +1,181 @@
+/**
+ * CRM subcollection tools for the Frihet MCP server.
+ *
+ * Contacts, activities, and notes — all scoped under a client.
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, mutateContent, enrichResponse, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, DELETE_ANNOTATIONS, paginatedOutput, deleteResultOutput, contactItemOutput, activityItemOutput, noteItemOutput, } from "./shared.js";
+export function registerCrmTools(server, client) {
+    // ================================================================
+    //  Contacts
+    // ================================================================
+    // -- list_client_contacts --
+    server.registerTool("list_client_contacts", {
+        title: "List Client Contacts",
+        description: "List all contacts for a client with optional pagination. " +
+            "Returns name, email, phone, role, and primary flag. " +
+            "/ Lista todos los contactos de un cliente con paginacion opcional.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            clientId: z.string().describe("Client ID / ID del cliente"),
+            limit: z.number().int().min(1).max(100).optional().describe("Max results (1-100) / Resultados maximos"),
+            offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+        },
+        outputSchema: paginatedOutput(contactItemOutput),
+    }, async ({ clientId, limit, offset }) => withToolLogging("list_client_contacts", async () => {
+        const result = await client.listClientContacts(clientId, { limit, offset });
+        return {
+            content: [listContent(formatPaginatedResponse("contacts", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- create_client_contact --
+    server.registerTool("create_client_contact", {
+        title: "Create Client Contact",
+        description: "Add a new contact person to a client. Requires a name at minimum. " +
+            "Example: clientId='abc123', name='Ana Garcia', email='ana@acme.com', role='CTO', isPrimary=true " +
+            "/ Anade un nuevo contacto a un cliente. Requiere al menos un nombre.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            clientId: z.string().describe("Client ID / ID del cliente"),
+            name: z.string().describe("Contact name / Nombre del contacto"),
+            email: z.string().optional().describe("Email address / Correo electronico"),
+            phone: z.string().optional().describe("Phone number / Telefono"),
+            role: z.string().optional().describe("Role or title (e.g. CEO, CTO, Billing) / Cargo o rol"),
+            isPrimary: z.boolean().optional().describe("Whether this is the primary contact / Si es el contacto principal"),
+        },
+        outputSchema: contactItemOutput,
+    }, async ({ clientId, ...data }) => withToolLogging("create_client_contact", async () => {
+        const result = await client.createClientContact(clientId, data);
+        const hints = enrichResponse("contacts", "create", result);
+        return {
+            content: [mutateContent(formatRecord("Contact created", result))],
+            structuredContent: { ...result, ...hints },
+        };
+    }));
+    // -- delete_client_contact --
+    server.registerTool("delete_client_contact", {
+        title: "Delete Client Contact",
+        description: "Permanently delete a contact from a client. This action cannot be undone. " +
+            "/ Elimina permanentemente un contacto de un cliente. Esta accion no se puede deshacer.",
+        annotations: DELETE_ANNOTATIONS,
+        inputSchema: {
+            clientId: z.string().describe("Client ID / ID del cliente"),
+            contactId: z.string().describe("Contact ID / ID del contacto"),
+        },
+        outputSchema: deleteResultOutput,
+    }, async ({ clientId, contactId }) => withToolLogging("delete_client_contact", async () => {
+        await client.deleteClientContact(clientId, contactId);
+        return {
+            content: [mutateContent(`Contact ${contactId} deleted from client ${clientId}. / Contacto ${contactId} eliminado del cliente ${clientId}.`)],
+            structuredContent: { success: true, id: contactId },
+        };
+    }));
+    // ================================================================
+    //  Activities
+    // ================================================================
+    // -- list_client_activities --
+    server.registerTool("list_client_activities", {
+        title: "List Client Activities",
+        description: "List all CRM activities for a client with optional pagination. " +
+            "Returns calls, emails, meetings, and tasks logged against the client. " +
+            "/ Lista todas las actividades CRM de un cliente con paginacion opcional.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            clientId: z.string().describe("Client ID / ID del cliente"),
+            limit: z.number().int().min(1).max(100).optional().describe("Max results (1-100) / Resultados maximos"),
+            offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+        },
+        outputSchema: paginatedOutput(activityItemOutput),
+    }, async ({ clientId, limit, offset }) => withToolLogging("list_client_activities", async () => {
+        const result = await client.listClientActivities(clientId, { limit, offset });
+        return {
+            content: [listContent(formatPaginatedResponse("activities", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- log_client_activity --
+    server.registerTool("log_client_activity", {
+        title: "Log Client Activity",
+        description: "Log a CRM activity against a client. Use to track calls, emails, meetings, or tasks. " +
+            "Example: clientId='abc123', type='call', title='Discussed Q2 proposal', description='Client interested in upgrade' " +
+            "/ Registra una actividad CRM para un cliente. Usa para rastrear llamadas, emails, reuniones o tareas.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            clientId: z.string().describe("Client ID / ID del cliente"),
+            type: z
+                .enum(["call", "email", "meeting", "task"])
+                .describe("Activity type / Tipo de actividad"),
+            title: z.string().describe("Activity title / Titulo de la actividad"),
+            description: z.string().optional().describe("Detailed description / Descripcion detallada"),
+            date: z.string().optional().describe("Activity date (ISO 8601, defaults to now) / Fecha de la actividad"),
+        },
+        outputSchema: activityItemOutput,
+    }, async ({ clientId, ...data }) => withToolLogging("log_client_activity", async () => {
+        const result = await client.logClientActivity(clientId, data);
+        return {
+            content: [mutateContent(formatRecord("Activity logged", result))],
+            structuredContent: result,
+        };
+    }));
+    // ================================================================
+    //  Notes
+    // ================================================================
+    // -- list_client_notes --
+    server.registerTool("list_client_notes", {
+        title: "List Client Notes",
+        description: "List all notes for a client with optional pagination. " +
+            "/ Lista todas las notas de un cliente con paginacion opcional.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            clientId: z.string().describe("Client ID / ID del cliente"),
+            limit: z.number().int().min(1).max(100).optional().describe("Max results (1-100) / Resultados maximos"),
+            offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+        },
+        outputSchema: paginatedOutput(noteItemOutput),
+    }, async ({ clientId, limit, offset }) => withToolLogging("list_client_notes", async () => {
+        const result = await client.listClientNotes(clientId, { limit, offset });
+        return {
+            content: [listContent(formatPaginatedResponse("notes", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- create_client_note --
+    server.registerTool("create_client_note", {
+        title: "Create Client Note",
+        description: "Add a note to a client. Notes are free-form text entries useful for keeping context. " +
+            "Example: clientId='abc123', content='Prefers invoices in English. Payment NET 30.' " +
+            "/ Anade una nota a un cliente. Las notas son texto libre para mantener contexto.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            clientId: z.string().describe("Client ID / ID del cliente"),
+            content: z.string().describe("Note content / Contenido de la nota"),
+        },
+        outputSchema: noteItemOutput,
+    }, async ({ clientId, content }) => withToolLogging("create_client_note", async () => {
+        const result = await client.createClientNote(clientId, { content });
+        return {
+            content: [mutateContent(formatRecord("Note created", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- delete_client_note --
+    server.registerTool("delete_client_note", {
+        title: "Delete Client Note",
+        description: "Permanently delete a note from a client. This action cannot be undone. " +
+            "/ Elimina permanentemente una nota de un cliente. Esta accion no se puede deshacer.",
+        annotations: DELETE_ANNOTATIONS,
+        inputSchema: {
+            clientId: z.string().describe("Client ID / ID del cliente"),
+            noteId: z.string().describe("Note ID / ID de la nota"),
+        },
+        outputSchema: deleteResultOutput,
+    }, async ({ clientId, noteId }) => withToolLogging("delete_client_note", async () => {
+        await client.deleteClientNote(clientId, noteId);
+        return {
+            content: [mutateContent(`Note ${noteId} deleted from client ${clientId}. / Nota ${noteId} eliminada del cliente ${clientId}.`)],
+            structuredContent: { success: true, id: noteId },
+        };
+    }));
+}
+//# sourceMappingURL=crm.js.map

package/dist/tools/crm.js.map

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

package/dist/tools/expenses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expenses.d.ts","sourceRoot":"","sources":["../../src/tools/expenses.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA2JnF"}
+{"version":3,"file":"expenses.d.ts","sourceRoot":"","sources":["../../src/tools/expenses.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA8KnF"}

package/dist/tools/expenses.js

@@ -2,7 +2,7 @@
  * Expense tools for the Frihet MCP server.
  */
 import { z } from "zod/v4";
-import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, getContent, mutateContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, UPDATE_ANNOTATIONS, DELETE_ANNOTATIONS, paginatedOutput, deleteResultOutput, expenseItemOutput } from "./shared.js";
+import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, getContent, mutateContent, enrichResponse, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, UPDATE_ANNOTATIONS, DELETE_ANNOTATIONS, paginatedOutput, deleteResultOutput, expenseItemOutput } from "./shared.js";
 export function registerExpenseTools(server, client) {
     // -- list_expenses --
     server.registerTool("list_expenses", {
@@ -13,6 +13,14 @@ export function registerExpenseTools(server, client) {
             "/ Lista todos los gastos con paginacion y filtros de fecha opcionales.",
         annotations: READ_ONLY_ANNOTATIONS,
         inputSchema: {
+            vendorId: z
+                .string()
+                .optional()
+                .describe("Filter by vendor ID / Filtrar por ID de proveedor"),
+            category: z
+                .string()
+                .optional()
+                .describe("Filter by expense category (e.g. 'office', 'travel') / Filtrar por categoria"),
             from: z
                 .string()
                 .optional()
@@ -21,15 +29,24 @@ export function registerExpenseTools(server, client) {
                 .string()
                 .optional()
                 .describe("End date filter (YYYY-MM-DD) / Fecha fin"),
+            fields: z
+                .string()
+                .optional()
+                .describe("Comma-separated field names to return (e.g. 'id,description,amount') / Campos a devolver"),
             limit: z.number().int().min(1).max(100).optional().describe("Max results (1-100) / Resultados maximos"),
             offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+            after: z
+                .string()
+                .optional()
+                .describe("Cursor for cursor-based pagination (document ID) / Cursor para paginacion basada en cursor"),
         },
         outputSchema: paginatedOutput(expenseItemOutput),
-    }, async ({ from, to, limit, offset }) => withToolLogging("list_expenses", async () => {
-        const result = await client.listExpenses({ limit, offset, from, to });
+    }, async ({ from, to, limit, offset, vendorId, category, fields, after }) => withToolLogging("list_expenses", async () => {
+        const result = await client.listExpenses({ limit, offset, after, fields, from, to, vendorId, category });
+        const hints = enrichResponse("expenses", "list", result.data);
         return {
             content: [listContent(formatPaginatedResponse("expenses", result))],
-            structuredContent: result,
+            structuredContent: { ...result, ...hints },
         };
     }));
     // -- get_expense --
@@ -78,9 +95,10 @@ export function registerExpenseTools(server, client) {
         outputSchema: expenseItemOutput,
     }, async (input) => withToolLogging("create_expense", async () => {
         const result = await client.createExpense(input);
+        const hints = enrichResponse("expenses", "create", result);
         return {
             content: [mutateContent(formatRecord("Expense created", result))],
-            structuredContent: result,
+            structuredContent: { ...result, ...hints },
         };
     }));
     // -- update_expense --
@@ -119,9 +137,10 @@ export function registerExpenseTools(server, client) {
         outputSchema: deleteResultOutput,
     }, async ({ id }) => withToolLogging("delete_expense", async () => {
         await client.deleteExpense(id);
+        const hints = enrichResponse("expenses", "delete", { id });
         return {
             content: [mutateContent(`Expense ${id} deleted successfully. / Gasto ${id} eliminado correctamente.`)],
-            structuredContent: { success: true, id },
+            structuredContent: { success: true, id, ...hints },
         };
     }));
 }

package/dist/tools/expenses.js.map

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

package/dist/tools/intelligence.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Intelligence tools for the Frihet MCP server.
+ *
+ * These tools go beyond CRUD — they provide contextual business intelligence
+ * that helps AI agents understand the user's business at a glance.
+ *
+ * - get_business_context: Full business snapshot (call FIRST in any session)
+ * - get_monthly_summary: Monthly P&L and invoice stats
+ * - get_quarterly_taxes: Tax prep data for Modelo 303/130
+ * - duplicate_invoice: Clone an invoice for a new period
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IFrihetClient } from "../client-interface.js";
+export declare function registerIntelligenceTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=intelligence.d.ts.map

package/dist/tools/intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.d.ts","sourceRoot":"","sources":["../../src/tools/intelligence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAU5D,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA6JxF"}

package/dist/tools/intelligence.js

@@ -0,0 +1,127 @@
+/**
+ * Intelligence tools for the Frihet MCP server.
+ *
+ * These tools go beyond CRUD — they provide contextual business intelligence
+ * that helps AI agents understand the user's business at a glance.
+ *
+ * - get_business_context: Full business snapshot (call FIRST in any session)
+ * - get_monthly_summary: Monthly P&L and invoice stats
+ * - get_quarterly_taxes: Tax prep data for Modelo 303/130
+ * - duplicate_invoice: Clone an invoice for a new period
+ */
+import { z } from "zod/v4";
+import { withToolLogging, formatRecord, getContent, mutateContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, } from "./shared.js";
+export function registerIntelligenceTools(server, client) {
+    // -- get_business_context --
+    server.registerTool("get_business_context", {
+        title: "Get Business Context",
+        description: "Get complete business context — profile, defaults, plan limits, recent activity, top clients, " +
+            "and current month summary. Call this FIRST in any session to understand the user's business. " +
+            "Returns everything an AI agent needs to provide personalized help without multiple round-trips. " +
+            "/ Obtiene el contexto completo del negocio — perfil, limites del plan, actividad reciente, " +
+            "principales clientes y resumen del mes actual. Llama a esto PRIMERO en cualquier sesion.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {},
+    }, async () => withToolLogging("get_business_context", async () => {
+        const result = await client.getBusinessContext();
+        return {
+            content: [getContent(formatRecord("Business Context", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- get_monthly_summary --
+    server.registerTool("get_monthly_summary", {
+        title: "Get Monthly Summary",
+        description: "Get complete monthly financial summary — revenue, expenses, profit, tax liability, " +
+            "invoice stats, expense breakdown by category. Defaults to current month. " +
+            "Use this to answer questions about financial performance, cash flow, or monthly P&L. " +
+            "/ Resumen financiero mensual completo — ingresos, gastos, beneficio, impuestos, " +
+            "estadisticas de facturas, desglose de gastos por categoria. Por defecto el mes actual.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            month: z
+                .string()
+                .optional()
+                .describe("Month in YYYY-MM format (defaults to current month). Example: '2026-03' " +
+                "/ Mes en formato YYYY-MM (por defecto el mes actual)"),
+        },
+    }, async ({ month }) => withToolLogging("get_monthly_summary", async () => {
+        const result = await client.getMonthlySummary(month);
+        const label = month ? `Monthly Summary (${month})` : "Monthly Summary (current month)";
+        return {
+            content: [getContent(formatRecord(label, result))],
+            structuredContent: result,
+        };
+    }));
+    // -- get_quarterly_taxes --
+    server.registerTool("get_quarterly_taxes", {
+        title: "Get Quarterly Taxes",
+        description: "Get quarterly tax preparation data — Modelo 303 (IVA/IGIC), Modelo 130 (IRPF income tax advance), " +
+            "revenue/expense totals, tax collected vs deductible. Defaults to current quarter. " +
+            "Essential for filing quarterly tax returns with AEAT or ATC (Canary Islands). " +
+            "/ Datos de preparacion de impuestos trimestrales — Modelo 303, Modelo 130, " +
+            "totales de ingresos/gastos, impuesto repercutido vs soportado. Por defecto trimestre actual.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            quarter: z
+                .string()
+                .optional()
+                .describe("Quarter in YYYY-Q# format (defaults to current quarter). Example: '2026-Q1' " +
+                "/ Trimestre en formato YYYY-Q# (por defecto trimestre actual)"),
+        },
+    }, async ({ quarter }) => withToolLogging("get_quarterly_taxes", async () => {
+        const result = await client.getQuarterlyTaxes(quarter);
+        const label = quarter ? `Quarterly Taxes (${quarter})` : "Quarterly Taxes (current quarter)";
+        return {
+            content: [getContent(formatRecord(label, result))],
+            structuredContent: result,
+        };
+    }));
+    // -- duplicate_invoice --
+    server.registerTool("duplicate_invoice", {
+        title: "Duplicate Invoice",
+        description: "Duplicate an existing invoice for a new period. Copies all line items, client data, tax rate, and notes. " +
+            "Strips the original ID, document number, status, and timestamps. " +
+            "The new invoice starts as 'draft' with today's date (or the provided date). " +
+            "Perfect for recurring invoices — duplicate last month's invoice and adjust if needed. " +
+            "/ Duplica una factura existente para un nuevo periodo. Copia conceptos, cliente, impuestos y notas. " +
+            "La nueva factura empieza como 'borrador' con fecha de hoy.",
+        annotations: CREATE_ANNOTATIONS,
+        inputSchema: {
+            id: z.string().describe("ID of the invoice to duplicate / ID de la factura a duplicar"),
+            newIssueDate: z
+                .string()
+                .optional()
+                .describe("Issue date for the new invoice (YYYY-MM-DD), defaults to today / Fecha de emision de la nueva factura"),
+            newDueDate: z
+                .string()
+                .optional()
+                .describe("Due date for the new invoice (YYYY-MM-DD) / Fecha de vencimiento de la nueva factura"),
+        },
+    }, async ({ id, newIssueDate, newDueDate }) => withToolLogging("duplicate_invoice", async () => {
+        // 1. Fetch the original invoice
+        const original = await client.getInvoice(id);
+        // 2. Strip fields that shouldn't be copied
+        const { id: _id, documentNumber: _docNum, status: _status, createdAt: _createdAt, updatedAt: _updatedAt, total: _total, ...copyData } = original;
+        // 3. Set new values
+        const today = new Date().toISOString().split("T")[0];
+        const invoiceData = {
+            ...copyData,
+            status: "draft",
+            issueDate: newIssueDate || today,
+        };
+        if (newDueDate) {
+            invoiceData.dueDate = newDueDate;
+        }
+        // 4. Create the duplicate
+        const result = await client.createInvoice(invoiceData);
+        return {
+            content: [
+                mutateContent(formatRecord("Invoice duplicated", result) +
+                    `\n\nDuplicated from invoice ${id}. Status set to 'draft'. / Duplicada de la factura ${id}. Estado: borrador.`),
+            ],
+            structuredContent: result,
+        };
+    }));
+}
+//# sourceMappingURL=intelligence.js.map

package/dist/tools/intelligence.js.map

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

package/dist/tools/invoices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAS5D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA4OnF"}
+{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAS5D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAqVnF"}

package/dist/tools/invoices.js

@@ -2,7 +2,7 @@
  * Invoice tools for the Frihet MCP server.
  */
 import { z } from "zod/v4";
-import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, getContent, mutateContent, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, UPDATE_ANNOTATIONS, DELETE_ANNOTATIONS, paginatedOutput, deleteResultOutput, invoiceItemOutput } from "./shared.js";
+import { withToolLogging, formatPaginatedResponse, formatRecord, listContent, getContent, mutateContent, enrichResponse, READ_ONLY_ANNOTATIONS, CREATE_ANNOTATIONS, UPDATE_ANNOTATIONS, DELETE_ANNOTATIONS, paginatedOutput, deleteResultOutput, invoiceItemOutput, actionResultOutput, pdfResultOutput } from "./shared.js";
 const invoiceItemSchema = z.object({
     description: z.string().describe("Description of the line item / Descripcion del concepto"),
     quantity: z.number().describe("Quantity / Cantidad"),
@@ -24,6 +24,14 @@ export function registerInvoiceTools(server, client) {
                 .enum(["draft", "sent", "paid", "overdue", "cancelled"])
                 .optional()
                 .describe("Filter by invoice status / Filtrar por estado"),
+            clientId: z
+                .string()
+                .optional()
+                .describe("Filter by client ID / Filtrar por ID de cliente"),
+            seriesId: z
+                .string()
+                .optional()
+                .describe("Filter by invoice series ID / Filtrar por ID de serie"),
             from: z
                 .string()
                 .optional()
@@ -32,6 +40,10 @@ export function registerInvoiceTools(server, client) {
                 .string()
                 .optional()
                 .describe("End date filter in ISO 8601 (YYYY-MM-DD) / Fecha fin"),
+            fields: z
+                .string()
+                .optional()
+                .describe("Comma-separated field names to return (e.g. 'id,clientName,total') / Campos a devolver"),
             limit: z
                 .number()
                 .int()
@@ -45,13 +57,18 @@ export function registerInvoiceTools(server, client) {
                 .min(0)
                 .optional()
                 .describe("Number of results to skip / Resultados a saltar"),
+            after: z
+                .string()
+                .optional()
+                .describe("Cursor for cursor-based pagination (document ID) / Cursor para paginacion basada en cursor"),
         },
         outputSchema: paginatedOutput(invoiceItemOutput),
-    }, async ({ status, from, to, limit, offset }) => withToolLogging("list_invoices", async () => {
-        const result = await client.listInvoices({ limit, offset, status, from, to });
+    }, async ({ status, from, to, limit, offset, clientId, seriesId, fields, after }) => withToolLogging("list_invoices", async () => {
+        const result = await client.listInvoices({ limit, offset, after, fields, status, from, to, clientId, seriesId });
+        const hints = enrichResponse("invoices", "list", result.data);
         return {
             content: [listContent(formatPaginatedResponse("invoices", result))],
-            structuredContent: result,
+            structuredContent: { ...result, ...hints },
         };
     }));
     // -- get_invoice --
@@ -112,9 +129,10 @@ export function registerInvoiceTools(server, client) {
         outputSchema: invoiceItemOutput,
     }, async (input) => withToolLogging("create_invoice", async () => {
         const result = await client.createInvoice(input);
+        const hints = enrichResponse("invoices", "create", result);
         return {
             content: [mutateContent(formatRecord("Invoice created", result))],
-            structuredContent: result,
+            structuredContent: { ...result, ...hints },
         };
     }));
     // -- update_invoice --
@@ -144,9 +162,10 @@ export function registerInvoiceTools(server, client) {
         outputSchema: invoiceItemOutput,
     }, async ({ id, ...data }) => withToolLogging("update_invoice", async () => {
         const result = await client.updateInvoice(id, data);
+        const hints = enrichResponse("invoices", "update", result);
         return {
             content: [mutateContent(formatRecord("Invoice updated", result))],
-            structuredContent: result,
+            structuredContent: { ...result, ...hints },
         };
     }));
     // -- delete_invoice --
@@ -161,9 +180,10 @@ export function registerInvoiceTools(server, client) {
         outputSchema: deleteResultOutput,
     }, async ({ id }) => withToolLogging("delete_invoice", async () => {
         await client.deleteInvoice(id);
+        const hints = enrichResponse("invoices", "delete", { id });
         return {
             content: [mutateContent(`Invoice ${id} deleted successfully. / Factura ${id} eliminada correctamente.`)],
-            structuredContent: { success: true, id },
+            structuredContent: { success: true, id, ...hints },
         };
     }));
     // -- search_invoices --
@@ -189,17 +209,81 @@ export function registerInvoiceTools(server, client) {
                 .string()
                 .optional()
                 .describe("End date filter (YYYY-MM-DD) / Fecha fin"),
+            fields: z
+                .string()
+                .optional()
+                .describe("Comma-separated field names to return / Campos a devolver"),
             limit: z.number().int().min(1).max(100).optional().describe("Max results (1-100) / Resultados maximos"),
             offset: z.number().int().min(0).optional().describe("Offset / Desplazamiento"),
+            after: z
+                .string()
+                .optional()
+                .describe("Cursor for cursor-based pagination (document ID) / Cursor para paginacion"),
         },
         outputSchema: paginatedOutput(invoiceItemOutput),
-    }, async ({ query, status, from, to, limit, offset }) => withToolLogging("search_invoices", async () => {
+    }, async ({ query, status, from, to, limit, offset, fields, after }) => withToolLogging("search_invoices", async () => {
         const result = query
-            ? await client.searchInvoices(query, { limit, offset, status, from, to })
-            : await client.listInvoices({ limit, offset, status, from, to });
+            ? await client.searchInvoices(query, { limit, offset, after, fields, status, from, to })
+            : await client.listInvoices({ limit, offset, after, fields, status, from, to });
         const label = query ? `invoices matching "${query}"` : "invoices";
+        const hints = enrichResponse("invoices", "list", result.data);
         return {
             content: [listContent(formatPaginatedResponse(label, result))],
+            structuredContent: { ...result, ...hints },
+        };
+    }));
+    // -- send_invoice --
+    server.registerTool("send_invoice", {
+        title: "Send Invoice",
+        description: "Send an invoice to the client via email. Optionally override the recipient email address. " +
+            "The invoice must exist and should not already be cancelled. " +
+            "/ Envia una factura al cliente por email. Opcionalmente se puede cambiar el email destinatario.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            id: z.string().describe("Invoice ID / ID de la factura"),
+            to: z.string().optional().describe("Override recipient email / Email destinatario alternativo"),
+        },
+        outputSchema: actionResultOutput,
+    }, async ({ id, to }) => withToolLogging("send_invoice", async () => {
+        const result = await client.sendInvoice(id, to);
+        return {
+            content: [mutateContent(formatRecord("Invoice sent", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- mark_invoice_paid --
+    server.registerTool("mark_invoice_paid", {
+        title: "Mark Invoice Paid",
+        description: "Mark an invoice as paid. Optionally specify the payment date. " +
+            "Defaults to today if no date is provided. " +
+            "/ Marca una factura como pagada. Opcionalmente especifica la fecha de pago.",
+        annotations: UPDATE_ANNOTATIONS,
+        inputSchema: {
+            id: z.string().describe("Invoice ID / ID de la factura"),
+            paidDate: z.string().optional().describe("Payment date (YYYY-MM-DD), defaults to today / Fecha de pago"),
+        },
+        outputSchema: actionResultOutput,
+    }, async ({ id, paidDate }) => withToolLogging("mark_invoice_paid", async () => {
+        const result = await client.markInvoicePaid(id, paidDate);
+        return {
+            content: [mutateContent(formatRecord("Invoice marked as paid", result))],
+            structuredContent: result,
+        };
+    }));
+    // -- get_invoice_pdf --
+    server.registerTool("get_invoice_pdf", {
+        title: "Get Invoice PDF",
+        description: "Get the PDF for an invoice. Returns a URL to download the PDF or binary info. " +
+            "/ Obtiene el PDF de una factura. Devuelve una URL de descarga o informacion del binario.",
+        annotations: READ_ONLY_ANNOTATIONS,
+        inputSchema: {
+            id: z.string().describe("Invoice ID / ID de la factura"),
+        },
+        outputSchema: pdfResultOutput,
+    }, async ({ id }) => withToolLogging("get_invoice_pdf", async () => {
+        const result = await client.getInvoicePdf(id);
+        return {
+            content: [getContent(formatRecord("Invoice PDF", result))],
             structuredContent: result,
         };
     }));