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

package/README.md

@@ -1,5 +1,8 @@
 # MCP Colppy
 
+
+> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install <pkg>@alpha`.
+
 MCP server for **Colppy** — Argentine cloud accounting platform with integrated AFIP electronic invoicing.
 
 ## Quick Start
@@ -25,18 +28,32 @@ npx tsx packages/argentina/colppy/src/index.ts --http
 | `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport |
 | `MCP_PORT` | No | HTTP port (default: 3000) |
 
-## Tools
+## Tools (22)
 
-| Tool | Description |
-|------|-------------|
+| Tool | Purpose |
+|---|---|
 | `list_customers` | List customers |
 | `create_customer` | Create a customer |
 | `list_products` | List products and services |
-| `create_invoice` | Create an invoice (integrates with AFIP) |
+| `create_invoice` | Create an invoice (integrates with AFIP for electronic invoicing) |
 | `list_invoices` | List invoices |
 | `get_balance` | Get account balance summary |
 | `list_accounts` | List chart of accounts (plan de cuentas) |
 | `create_payment` | Record a payment against an invoice |
+| `update_customer` | Update an existing customer's data |
+| `delete_customer` | Delete a customer |
+| `get_customer_balance` | Get the current account balance (cuenta corriente) for a customer |
+| `list_suppliers` | List suppliers (proveedores) |
+| `create_supplier` | Create a supplier (proveedor) |
+| `cancel_invoice` | Cancel/void an invoice (anular comprobante) |
+| `get_invoice_pdf` | Get the PDF representation of an invoice (returns URL or base64) |
+| `create_receipt` | Create a receipt (recibo) — record cash/transfer received against one or more invoices |
+| `list_receipts` | List receipts (recibos) |
+| `get_stock` | Get current stock for a product across warehouses |
+| `list_warehouses` | List warehouses (depósitos) |
+| `list_companies` | List companies (empresas) accessible to the current API user |
+| `sales_report` | Sales report by date range |
+| `expenses_report` | Expenses/purchases report by date range |
 
 ## Auth
 

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.2" }, { 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.2" }, { 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,13 +1,15 @@
 {
   "name": "@codespar/mcp-colppy",
-  "version": "0.1.0",
-  "description": "MCP server for Colppy — Argentine cloud accounting + AFIP invoicing",
+  "version": "0.2.0-alpha.2",
+  "description": "MCP server for Colppy \u2014 Argentine cloud accounting + AFIP invoicing",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "mcp-colppy": "dist/index.js"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js"
@@ -20,6 +22,13 @@
     "typescript": "^5.8.0"
   },
   "license": "MIT",
-  "keywords": ["colppy", "accounting", "argentina", "afip", "invoicing", "mcp"],
+  "keywords": [
+    "colppy",
+    "accounting",
+    "argentina",
+    "afip",
+    "invoicing",
+    "mcp"
+  ],
   "mcpName": "io.github.codespar/mcp-colppy"
 }