@codespar/mcp-colppy 0.1.0 → 0.2.0-alpha.1

package/dist/index.d.ts

@@ -3,14 +3,16 @@
  * MCP Server for Colppy — Argentine cloud accounting + AFIP invoicing.
  *
  * Tools:
- * - list_customers: List customers
- * - create_customer: Create a customer
- * - list_products: List products/services
- * - create_invoice: Create an invoice (integrates with AFIP)
- * - list_invoices: List invoices
- * - get_balance: Get account balance
- * - list_accounts: List chart of accounts
- * - create_payment: Record a payment
+ * - list_customers / create_customer / update_customer / delete_customer / get_customer_balance
+ * - list_suppliers / create_supplier
+ * - list_products / update_product / get_stock
+ * - list_warehouses
+ * - create_invoice / list_invoices / cancel_invoice / get_invoice_pdf
+ * - create_receipt / list_receipts
+ * - create_payment
+ * - get_balance / list_accounts
+ * - list_companies
+ * - sales_report / expenses_report
  *
  * Environment:
  *   COLPPY_API_KEY    — API key

package/dist/index.js

@@ -3,14 +3,16 @@
  * MCP Server for Colppy — Argentine cloud accounting + AFIP invoicing.
  *
  * Tools:
- * - list_customers: List customers
- * - create_customer: Create a customer
- * - list_products: List products/services
- * - create_invoice: Create an invoice (integrates with AFIP)
- * - list_invoices: List invoices
- * - get_balance: Get account balance
- * - list_accounts: List chart of accounts
- * - create_payment: Record a payment
+ * - list_customers / create_customer / update_customer / delete_customer / get_customer_balance
+ * - list_suppliers / create_supplier
+ * - list_products / update_product / get_stock
+ * - list_warehouses
+ * - create_invoice / list_invoices / cancel_invoice / get_invoice_pdf
+ * - create_receipt / list_receipts
+ * - create_payment
+ * - get_balance / list_accounts
+ * - list_companies
+ * - sales_report / expenses_report
  *
  * Environment:
  *   COLPPY_API_KEY    — API key
@@ -45,7 +47,7 @@ async function colppyRequest(service, operation, params) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-colppy", version: "0.1.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-colppy", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -168,6 +170,184 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["invoice_id", "amount", "payment_method"],
             },
         },
+        {
+            name: "update_customer",
+            description: "Update an existing customer's data",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    customer_id: { type: "string", description: "Customer ID" },
+                    name: { type: "string", description: "Customer name or business name" },
+                    email: { type: "string", description: "Email address" },
+                    phone: { type: "string", description: "Phone number" },
+                    address: { type: "string", description: "Street address" },
+                    tax_category: { type: "string", description: "Tax category (RI, Monotributo, Exento, ConsumidorFinal)" },
+                },
+                required: ["customer_id"],
+            },
+        },
+        {
+            name: "delete_customer",
+            description: "Delete a customer",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    customer_id: { type: "string", description: "Customer ID" },
+                },
+                required: ["customer_id"],
+            },
+        },
+        {
+            name: "get_customer_balance",
+            description: "Get the current account balance (cuenta corriente) for a customer",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    customer_id: { type: "string", description: "Customer ID" },
+                    date: { type: "string", description: "As-of date (YYYY-MM-DD)" },
+                },
+                required: ["customer_id"],
+            },
+        },
+        {
+            name: "list_suppliers",
+            description: "List suppliers (proveedores)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filter: { type: "string", description: "Search filter (name or tax ID)" },
+                    offset: { type: "number", description: "Pagination offset" },
+                    limit: { type: "number", description: "Results limit" },
+                },
+            },
+        },
+        {
+            name: "create_supplier",
+            description: "Create a supplier (proveedor)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: { type: "string", description: "Supplier name or business name" },
+                    tax_id: { type: "string", description: "CUIT number" },
+                    tax_category: { type: "string", description: "Tax category (RI, Monotributo, Exento)" },
+                    email: { type: "string", description: "Email address" },
+                    phone: { type: "string", description: "Phone number" },
+                    address: { type: "string", description: "Street address" },
+                },
+                required: ["name", "tax_id"],
+            },
+        },
+        {
+            name: "cancel_invoice",
+            description: "Cancel/void an invoice (anular comprobante)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    invoice_id: { type: "string", description: "Invoice ID" },
+                    reason: { type: "string", description: "Cancellation reason" },
+                },
+                required: ["invoice_id"],
+            },
+        },
+        {
+            name: "get_invoice_pdf",
+            description: "Get the PDF representation of an invoice (returns URL or base64)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    invoice_id: { type: "string", description: "Invoice ID" },
+                },
+                required: ["invoice_id"],
+            },
+        },
+        {
+            name: "create_receipt",
+            description: "Create a receipt (recibo) — record cash/transfer received against one or more invoices",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    customer_id: { type: "string", description: "Customer ID" },
+                    date: { type: "string", description: "Receipt date (YYYY-MM-DD)" },
+                    amount: { type: "number", description: "Total receipt amount" },
+                    payment_method: { type: "string", description: "Payment method (cash, bank_transfer, check, card)" },
+                    invoice_ids: {
+                        type: "array",
+                        description: "Invoice IDs being paid",
+                        items: { type: "string" },
+                    },
+                    reference: { type: "string", description: "Receipt reference" },
+                },
+                required: ["customer_id", "amount", "payment_method"],
+            },
+        },
+        {
+            name: "list_receipts",
+            description: "List receipts (recibos)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    date_from: { type: "string", description: "Start date (YYYY-MM-DD)" },
+                    date_to: { type: "string", description: "End date (YYYY-MM-DD)" },
+                    customer_id: { type: "string", description: "Filter by customer" },
+                    offset: { type: "number", description: "Pagination offset" },
+                    limit: { type: "number", description: "Results limit" },
+                },
+            },
+        },
+        {
+            name: "get_stock",
+            description: "Get current stock for a product across warehouses",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    product_id: { type: "string", description: "Product ID" },
+                    warehouse_id: { type: "string", description: "Optional warehouse (depósito) ID filter" },
+                },
+                required: ["product_id"],
+            },
+        },
+        {
+            name: "list_warehouses",
+            description: "List warehouses (depósitos)",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
+        {
+            name: "list_companies",
+            description: "List companies (empresas) accessible to the current API user",
+            inputSchema: {
+                type: "object",
+                properties: {},
+            },
+        },
+        {
+            name: "sales_report",
+            description: "Sales report by date range",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    date_from: { type: "string", description: "Start date (YYYY-MM-DD)" },
+                    date_to: { type: "string", description: "End date (YYYY-MM-DD)" },
+                    customer_id: { type: "string", description: "Optional customer filter" },
+                },
+                required: ["date_from", "date_to"],
+            },
+        },
+        {
+            name: "expenses_report",
+            description: "Expenses/purchases report by date range",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    date_from: { type: "string", description: "Start date (YYYY-MM-DD)" },
+                    date_to: { type: "string", description: "End date (YYYY-MM-DD)" },
+                    supplier_id: { type: "string", description: "Optional supplier filter" },
+                },
+                required: ["date_from", "date_to"],
+            },
+        },
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -248,6 +428,104 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                                 fecha: args?.date,
                                 referencia: args?.reference,
                             }), null, 2) }] };
+            case "update_customer":
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("cliente", "modificar", {
+                                idCliente: args?.customer_id,
+                                razonSocial: args?.name,
+                                email: args?.email,
+                                telefono: args?.phone,
+                                direccion: args?.address,
+                                categoriaFiscal: args?.tax_category,
+                            }), null, 2) }] };
+            case "delete_customer":
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("cliente", "eliminar", {
+                                idCliente: args?.customer_id,
+                            }), null, 2) }] };
+            case "get_customer_balance": {
+                const params = { idCliente: args?.customer_id };
+                if (args?.date)
+                    params.fecha = args.date;
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("cliente", "saldo", params), null, 2) }] };
+            }
+            case "list_suppliers": {
+                const params = {};
+                if (args?.filter)
+                    params.filter = args.filter;
+                if (args?.offset)
+                    params.offset = args.offset;
+                if (args?.limit)
+                    params.limit = args.limit;
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("proveedor", "listar", params), null, 2) }] };
+            }
+            case "create_supplier":
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("proveedor", "crear", {
+                                razonSocial: args?.name,
+                                cuit: args?.tax_id,
+                                categoriaFiscal: args?.tax_category,
+                                email: args?.email,
+                                telefono: args?.phone,
+                                direccion: args?.address,
+                            }), null, 2) }] };
+            case "cancel_invoice":
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("factura", "anular", {
+                                idFactura: args?.invoice_id,
+                                motivo: args?.reason,
+                            }), null, 2) }] };
+            case "get_invoice_pdf":
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("factura", "obtenerPDF", {
+                                idFactura: args?.invoice_id,
+                            }), null, 2) }] };
+            case "create_receipt":
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("recibo", "crear", {
+                                idCliente: args?.customer_id,
+                                fecha: args?.date,
+                                monto: args?.amount,
+                                metodoPago: args?.payment_method,
+                                idsFactura: args?.invoice_ids,
+                                referencia: args?.reference,
+                            }), null, 2) }] };
+            case "list_receipts": {
+                const params = {};
+                if (args?.date_from)
+                    params.fechaDesde = args.date_from;
+                if (args?.date_to)
+                    params.fechaHasta = args.date_to;
+                if (args?.customer_id)
+                    params.idCliente = args.customer_id;
+                if (args?.offset)
+                    params.offset = args.offset;
+                if (args?.limit)
+                    params.limit = args.limit;
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("recibo", "listar", params), null, 2) }] };
+            }
+            case "get_stock": {
+                const params = { idProducto: args?.product_id };
+                if (args?.warehouse_id)
+                    params.idDeposito = args.warehouse_id;
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("inventario", "stock", params), null, 2) }] };
+            }
+            case "list_warehouses":
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("deposito", "listar", {}), null, 2) }] };
+            case "list_companies":
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("empresa", "listar", {}), null, 2) }] };
+            case "sales_report": {
+                const params = {
+                    fechaDesde: args?.date_from,
+                    fechaHasta: args?.date_to,
+                };
+                if (args?.customer_id)
+                    params.idCliente = args.customer_id;
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("reporte", "ventas", params), null, 2) }] };
+            }
+            case "expenses_report": {
+                const params = {
+                    fechaDesde: args?.date_from,
+                    fechaHasta: args?.date_to,
+                };
+                if (args?.supplier_id)
+                    params.idProveedor = args.supplier_id;
+                return { content: [{ type: "text", text: JSON.stringify(await colppyRequest("reporte", "compras", params), null, 2) }] };
+            }
             default:
                 return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
         }
@@ -274,7 +552,7 @@ async function main() {
                 const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
                 t.onclose = () => { if (t.sessionId)
                     transports.delete(t.sessionId); };
-                const s = new Server({ name: "mcp-colppy", version: "0.1.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-colppy", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
                 server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
                 server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
                 await s.connect(t);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codespar/mcp-colppy",
-  "version": "0.1.0",
+  "version": "0.2.0-alpha.1",
   "description": "MCP server for Colppy — Argentine cloud accounting + AFIP invoicing",
   "type": "module",
   "main": "dist/index.js",